Skip to main content

Claude Code Integration

Connect your MCP bundles to Claude Code (CLI) to use tools directly from the command line.

Requirements​

  • Claude Code CLI installed (get it from Anthropic)
  • A bundle enabled in your MCPBundles dashboard
  • Credentials connected for providers in your bundle

Time to complete: 2-3 minutes

Step-by-Step Setup​

1. Get Your Bundle URL​

  1. Log in to MCPBundles Dashboard
  2. Click on the bundle you want to use
  3. Copy the MCP Server URL

2. Add the Bundle​

Use the claude mcp add command:

claude mcp add --transport http your-bundle-name https://mcp.mcpbundles.com/bundle/YOUR-BUNDLE-ID

Replace:

  • your-bundle-name - Short identifier (e.g., marketing)
  • https://mcp.mcpbundles.com/bundle/YOUR-BUNDLE-ID - Your actual bundle URL

Example:

claude mcp add --transport http marketing https://mcp.mcpbundles.com/bundle/abc123

3. Start Claude Code​

Launch a Claude Code session:

claude

You'll enter an interactive session.

4. Authenticate MCP Tools​

Inside the Claude Code session, type:

/mcp

This triggers the authentication flow:

  1. Claude Code will list available MCP servers
  2. Select your bundle
  3. Follow the OAuth/authentication prompts
  4. Once authenticated, tools are available

5. Verify Tools Are Available​

Ask Claude:

What tools do you have access to?

Expected response:

"I have access to the following tools from your marketing bundle:

  • list_campaigns
  • create_contact
  • send_message ..."

Using Tools in Claude Code​

Once connected, Claude can use your tools when relevant.

Example Prompts​

Check campaign data:

"Check my Smartlead campaigns and summarize the top 3 by reply rate"

Create contacts:

"Add John Doe (john@example.com) to HubSpot as a new contact"

GitHub operations:

"List my GitHub repos and tell me which ones have open PRs"

Claude Code will call the tools, get results, and respond.

Managing MCP Servers​

List all MCP servers​

claude mcp list

Remove a bundle​

claude mcp remove your-bundle-name

Update a bundle URL​

Remove and re-add:

claude mcp remove marketing
claude mcp add --transport http marketing https://mcp.mcpbundles.com/bundle/new-id

Troubleshooting​

"Authentication required" when using tools​

Cause: Credentials not connected.

Fix:

  1. Exit Claude Code
  2. Go to Dashboard → Providers
  3. Click Connect on needed providers
  4. Complete OAuth or add API key
  5. Restart Claude Code and run /mcp again

Tools don't appear after adding bundle​

Cause: MCP server not initialized.

Fix:

  1. Exit Claude Code (Ctrl+C or type exit)
  2. Restart: claude
  3. Run /mcp again
  4. Select your bundle and authenticate

"Server connection failed"​

Cause: Invalid URL or bundle not enabled.

Fix:

  • Verify URL is exactly as shown in dashboard
  • Check bundle is enabled (Dashboard → Bundles)
  • Make sure you used --transport http
  • Try removing and re-adding the bundle

"/mcp command not found"​

Cause: Outdated Claude Code.

Fix:

  • Update Claude Code to the latest release
  • MCP support is included in current versions

Advanced Usage​

Multiple Bundles​

Add multiple bundles:

claude mcp add --transport http marketing https://mcp.mcpbundles.com/bundle/abc123
claude mcp add --transport http dev-tools https://mcp.mcpbundles.com/bundle/def456
claude mcp add --transport http crm https://mcp.mcpbundles.com/bundle/ghi789

All tools from all bundles will be available in Claude Code sessions.

Environment-Specific Bundles​

Use different bundles for different environments:

Production:

claude mcp add --transport http prod https://mcp.mcpbundles.com/bundle/prod-id

Staging:

claude mcp remove prod
claude mcp add --transport http staging https://mcp.mcpbundles.com/bundle/staging-id

Scripting with Claude Code​

You can use Claude Code in scripts:

#!/bin/bash
echo "Check campaign performance" | claude

Tools will be called automatically if relevant.

Limitations​

  • Interactive authentication: OAuth flows require manual interaction
  • Session-based: Each new session may require re-authentication
  • Network required: Tools need internet access

Tips​

Naming Bundles​

Use short, descriptive names:

  • ✅ marketing
  • ✅ dev
  • ✅ crm
  • ❌ my-really-long-bundle-name-2024

Testing Before Production​

Test bundles in a separate session:

  1. Add with a test name
  2. Verify tools work
  3. Remove test bundle
  4. Add with production name

Next Steps​

Need Help?​