Remote Servers

Types

HTTP

{
  "mcpServers": {
    "remote-http": {
      "url": "https://api.example.com/mcp",
      "type": "http",
      "headers": { "Authorization": "Bearer ${API_TOKEN}" }
    }
  }
}

SSE

{
  "mcpServers": {
    "remote-sse": {
      "url": "https://stream.example.com/mcp",
      "type": "sse",
      "headers": { "Authorization": "Bearer ${API_TOKEN}" }
    }
  }
}

Authentication patterns

Bearer token

{ "headers": { "Authorization": "Bearer ${API_TOKEN}" } }

API key

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

API key (query)

{ "url": "https://api.example.com/mcp?api_key=${API_KEY}" }

Basic auth

{ "headers": { "Authorization": "Basic ${BASE64_CREDENTIALS}" } }

Tip

BASE64_CREDENTIALS = base64 of username:password.

Cloudflare Workers (example)

worker.ts

import { createHub } from '@himorishige/hatago-hub';
export default {
  async fetch(_req: Request, env: Env) {
    const hub = createHub({
      servers: {
        'remote-api': {
          url: env.REMOTE_MCP_URL,
          type: 'http',
          headers: { Authorization: `Bearer ${env.API_TOKEN}` }
        }
      }
    });
    // handle request with hub...
  }
}

Troubleshooting

Connection errors

Symptoms

Connection refused or timeout

Fixes:

1. Verify URL and reachability
2. Check firewall/proxy
3. Confirm remote service status

Auth errors

Symptoms

401 or 403

Fixes:

1. Ensure env vars are set
2. Check token expiry
3. Verify required scopes

CORS (browser)

Set CORS headers on the server or use a proxy/edge runtime like Workers.

Tips

• Keep secrets in env vars
• Use tags to separate environments (development/staging/production)
• Turn on --verbose while debugging

Next

• Tag Filtering
• Config Reference