Copy page

Remote MCP Server

Remote MCP Server - LLM Integration

LLM Integration Guide

The Tomba Remote MCP Server provides seamless integration with leading Large Language Models (LLMs) and AI assistants through the standardized Model Context Protocol. This guide covers setup, configuration, and best practices for various LLM platforms.

Supported LLM Platforms

AI Assistants

Platform	Support Level	Transport	Authentication	Real-time
Claude Desktop	✅ Full	HTTP/SSE	OAuth 2.0 (automatic)	✅ Yes
Claude Code	✅ Full	HTTP/SSE	OAuth / Bearer	✅ Yes
ChatGPT	✅ Full	HTTP/SSE	OAuth (plugin)	✅ Yes
GitHub Copilot	✅ Full	HTTP/SSE	OAuth / Bearer (prompted)	✅ Yes
Cursor AI	✅ Full	HTTP/SSE	API Key Headers	✅ Yes
Windsurf	✅ Full	HTTP/SSE	OAuth / Bearer	✅ Yes
Zed	✅ Full	HTTP/SSE	OAuth / Bearer	✅ Yes
Codeium	✅ Full	HTTP/SSE	OAuth / Bearer	✅ Yes

Enterprise LLMs

Platform	Support Level	Transport	Authentication	Real-time
Azure OpenAI	✅ Full	HTTP/SSE	Bearer	✅ Yes
Google Gemini	✅ Full	HTTP/SSE	OAuth / Bearer	✅ Yes
Anthropic API	✅ Full	HTTP/SSE	Bearer	✅ Yes

Quick Start Integration

Claude Desktop (OAuth — no keys needed)

The simplest setup. Claude Desktop natively supports OAuth — just provide the URL:

1. Configuration File

Add to claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Code
{
  "mcpServers": {
    "tomba": {
      "url": "https://mcp.tomba.io/mcp"
    }
  }
}

2. Authorize

When you first use a Tomba tool, Claude Desktop opens your browser automatically. Sign in to Tomba, click Authorize, and you're done. Tokens refresh silently — no re-authorization needed.

3. Start Using

Code
Human: How many emails does stripe.com have?

Claude: I'll check that for you using the email_count tool...

Claude Code

Code
# OAuth (recommended — opens browser)
claude mcp add tomba --transport http --url https://mcp.tomba.io/mcp

# Or with Bearer token
claude mcp add tomba --transport http \
  --url https://mcp.tomba.io/mcp \
  --header "Authorization: Bearer YOUR_BASE64_TOKEN"

VS Code (GitHub Copilot)

Add to .vscode/mcp.json:

Option A — OAuth (if supported):

Code
{
  "servers": {
    "tomba": {
      "type": "http",
      "url": "https://mcp.tomba.io/mcp"
    }
  }
}

Option B — Bearer token (prompted):

Code
{
  "inputs": [
    {
      "type": "promptString",
      "id": "tomba-bearer",
      "description": "Tomba bearer token (base64 of ta_api_key:ts_secret_key)",
      "password": true
    }
  ],
  "servers": {
    "tomba": {
      "type": "http",
      "url": "https://mcp.tomba.io/mcp",
      "headers": {
        "Authorization": "Bearer ${input:tomba-bearer}"
      }
    }
  }
}

Cursor Integration

Cursor uses API key headers directly:

Code
{
  "mcpServers": {
    "tomba": {
      "url": "https://mcp.tomba.io/mcp",
      "transport": "http",
      "headers": {
        "X-Tomba-Key": "ta_your_api_key",
        "X-Tomba-Secret": "ts_your_secret_key"
      }
    }
  }
}

Windsurf

Option A — OAuth (if supported):

Code
{
  "mcpServers": {
    "tomba": {
      "serverUrl": "https://mcp.tomba.io/mcp"
    }
  }
}

Option B — Bearer token:

Code
{
  "mcpServers": {
    "tomba": {
      "serverUrl": "https://mcp.tomba.io/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_BASE64_TOKEN"
      }
    }
  }
}

Zed

Add to Zed settings.json:

Code
{
  "context_servers": {
    "tomba": {
      "settings": {
        "url": "https://mcp.tomba.io/mcp"
      }
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json:

Code
{
  "mcpServers": {
    "tomba": {
      "url": "https://mcp.tomba.io/mcp"
    }
  }
}

ChatGPT (OpenAI Responses API)

Code
curl https://api.openai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_OPENAI_API_KEY" \
  -d '{
    "model": "gpt-4.1",
    "tools": [
      {
        "type": "mcp",
        "server_label": "tomba",
        "server_url": "https://mcp.tomba.io/mcp",
        "require_approval": "never"
      }
    ],
    "input": "Find email addresses for stripe.com"
  }'

Troubleshooting

Authentication Errors

• OAuth: Ensure you completed the browser authorization flow
• Bearer: Verify token is base64(ta_key:ts_secret) — not raw credentials
• API Key: Verify key format: ta_xxxxxxxxxx and ts_xxxxxxxxxx

OAuth Flow Not Starting (Claude Desktop)

• Ensure Claude Desktop is the latest version
• Check that /.well-known/oauth-protected-resource returns valid metadata
• Try removing and re-adding the MCP server in config
• Restart Claude Desktop

OAuth Token Expired

• Tokens refresh automatically — restart Claude Desktop to trigger refresh
• If refresh fails, remove the server from config, restart, and re-add
• Check if access was revoked at Settings → Connected Apps

Rate Limit Exceeded

• Check response headers: x-minute-request-left and x-daily-request-left
• Wait for x-minute-reset-seconds before retrying
• Check current usage in dashboard
• Consider upgrading your plan

Managing Connected Apps

Revoke OAuth access for any application at:

Settings → Connected Apps — app.tomba.io/settings/connected-apps