MCP · Setup

Developer tools

Connect Firmable MCP to Claude Code, Codex, Cursor, VS Code, and Windsurf.

Connect the Firmable MCP server to your code editor or terminal AI tools.

Replace <MCP_URL> with the MCP URL and <CLIENT_ID> with the Client ID — see URL & Client ID. Use the callback port 53612 where applicable.

Claude Code

Add with the CLI:

claude mcp add --transport http \
  --client-id <CLIENT_ID> \
  --callback-port 53612 \
  firmable <MCP_URL>

Or add with JSON config:

claude mcp add-json firmable \
  '{"type":"http","url":"<MCP_URL>","oauth":{"clientId":"<CLIENT_ID>","callbackPort":53612}}'

Codex

Add with the CLI:

codex mcp add firmable \
  --url <MCP_URL> \
  --oauth-client-id <CLIENT_ID>
codex mcp login firmable

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "firmable": {
      "url": "<MCP_URL>",
      "auth": {
        "CLIENT_ID": "<CLIENT_ID>"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your workspace (or your user config via MCP: Open User Configuration):

{
  "servers": {
    "firmable": {
      "type": "http",
      "url": "<MCP_URL>",
      "oauth": {
        "clientId": "<CLIENT_ID>"
      }
    }
  }
}

Or add it from the command line:

code --add-mcp '{"name":"firmable","type":"http","url":"<MCP_URL>","oauth":{"clientId":"<CLIENT_ID>"}}'

VS Code opens a browser to authorize on the first connection. You can also run MCP: Add Server from the Command Palette for a guided setup.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "firmable": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "<MCP_URL>",
        "53612",
        "--static-oauth-client-info",
        "{\"client_id\":\"<CLIENT_ID>\"}"
      ]
    }
  }
}

← Back to MCP overview