Skip to main content

Connect MCPBundles on Claude Code

For how MCP works in Claude Code — config location, adding servers, and OAuth — read How to Connect MCP Servers to Claude Code.

This page covers connecting MCPBundles MCP servers only.

Requirements​

  • Claude Code installed and signed in
  • An MCP server enabled in your MCPBundles dashboard
  • Credentials connected for the providers on that MCP server

MCP server URL​

  1. Open your MCP server in the MCPBundles dashboard.
  2. Copy the MCP server URL from Quick Setup.
  3. Add that URL in Claude Code using the MCP settings flow described in the Claude Code guide (project or user scope).
  4. Run a quick tool call or ask Claude Code to list tools.

Register with Claude Code CLI​

From your terminal (matches dashboard Quick Setup):

claude mcp add --transport http your-server-key https://mcp.mcpbundles.com/bundle/YOUR-SERVER-SLUG

Replace your-server-key and the URL with values from your MCP server page. Start claude, run /mcp, and complete OAuth when prompted.

For headless use, add --header "X-API-Key: YOUR_WORKSPACE_API_KEY" (create the key under Settings → Security).

mcpbundles init only writes the MCPBundles CLI skill for agents — it does not register MCP servers in Claude Code.

Claude Code Routines (remote cloud agents)​

Anthropic's official name for cloud-hosted Claude Code jobs is Routines (research preview). Routines run on Anthropic-managed infrastructure. They are not the same as local CLI sessions with /mcp: Routines need header-based platform auth because they cannot complete MCPBundles sign-in in a browser on each run.

Use the same MCP server URL as in the dashboard (https://mcp.mcpbundles.com/bundle/{slug}). Create a workspace API key at Settings → Workspace API Keys, then add a header in the Routine MCP connector:

"headers": {
  "X-API-Key": "${MCPBUNDLES_API_KEY}"
}

Full header options: Using API Keys.