Carbone

HTTP — mcp.carbone.io (no local installation)

Connect directly to the hosted endpoint. Supported by VS Code, Cursor, Claude Code, and other clients that support streamable HTTP transport.

{ "mcp": { "servers": { "carbone": { "type": "streamable-http", "url": "https://mcp.carbone.io", "headers": { "Authorization": "Bearer your_api_key_here" } } } } }

Authentication:The HTTP endpoint currently requires a Carbone API key passed as a Bearer token in theAuthorizationheader. OAuth2 support (for Claude Desktop, Mistral, ChatGPT, Gemini, and other clients) is planned for a future release.

Cursoruses{ "mcpServers": { ... } }instead of{ "mcp": { "servers": { ... } } }— the inner config block is identical.

Claude Desktopdoes not support HTTP Bearer token authentication — use the stdio option above instead.

docker run -d -p 3000:3000 \ -e MCP_TRANSPORT=http \ -e CARBONE_API_KEY=your_api_key_here \ carbone/carbone-mcp

Connect your MCP client tohttp://your-host:3000using the HTTP config above (replace the URL).

CARBONE_API_KEY=your_key docker compose up -d

Claude Desktop with Docker (stdio)— Claude Desktop does not support HTTP transport; use the stdio mode instead:

{ "mcpServers": { "carbone": { "command": "docker", "args": ["run", "-i", "--rm", "-e", "CARBONE_API_KEY=your_api_key_here", "-e", "MCP_TRANSPORT=stdio", "carbone/carbone-mcp"] } } }