リモートサーバーの接続

Hatago Hubは、ローカルのMCPサーバーだけでなく、HTTP/SSE経由でリモートのMCPサーバーとも接続できます。これにより、クラウド上のサービスや外部APIと簡単に連携できるようになります。

リモートサーバーの種類

HTTP
SSE

標準的なHTTP通信でMCPサーバーと接続します。リクエスト/レスポンス型の通信に適しています。

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

Server-Sent Events（SSE）を使用して、サーバーからのリアルタイム通知を受け取れます。

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

設定手順

APIキーの準備

リモートサーバーのAPIキーやアクセストークンを取得します。
Terminal window
```
# 環境変数に設定
export API_TOKEN="your-api-token-here"
```

設定ファイルの編集

hatago-config.jsonにリモートサーバーを追加します：

{
  "mcpServers": {
    "openai-api": {
      "url": "https://api.openai.com/v1/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer ${OPENAI_API_KEY}",
        "Content-Type": "application/json"
      },
      "tags": ["ai", "production"]
    }
  }
}

接続テスト

サーバーを起動して接続を確認します：
Terminal window
```
hatago serve --verbose
```
接続確認 内部リソース hatago://servers を読み取って、接続済みサーバーを確認します。

認証パターン

Bearer Token認証

最も一般的な認証方式です：

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

APIキー認証

ヘッダーまたはクエリパラメータで認証：

{
  "mcpServers": {
    "api-key-header": {
      "url": "https://api.example.com/mcp",
      "type": "http",
      "headers": {
        "X-API-Key": "${API_KEY}"
      }
    },
    "api-key-query": {
      "url": "https://api.example.com/mcp?api_key=${API_KEY}",
      "type": "http"
    }
  }
}

Basic認証

ユーザー名とパスワードでの認証：

{
  "mcpServers": {
    "basic-auth": {
      "url": "https://api.example.com/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Basic ${BASE64_CREDENTIALS}"
      }
    }
  }
}

実践的な例

OpenAI APIとの連携

{
  "mcpServers": {
    "openai": {
      "url": "https://api.openai.com/v1/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer ${OPENAI_API_KEY}",
        "OpenAI-Organization": "${OPENAI_ORG_ID}"
      },
      "tags": ["ai", "gpt", "production"]
    }
  }
}

Slack APIとの連携

{
  "mcpServers": {
    "slack": {
      "url": "https://slack.com/api/mcp",
      "type": "sse",
      "headers": {
        "Authorization": "Bearer ${SLACK_BOT_TOKEN}"
      },
      "tags": ["communication", "notification"]
    }
  }
}

GitHub APIとの連携

{
  "mcpServers": {
    "github": {
      "url": "https://api.github.com/mcp",
      "type": "http",
      "headers": {
        "Authorization": "token ${GITHUB_TOKEN}",
        "Accept": "application/vnd.github.v3+json"
      },
      "tags": ["development", "vcs"]
    }
  }
}

Cloudflare Workersでの利用

Cloudflare Workersでは、ローカルサーバーは利用できませんが、リモートサーバーは問題なく利用できます：

// wrangler.toml
[vars];
REMOTE_MCP_URL = 'https://api.example.com/mcp';

// worker.ts
import { createHub } from '@himorishige/hatago-hub';

export default {
  async fetch(request: Request, env: Env) {
    const hub = createHub({
      servers: {
        'remote-api': {
          url: env.REMOTE_MCP_URL,
          type: 'http',
          headers: {
            Authorization: `Bearer ${env.API_TOKEN}`
          }
        }
      }
    });

    // Hub処理...
  }
};

トラブルシューティング

接続エラー

症状

Connection refusedやtimeoutエラーが発生する

解決方法：

URLが正しいか確認
ファイアウォールやプロキシの設定を確認
APIサービスのステータスを確認

認証エラー

症状

401 Unauthorizedや403 Forbiddenエラー

解決方法：

環境変数が正しく設定されているか確認
Terminal window
```
echo $API_TOKEN
```
トークンの有効期限を確認
必要な権限が付与されているか確認

CORS エラー（ブラウザ環境）

症状

ブラウザコンソールにCORSエラーが表示される

解決方法：

サーバー側でCORSヘッダーを設定
プロキシサーバーを経由する
Cloudflare WorkersなどのEdge環境を利用

ベストプラクティス

次のステップ

タグを使った環境管理 - 環境別にサーバーを切り替える
設定の継承 - 共通設定の再利用
トラブルシューティング - 代表的な失敗と解決策