MCP Setup

What is MCP?

The Model Context Protocol (MCP) lets AI coding tools like Claude Code and Cursor access your Scope project context — entities, tickets, patterns, and codebase knowledge. AI tools use MCP to start tickets, get context, and complete work autonomously.

1. Create an API key

1. Go to Settings in your Scope account
2. Navigate to the API Keys tab
3. Click Create API Key and give it a name
4. Copy the key (starts with scope_sk_) — you won't see it again

2. Install the MCP server

Install the Scope MCP server globally:

npm install -g scope-mcp

3. Configure your AI tool

Claude Code

Add to your Claude Code MCP configuration (usually ~/.claude/mcp.jsonor project-level .mcp.json):

{
  "mcpServers": {
    "scope": {
      "command": "scope-mcp",
      "env": {
        "SCOPE_API_KEY": "scope_sk_your_key_here"
      }
    }
  }
}

Cursor

In Cursor settings, add the MCP server with the same configuration. The scope-mcp binary serves tools over stdio.

4. Test the connection

Once configured, ask your AI tool to list Scope projects:

Use scope to list my projects

If configured correctly, the AI tool will call list with type: "projects"and return your project list.

Available tools

The MCP server exposes 12 tools. See the Tool Reference for the complete list with parameters and examples.