Search

Search the documentation

Protobox
Connect your AI

Claude Code

Give Claude Code access to your Protobox tools over MCP.

You need a workspace API key (Connect → MCP in the dashboard).

Option A — one command

claude mcp add --transport http protobox \
  https://your-workspace.protobox.app/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Add -s project to share the server with everyone in the repo (written to .mcp.json), or -s user to use it across all your projects.

Option B — project config file

Create .mcp.json in the project root:

{
  "mcpServers": {
    "protobox": {
      "type": "http",
      "url": "https://your-workspace.protobox.app/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

.mcp.json is meant to be committed — but your API key is not. Prefer Option A with -s user, or keep the key in an environment reference if your team's Claude Code version supports ${VAR} expansion in headers.

Verify

Inside Claude Code, run /mcp — the protobox server should list as connected, with your workspace tools. From your shell, protobox mcp test checks the endpoint independently.

On this page