Installation

Three paths to connect Thorbit MCP servers to your client.

1Installer (Codex / Claude Desktop / Cursor)

The installer writes config and stores the key at ~/.config/thorbit/mcp-key. Targets: codex | claude-desktop | cursor | json

THORBIT_API_KEY='thbt_mcp_...' npx -y thorbit-mcp@latest install \
  --client codex \
  --base-url 'https://thorbit.ai'

2Claude Code (manual add-json)

Claude Code has no installer target. Add both servers manually with claude mcp add-json:

# KB server
claude mcp add-json thorbit-kb \
  '{"command":"npx","args":["-y","thorbit-kb-mcp@latest"],"env":{"THORBIT_API_KEY":"thbt_mcp_...","THORBIT_BASE_URL":"https://thorbit.ai"}}' \
  -s user

# Content server
claude mcp add-json thorbit-content \
  '{"command":"npx","args":["-y","thorbit-content-mcp@latest"],"env":{"THORBIT_API_KEY":"thbt_mcp_...","THORBIT_BASE_URL":"https://thorbit.ai"}}' \
  -s user

Verify with claude mcp list — look for Connected status next to both servers.

3Raw JSON (any mcpServers block)

Drop this into any mcpServers config block:

{
  "mcpServers": {
    "thorbit-kb": {
      "command": "npx",
      "args": ["-y", "thorbit-kb-mcp@latest"],
      "env": {
        "THORBIT_API_KEY": "thbt_mcp_...",
        "THORBIT_BASE_URL": "https://thorbit.ai"
      }
    },
    "thorbit-content": {
      "command": "npx",
      "args": ["-y", "thorbit-content-mcp@latest"],
      "env": {
        "THORBIT_API_KEY": "thbt_mcp_...",
        "THORBIT_BASE_URL": "https://thorbit.ai"
      }
    }
  }
}

Restart the client after install.