Quickstart

About five minutes. There is no API key to fetch first. You sign in through the browser.

1. Check the server is reachable

   This call has no token, so a healthy server answers 401, that is the result you want. It proves you can reach the endpoint and that it is speaking OAuth:

   bashCopy

   curl -i -sS -X POST https://v4-api.orangescrum.com/mcp/partner \
     -H 'Content-Type: application/json' \
     -d '{"jsonrpc":"2.0","method":"ping","id":1}'
   

   Look for WWW-Authenticate: Bearer realm="MCP" in the response headers. No response at all means a network or proxy problem, fix that here rather than in a client config.

2. Add the server to your client

   Every client needs the same one thing: the URL https://v4-api.orangescrum.com/mcp/partner. Claude.ai and ChatGPT take it in their connector UI with no file to edit. For Claude Code:

   bashCopy

   claude mcp add --transport http orangescrum https://v4-api.orangescrum.com/mcp/partner
   

   See Client setup for Cursor, VS Code, Codex CLI and Claude Desktop.

3. Sign in and pick a workspace

   The client opens a browser window the first time it connects. Sign in with your Orangescrum account or Google, then choose the workspace this assistant should work in.

   The grant is bound to that one workspace, connect a second time if you need a second one.

4. Approve the scopes

   The consent screen lists what the client is asking for, grouped by area. Approve only what you want it to do.

   Starting read-only is the sensible default: mcp:use plus the .read scopes for the areas you care about. You can re-authorize with write access once you trust it.

5. Confirm the tools appeared

   Ask the assistant what Orangescrum tools it has. It should describe tools across projects, tasks, sprints, test management and more. If it says it has none, jump to Troubleshooting.

6. Try a real request

   Start with a read so you can see the shape of the data before anything writes:

   List my Orangescrum projects and tell me which ones have tasks due this week.

   Then try a write once you are comfortable, and have granted a write scope:

   Create a task in Website Redesign called "Audit meta descriptions", assign it to me, and set the due date to next Friday.

#Useful first prompts

#Where next