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

# IDE / 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

Install from the **Codex desktop app** — Firmable is a verified plugin, so no MCP URL or Client ID is required, just sign in:

<Steps>
  <Step title="Find Firmable">
    In the Codex desktop app, open **Plugins** from the sidebar, search for `firmable`, then click
    **Firmable** under **Public** to open it.

    <Frame>
      <img src="https://mintcdn.com/firmable/9omkwEm5TDPngOEA/images/mcp/codex-plugins.png?fit=max&auto=format&n=9omkwEm5TDPngOEA&q=85&s=acb609d762148083b1df9824680468fd" alt="Codex Plugins page with 'firmable' searched, showing the Firmable plugin under Public" width="2690" height="1386" data-path="images/mcp/codex-plugins.png" />
    </Frame>
  </Step>

  <Step title="Install the plugin">
    On the Firmable page, click **Install plugin**.

    <Frame>
      <img src="https://mintcdn.com/firmable/9omkwEm5TDPngOEA/images/mcp/codex-install.png?fit=max&auto=format&n=9omkwEm5TDPngOEA&q=85&s=5dc3f1f77ae818ca3d60275fe99ca694" alt="Firmable plugin page in Codex with the Install plugin button" width="2276" height="1128" data-path="images/mcp/codex-install.png" />
    </Frame>
  </Step>

  <Step title="Connect Firmable">
    In the **Connect Firmable** dialog, review the data-sharing notice and click **Continue to Firmable**.

    <Frame>
      <img src="https://mintcdn.com/firmable/9omkwEm5TDPngOEA/images/mcp/codex-connect.png?fit=max&auto=format&n=9omkwEm5TDPngOEA&q=85&s=b8f1eb316978d4fdc08274499da580c4" alt="Connect Firmable dialog in Codex with the Continue to Firmable button and data-sharing notice" width="1122" height="1304" data-path="images/mcp/codex-connect.png" />
    </Frame>
  </Step>

  <Step title="Sign in to finish">
    Follow the remaining prompts to sign in with Firmable and authorize access. Once connected,
    Firmable is available to use in Codex.
  </Step>
</Steps>

Or add it 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>\"}"
      ]
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.