MCP Server Bearer Auth

🚀 Cloudflare上でのリモートMCPサーバーの構築

Cloudflare Workers上で、OAuthログイン機能を統合した、動作良好なリモートMCPサーバーを起動しましょう！

🚀 クイックスタート

📦 インストール

ローカル開発環境のセットアップ

# リポジトリのクローン
git clone git@github.com:cloudflare/ai.git

# 依存関係のインストール
cd ai
npm install

# ローカルでの実行
npx nx dev remote-mcp-server-bearer-auth

ブラウザで http://localhost:8787/ を開くことで、サーバーを確認できます。

💻 使用例

MCPチェッカーをサーバーに接続する

新しいMCP APIを探索するには、MCP Inspector を使用できます。

• npx @modelcontextprotocol/inspector を実行して起動します。
• チェッカー（例：http://localhost:5173）で、転送タイプを SSE に切り替え、URLに http://localhost:8787/sse をMCPサーバーのアドレスとして入力し、「接続」をクリックします。
• bearer token を追加し、「接続」をクリックします。
• 「列出工具」をクリックします。
• 「getToken」ツールを実行すると、チェッカーで設定したAuthorizationヘッダーが返されます。

Claude DesktopをローカルのMCPサーバーに接続する

    "remote-example": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse",
        "--header",
        "Authorization: Bearer {token}"
      ]
    }

🚀 クラウドフレアへのデプロイ

npm run deploy

リモートMCPクライアントから新しいリモートMCPサーバーを呼び出す

「ローカル開発」と同じように、MCPチェッカーを実行します。 npx @modelcontextprotocol/inspector@latest

そして、チェッカーでWorkerの workers.dev URL（例：worker-name.account-name.workers.dev/sse）をMCPサーバーのアドレスとして入力し、「接続」をクリックします。

これで、MCPサーバーがリモートMCPクライアントに接続されました。上記のようにbearer tokenを渡すことができます。

Claude DesktopをリモートMCPサーバーに接続する

TODO：任意のヘッダーを mcp-remote プロキシに対応させる必要があります。

🔧 デバッグ

問題が発生した場合は、Claudeを再起動するか、以下のコマンドで直接MCPサーバーに接続すると解決する場合があります。

npx mcp-remote http://localhost:8787/sse

まれに、~/.mcp-auth ディレクトリ内のファイルを削除すると役立つことがあります。

rm -rf ~/.mcp-auth