> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firmable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Note>
  Replace `<MCP_URL>` with the MCP URL and `<CLIENT_ID>` with the Client ID — see
  [**URL & Client ID**](/mcp/credentials). Use the callback port `53612` where applicable.
</Note>

## Claude Code

Add with the CLI:

```bash theme={null}
claude mcp add --transport http \
  --client-id <CLIENT_ID> \
  --callback-port 53612 \
  firmable <MCP_URL>
```

Or add with JSON config:

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

## Codex

Add with the CLI:

```bash theme={null}
codex mcp add firmable \
  --url <MCP_URL> \
  --oauth-client-id <CLIENT_ID>
codex mcp login firmable
```

## Cursor

Add to `~/.cursor/mcp.json`:

```json theme={null}
{
  "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**):

```json theme={null}
{
  "servers": {
    "firmable": {
      "type": "http",
      "url": "<MCP_URL>",
      "oauth": {
        "clientId": "<CLIENT_ID>"
      }
    }
  }
}
```

Or add it from the command line:

```bash theme={null}
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`:

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