Remote MCP server

The remote MySpec MCP server is hosted for you. There is nothing to install.

https://mcp.myspec.dev/mcp

Paste the URL exactly as shown, including /mcp. Sign-in is tied to this address, so a different URL will not work.

Add MySpec to your client

When you connect, your browser opens a MySpec consent page. Sign in if you need to, then choose:

• Organization: the app can only see and change this organization’s projects.
• Access: read only, or tick Also make changes to let the app create, edit and delete projects, spec files and comments.

Select Allow access to finish.

claude mcp add --transport http myspec https://mcp.myspec.dev/mcp

Connect with an API token

Use an API token when the client cannot open a browser, for example on a server or in CI. Create a token, then send it as a bearer token on every request:

POST /mcp HTTP/1.1
Host: mcp.myspec.dev
Authorization: Bearer msp_pat_…
Content-Type: application/json
Accept: application/json, text/event-stream

For example, in a client configuration file:

{
  "mcpServers": {
    "myspec": {
      "type": "http",
      "url": "https://mcp.myspec.dev/mcp",
      "headers": { "Authorization": "Bearer msp_pat_…" }
    }
  }
}

Or with Claude Code:

claude mcp add --transport http myspec https://mcp.myspec.dev/mcp \
  --header "Authorization: Bearer msp_pat_…"

Limit the tools your agent sees

By default the server offers all its tools. To offer fewer, send the optional X-MCP-Tools header with a comma-separated list of tool names:

X-MCP-Tools: list_projects,get_project,list_spec_file,read_spec_file

• Unknown names are ignored. If none of the names are known, the agent gets no tools at all, never the full set.
• The list applies to both listing and calling tools.
• A header with more than 64 names, or longer than 4,096 bytes, is rejected with an HTTP 400 error.

How it differs from the local server

The remote server has no access to your file system, so a few tools behave differently:

• There is no download_spec_file. Use read_spec_file, which pages through a file 2,000 lines at a time.
• upload_attachment takes the file content as base64 (up to 10 MiB), not a local path.
• update_spec_file always requires expected_version, so a concurrent edit is reported as a conflict instead of being overwritten. Read the file first and pass the content_version you got back.
• list_spec_sessions returns at most 20 sessions per page.
• Brownfield sessions need the local server’s reverse command to read your code. See Local MCP server.

Disconnect an app

Open the avatar menu in MySpec and choose Connected apps. It lists every app you have connected, with its organization and access. Select Disconnect to remove one; it loses access within about a minute.

Leaving an organization, or being removed from it, also ends the connection. The app will ask you to connect again.

Troubleshooting