mcp

GitScrum MCP Server turns your AI assistant into a fully capable Project Manager within your GitScrum workspace. It exposes a suite of MCP-compatible tools that let Claude, Cursor, Windsurf, Copilot, and other MCP clients perform project management tasks directly inside your environment. Core and planning tools cover tasks, sprints, user stories, epics, labels, discussions, notes, time tracking, and more, enabling assistants to read and modify tasks, plan timelines, track progress, and generate standups. When used with an MCP client, you can issue natural-language requests like creating a sprint with top backlog items, listing tasks due today, or generating a standup digest, and the server will translate them into the appropriate GitScrum actions through the integrated tools and APIs.

Prerequisites:

• Node.js 18+ installed on your machine
• npm or yarn available in your environment
• Internet access to fetch the MCP server package

Install and run locally (npm):

1. Install the MCP server (Self-hosted via npx): npx -y @gitscrum-studio/mcp-server

2. The server runs via stdio transport. Follow the quick start to configure your MCP client (Claude Desktop, VS Code, Cursor, etc.).

Configure your client (example):

• Claude Desktop: Add to config: { "mcpServers": { "gitscrum": { "command": "npx", "args": ["-y", "@gitscrum-studio/mcp-server"] } } }

• VS Code / Cursor: Add to .vscode/mcp.json or your MCP settings: { "servers": { "gitscrum": { "command": "npx", "args": ["-y", "@gitscrum-studio/mcp-server"] } } }

Authenticate with the server using the OAuth 2.0 Device Authorization flow described in the docs. Your AI client will prompt you to authorize in a browser; credentials are never shared with the MCP server.

Tips and guidance:

• The hosted SSE option is available for zero-install use from https://mcp.gitscrum.com/sse, ideal for Claude Desktop and other SSE clients.
• For local use, ensure you have Node.js 18+ installed and run the provided npx command to start the server.
• When configuring clients, you only need to provide the server under mcpServers with command and args, as shown in the quick start examples.
• The MCP server integrates with GitScrum’s APIs to provide tasks, sprints, time tracking, discussions, wiki, notes, client CRM, invoicing, and more; you can invoke these capabilities through the MCP tools. If you run into authorization issues, ensure the OAuth device flow completes in the browser and that your client is configured to point to the correct server endpoint.