Claude Code and desktop MCP clients · Integrations docs

Claude Code#

Registers the hosted server. Add --scope user to make it available in every project.

Shell

claude mcp add --transport http botinbox https://botinbox.dev/mcp \
  --header "Authorization: Bearer bi_your_key"

Claude Desktop#

Open Settings, Developer, Edit Config, add the server, and restart Claude Desktop. The config uses mcp-remote to connect to the hosted server (Node.js 18+).

JSON

{
  "mcpServers": {
    "botinbox": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://botinbox.dev/mcp",
        "--header",
        "Authorization:${BOTINBOX_AUTH}"
      ],
      "env": {
        "BOTINBOX_AUTH": "Bearer bi_your_key"
      }
    }
  }
}

Security#

Prefer an inbox- or pod-scoped key for autonomous agents. Do not share an account-wide key unless the agent requires all inboxes.