MCP Setup

Connect Claude Code, Cursor, Codex, Lovable, Replit, and other MCP-compatible tools to Supaspec. No local server needed — Supaspec runs a remote MCP server.

Prerequisites

  • •A Supaspec account (see Getting Started)
  • •An MCP-compatible AI tool
  • •An API key (from Settings, prefixed with ss_) — or use OAuth where supported

Connect Your Tool

Pick your tool and follow the instructions:

claude mcp add --transport http supaspec https://supaspec.dev/api/mcp

OAuth (No API Key)

Tools that support MCP OAuth (Cursor, Codex, Lovable, Replit) can connect without an API key. The tool opens a browser window for you to authorize access. For tools using JSON config, just omit the headers:

OAuth configuration
{
  "mcpServers": {
    "supaspec": {
      "url": "https://supaspec.dev/api/mcp"
    }
  }
}

Agent Self-Identification

When agents write to Supaspec, they provide an agent_name parameter using snake_case identifiers:

  • claude_code→Claude Code
  • cursor→Cursor
  • codex→Codex
  • windsurf→Windsurf
  • copilot→Copilot

Custom names are also supported. No additional configuration needed — agents include this automatically.

Verification

Test your connection by prompting your agent:

"List my supaspec projects."

The agent should call the project tool and return your project list.

Troubleshooting

  • 401 Unauthorized

    Check that your API key is correct and includes the ss_ prefix.

  • Connection refused

    Ensure you're using https:// (not http://).

  • Agent not showing up

    Agents are auto-registered on their first write operation. Read-only operations don't create agent records.

← Getting StartedMCP Tools Reference →