Connecting to Kanban Studio MCP

Prerequisites

• Kanban Studio account with access to at least one board.
• MCP client with OAuth support.
• An AI tool with MCP support.

Most MCP clients open the OAuth login and consent flow automatically.

Codex

1. Run this command in your terminal:
2. Run /mcp in Codex and complete authentication.

codex mcp add --transport http kanbanstudio https://kanbanstudio.site/api/mcp

Claude Code

1. Run this command in your terminal:
2. Run /mcp in Claude Code and complete authentication.

claude mcp add --transport http kanbanstudio https://kanbanstudio.site/api/mcp

Cursor

1. Open Cursor Settings -> MCP -> Add new global MCP server.
2. Paste this config.
3. Save and restart Cursor.

{
  "mcpServers": {
    "kanbanstudio": {
      "url": "https://kanbanstudio.site/api/mcp"
    }
  }
}

Cursor on macOS can fail to load shell env vars reliably. If you see "needs authentication", use a direct Authorization header as shown above.

VS Code (GitHub Copilot)

1. Create .vscode/mcp.json in your workspace.
2. Open Command Palette and run MCP: List Servers.
3. Start the server and authenticate when prompted.

{
  "servers": {
    "kanbanstudio": {
      "type": "http",
      "url": "https://kanbanstudio.site/api/mcp"
    }
  }
}

Claude Desktop

1. Open Settings -> Connectors.
2. Click Add Connector and paste your MCP URL.
3. Complete authentication flow.

https://kanbanstudio.site/api/mcp

Windsurf

1. Open Windsurf Settings and search for MCP.
2. Open raw mcp_config.json.
3. Add config, save, restart, and authenticate.

{
  "mcpServers": {
    "kanbanstudio": {
      "serverUrl": "https://kanbanstudio.site/api/mcp"
    }
  }
}

Antigravity

Use a custom MCP server entry and point it to your Kanban Studio MCP URL.

Compatibility note (March 20, 2026): if OAuth fails in Antigravity, use the legacy API key fallback with an Authorization Bearer header. Legacy API key guide.

{
  "mcpServers": {
    "kanbanstudio": {
      "url": "https://kanbanstudio.site/api/mcp"
    }
  }
}

Other tools

If your tool supports remote MCP over HTTP, use this URL:

https://kanbanstudio.site/api/mcp

JSON configuration format

{
  "mcpServers": {
    "kanbanstudio": {
      "url": "https://kanbanstudio.site/api/mcp"
    }
  }
}

Troubleshooting

• UNAUTHORIZED: check key value, expiration, and revocation.
• FORBIDDEN: check missing scope or board/workspace role.
• RATE_LIMITED: retry after the Retry-After window.

FAQ