リモートクライアントを接続する

サーバーの構築、プロキシ設定、ヘルスチェックが完了しました。これで実際のクライアントが公開URLを使ってインターネット経由で接続できます。🌍

リモートクライアントは、ローカルプロセスを起動しなくなります。代わりに、通常は/mcpエンドポイントで終わるサーバーの公開URLを渡します。

Claudeのようなホストでは、コマンドではなくURLを指定してリモートサーバーを登録し、ホストがHTTP経由で接続できるようにします。

保護されたサーバーではアクセストークンが必要です。クライアントは送信するすべてのリクエストにAuthorizationヘッダーとしてトークンを付加します。

独自のPythonクライアントも同じ方法で接続します。stdioを起動するのではなく、リモートURLに対してストリーミング可能なHTTPセッションを開始します。

リモートでもローカルでも、接続は同じinitializeハンドシェイクから始まります。そこでクライアントとサーバーがバージョンと機能について合意します。

接続後、クライアントはローカルサーバーの場合と同じように、ネットワーク経由でツール、リソース、プロンプトの一覧を取得します。

ネットワーク経由では、ローカルのstdioにはなかった遅延が発生します。多少のレイテンシを見込み、遅い呼び出しでユーザーを待たせないようにツールを設計してください。

インターネット接続は不安定なため、接続が切れることがあります。優れたクライアントはセッション全体を失敗させるのではなく、再接続して処理を再開します。

クライアントからプロキシ、サーバーを経由して戻ってくるまで、全経路が機能することを確認します。ツールの結果が正常に返れば、デプロイが実際に稼働している証拠です。✅

リモート化の大きな利点は共有です。1台のホスト型サーバーで、チームメンバー、エージェント、アプリを同時に利用できます。

リモートクライアントは認証トークンを付けて公開URLに接続し、同じハンドシェイクとディスカバリーを実行します。これにより、1台のサーバーを多数のクライアントで利用できます。🎉