Skip to main content
Claude Code integration Integrate your deployed MCP servers with Claude Code to enhance your development workflow with AI-powered assistance.

​
Overview

Claude Code is Anthropic’s AI-powered coding assistant that runs directly in your editor. By connecting your MCP servers, you can extend Claude Code with custom tools and capabilities.

​
Setup Instructions

1

Open your Claude Code configuration

Access Claude Code settings in your editor
2

Navigate to MCP Servers settings

Find the MCP configuration section
3

Add the JSON configuration below

Paste the generated JSON configuration
4

Reload the window (Cmd/Ctrl + R)

Restart Claude Code to apply changes
5

The server will be available in your session

The MCP server will now be accessible

​
Configuration Format

{
  "mcpServers": {
    "echo": {
      "command": "npx",
      "args": [
        "@nimbletools/mcp-http-bridge",
        "--endpoint",
        "https://mcp.nimbletools.ai/{workspace-id}/{server-name}/mcp",
        "--token",
        "YOUR_WORKSPACE_TOKEN"
      ]
    }
  }
}
Claude Code uses a simplified configuration without auth fields.

​
Getting Your Configuration

1

Navigate to Toolbox

Go to the Toolbox section in NimbleBrain Studio
2

Find Your Server

Locate the MCP server you want to connect
3

Click Connect

Click the Connect button on the server card
4

Select Claude Code

Choose “Claude Code” from the integration options
5

Copy Configuration

Copy the generated configuration to your clipboard

​
Configuration Details

The configuration includes:
​
command
string
The command to run (typically npx for Node packages)
​
args
array
Arguments passed to the command:
  • @nimbletools/mcp-http-bridge - The bridge package
  • --endpoint - Your MCP server endpoint URL
  • --token - Your workspace API token

​
Workspace Token

You need a workspace API token to authenticate:
  1. Navigate to API Tokens in Studio settings
  2. Click Create Token
  3. Copy the token value
  4. Replace YOUR_WORKSPACE_TOKEN in the configuration
Store your token securely! Anyone with your token can access your workspace.

​
Troubleshooting

Possible causes:
  • Configuration not saved correctly
  • Claude Code not reloaded
  • Syntax error in JSON
Solution:
  • Verify JSON is valid (use a JSON validator)
  • Fully reload Claude Code window (Cmd/Ctrl + R)
  • Check Claude Code logs for errors
Possible causes:
  • Invalid or expired token
  • Token not replaced in config
  • Wrong workspace selected
Solution:
  • Generate a new token in Studio
  • Ensure YOUR_WORKSPACE_TOKEN is replaced with actual token
  • Verify token is for the correct workspace
Possible causes:
  • Server not running
  • Network connectivity issues
  • Incorrect endpoint URL
Solution:
  • Check server status in Toolbox (should show “Running”)
  • Verify internet connection
  • Confirm endpoint URL matches your workspace and server
Possible causes:
  • Server error or crash
  • Missing required environment variables
  • Tool configuration issues
Solution:
  • Check server logs in Studio
  • Verify any required secrets are set
  • Restart the server in Toolbox

​
Advanced Configuration

​
Multiple Servers

You can connect multiple MCP servers: 
{
  "mcpServers": {
    "server-one": {
      "command": "npx",
      "args": [
        "@nimbletools/mcp-http-bridge",
        "--endpoint",
        "https://mcp.nimbletools.ai/{workspace-id}/server-one/mcp",
        "--token",
        "YOUR_TOKEN"
      ]
    },
    "server-two": {
      "command": "npx",
      "args": [
        "@nimbletools/mcp-http-bridge",
        "--endpoint",
        "https://mcp.nimbletools.ai/{workspace-id}/server-two/mcp",
        "--token",
        "YOUR_TOKEN"
      ]
    }
  }
}

​
Environment Variables

Use environment variables for sensitive data: 
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": [
        "@nimbletools/mcp-http-bridge",
        "--endpoint",
        "https://mcp.nimbletools.ai/{workspace-id}/{server-name}/mcp",
        "--token",
        "${NIMBLEBRAIN_TOKEN}"
      ]
    }
  }
}
Set the environment variable in your shell: 
export NIMBLEBRAIN_TOKEN="your-token-here"

Toolbox

Install and manage MCP servers

API Tokens

Generate workspace tokens

All Integrations

View all client integrations

Activity Logs

Monitor server usage
⌘I