Connecting Your AI Assistant

Every client connects to the same hosted endpoint and signs in with your existing ScopeStack credentials:

https://api.scopestack.io/mcp 

You don’t create API keys or paste tokens. The first time a client connects, it opens a browser window where you log in to ScopeStack and approve access. After that, the client reconnects on its own.

How Sign-In Works

ScopeStack uses standard OAuth. When your client connects to the URL above, it discovers ScopeStack’s authorization server, opens the login page in your browser, and receives a token tied to your user. The token carries read and write access, so the assistant inherits exactly your role’s permissions — nothing more.

Claude Code (CLI)

Run:

claude mcp add --transport http scopestack https://api.scopestack.io/mcp

The first time you use a ScopeStack tool, a browser window opens for login. Confirm the server is registered with claude mcp list.

Claude (Desktop and Web)

1. Open Settings, then Connectors (Integrations on some plans).
2. Choose Add custom connector / Add remote MCP server.
3. Name it ScopeStack and enter the URL https://api.scopestack.io/mcp.
4. Save, click Connect, and log in to ScopeStack in the browser window that opens.

ChatGPT

1. In a workspace where custom connectors are enabled, open Settings, then Connectors.
2. Add a custom connector / MCP server.
3. Enter the URL https://api.scopestack.io/mcp and save.
4. Authenticate with ScopeStack when prompted.

Remote MCP connectors require a plan or workspace where custom connectors are available.

Cursor

1. Open Settings, then MCP (or edit ~/.cursor/mcp.json).
2. Add a server pointing at https://api.scopestack.io/mcp over HTTP transport.
3. Reload, then authenticate in the browser the first time Cursor calls a ScopeStack tool.

GitHub Copilot (VS Code)

1. Open the MCP server configuration (Command Palette, then MCP: Add Server, or edit the workspace mcp.json).
2. Add an HTTP server pointing at https://api.scopestack.io/mcp.
3. Start the server and sign in to ScopeStack in the browser.

Verifying the Connection

Ask the assistant to run list_phases or list_rate_tables — both are read-only and need no inputs. If they return data, you’re connected. You can also ask it to call tool_guidance, which returns the recommended workflow for building a project.

Troubleshooting

• No login window, or “unauthorized”: the token expired or was revoked. Reconnect the server in your client to trigger a fresh login.
• “Your role does not have permission”: your ScopeStack role doesn’t allow that action. Ask your admin to adjust your role. See How the MCP Works.
• Requests suddenly fail with a rate-limit message: there’s a cap on how many requests one login can make per minute. Wait the number of seconds indicated and try again.
• A tool isn’t found: make sure the client finished connecting to the server, then reconnect if needed.