> ## 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**](https://docs.firmable.com/mcp/credentials.md). Use the callback port `53612` where applicable.

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

**1. Find Firmable**

In the Codex desktop app, open **Plugins** from the sidebar, search for `firmable`, then click
**Firmable** under **Public** to open it.

![Codex Plugins page with 'firmable' searched, showing the Firmable plugin under Public](https://mintcdn.com/firmable/9omkwEm5TDPngOEA/images/mcp/codex-plugins.png?fit=max\&auto=format\&n=9omkwEm5TDPngOEA\&q=85\&s=acb609d762148083b1df9824680468fd)

**2. Install the plugin**

On the Firmable page, click **Install plugin**.

![Firmable plugin page in Codex with the Install plugin button](https://mintcdn.com/firmable/9omkwEm5TDPngOEA/images/mcp/codex-install.png?fit=max\&auto=format\&n=9omkwEm5TDPngOEA\&q=85\&s=5dc3f1f77ae818ca3d60275fe99ca694)

**3. Connect Firmable**

In the **Connect Firmable** dialog, review the data-sharing notice and click **Continue to Firmable**.

![Connect Firmable dialog in Codex with the Continue to Firmable button and data-sharing notice](https://mintcdn.com/firmable/9omkwEm5TDPngOEA/images/mcp/codex-connect.png?fit=max\&auto=format\&n=9omkwEm5TDPngOEA\&q=85\&s=b8f1eb316978d4fdc08274499da580c4)

**4. 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.

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.