MCP Integration

Every Protobox workspace exposes a managed MCP endpoint. Connect any MCP-compatible client — Claude Desktop, Cursor, Claude Code, or a custom agent — and it gets instant access to your tools, knowledge base, and prompts.

https://{workspace-slug}.protobox.app/mcp

Quick Setup

Step 1: Generate the config

The CLI builds a ready-to-paste config from your stored API key and workspace:

protobox mcp config --format claude

{
  "mcpServers": {
    "protobox": {
      "url": "https://acme.protobox.app/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" },
      "transport": "streamable-http"
    }
  }
}

protobox mcp install generates the same snippet offline, without a server round-trip:

protobox mcp install --format claude

Step 2: Add it to your client

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

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

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

Replace acme with your workspace slug and YOUR_API_KEY with a key from that workspace.

Step 3: Test the connection

protobox mcp test

This runs a full protocol handshake: connect, list tools, list resources, and list prompts. Use protobox mcp info or protobox mcp status to see the server URL, resource counts, and health.

Scope with Toolsets

By default the endpoint exposes your workspace's enabled tools. For production, create a toolset so each client only sees the tools it needs.

# Create a toolset from a JSON definition
protobox toolsets create -f support-toolset.json

# Add tools to it
protobox toolsets add-tools <toolset-id> -t <tool-id-1>,<tool-id-2>

# Verify
protobox toolsets get <toolset-id>

MCP Commands

Authentication

All MCP requests require an X-API-Key header. Keys are workspace-scoped.

Create keys in the dashboard under Connect → MCP or Manage → API Keys.

Security

If a key is compromised, revoke it in the dashboard and generate a new one, then update your MCP config and restart clients.

Troubleshooting

Related