Skip to main content

Other Agents

The Campbooks MCP endpoint is plain streamable HTTP with a Bearer credential — any MCP-capable client works. The configs below point at Campbooks Cloud. For a self-hosted instance, replace https://app.campbooks.not-a-camp.com with your own URL.

Create your MCP key first: Settings → API access → New client. See MCP reference → Authorization for the full key setup and scope guide.

In every snippet below, replace YOUR_MCP_KEY_HERE with your key, or set the CAMPBOOKS_MCP_KEY environment variable and reference it as shown.

Cursor

Add to ~/.cursor/mcp.json:

{
"mcpServers": {
"campbooks": {
"type": "http",
"url": "https://app.campbooks.not-a-camp.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:CAMPBOOKS_MCP_KEY}"
}
}
}
}

Windsurf

Add to mcp_config.json:

{
"mcpServers": {
"campbooks": {
"type": "http",
"url": "https://app.campbooks.not-a-camp.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:CAMPBOOKS_MCP_KEY}"
}
}
}
}

OpenAI Codex CLI

Add to config.toml:

[mcp_servers.campbooks]
url = "https://app.campbooks.not-a-camp.com/api/mcp"
bearer_token_env_var = "CAMPBOOKS_MCP_KEY"

Gemini CLI

Add to settings.json:

{
"mcpServers": {
"campbooks": {
"httpUrl": "https://app.campbooks.not-a-camp.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_KEY_HERE"
}
}
}
}

Any MCP client

The Campbooks MCP server implements MCP protocol version 2025-03-26 over streamable HTTP. Any client that can make authenticated HTTP requests to an MCP endpoint will work:

  • URL: https://app.campbooks.not-a-camp.com/api/mcp (or your self-hosted URL + /api/mcp)
  • Authentication: Authorization: Bearer <mcp-key> request header
  • Protocol: JSON-RPC 2.0, MCP 2025-03-26

OAuth 2.1 dynamic registration and SSE streaming transport are not yet supported — use streamable HTTP.

The server returns only tools whose required scope the key holds. Call tools/list after initialize + notifications/initialized to see exactly what your key can do. See the MCP reference for the full protocol details and tool catalog.