メインコンテンツにスキップ

リモートMCPサーバー経由でカスタムコネクタを構築する

今日アップデートされました

リモートMCPを使用したカスタムコネクタは、Free、Pro、Max、Team、およびEnterpriseプランのユーザー向けにClaude、Cowork、およびClaude Desktopで利用可能です。Freeユーザーは1つのカスタムコネクタに制限されています。この機能は現在ベータ版です。

リモートMCPサーバーの構築

リモートサーバーを始めるには、以下のリソースから始めてください:

その他のリソース(これなど)も、リモートサーバーの構築、デプロイ、トラブルシューティング時の考慮事項について学ぶのに役立つ場合があります。

さらに、Cloudflareなどのソリューションは、自動スケーリング、OAuthトークン管理、デプロイメント機能を備えたリモートMCPサーバーホスティングを提供しています。

MCPサポート

プラットフォーム

  • リモートMCPサーバーは、Pro、Max、Team、およびEnterpriseプランのユーザー向けにClaudeおよびClaude Desktopでサポートされています。

    • Claude Desktopで使用するようにリモートMCPサーバーを構成するには、カスタマイズ > コネクタ経由で追加します。Claude Desktopは、claude_desktop_config.json経由で直接構成されたリモートサーバーには接続しません。

  • 7月現在、Claude for iOSおよびAndroidもリモートMCPサーバーをサポートしています!

    • ユーザーは、claude.ai経由で既に追加したリモートサーバーからのツール、プロンプト、およびリソースを使用できます。ユーザーはClaude Mobileから直接新しいサーバーを追加することはできません。

ネットワーク到達可能性

すべてのリモートMCP接続は、ユーザーが実行しているClaudeクライアントに関係なく、Anthropicのクラウドインフラストラクチャから発信されます。サーバーは、Anthropicのip範囲からのインバウンドHTTPS接続を受け入れる必要があります。現在のリストについては、Anthropic IPアドレスを参照してください。

これは、ユーザーがCoworkまたはClaude Desktopをローカルで実行している場合にも適用されます。カスタマイズ > コネクタ経由で追加されたリモートコネクタはサーバー側で仲介されるため、MCPサーバーへのリクエストはユーザーのマシンではなくAnthropicから来ます。

サーバーがプライベートネットワーク内で実行されている場合は、ファイアウォールまたはイングレスを構成して、Anthropicの公開されたIP範囲からのインバウンドトラフィックを許可します。VPN経由でのみ到達可能、またはAnthropicのエグレスIPをブロックするファイアウォールの背後にあるサーバーは接続に失敗します。

トランスポートと認証

  • ClaudeはSSEおよびStreamable HTTPベースのリモートサーバーの両方をサポートしていますが、SSEのサポートは今後数ヶ月で廃止される可能性があります。

  • ClaudeはAuthlessおよびOAuthベースのリモートサーバーの両方をサポートしています。

認証サポート

  • Claudeは3/26認証仕様および(7月現在)6/18認証仕様をサポートしています。

  • Claudeは動的クライアント登録(DCR)をサポートしています。

    • OAuthサーバーは、DCRクライアントが削除されたこと、およびClaudeがトークンエンドポイントからinvalid_clientエラーを含むHTTP 401を返すことでクライアントを再登録する必要があることをClaudeに通知できます。これはRFC 6749で説明されています。

    • 7月現在、ユーザーはDCRをサポートしないサーバーを構成する際に、カスタムクライアントIDとクライアントシークレットを指定することもできます。

  • ClaudeのOAuthコールバックURLはhttps://claude.ai/api/mcp/auth_callbackで、OAuthクライアント名はClaudeです。

    • このコールバックURLは将来https://claude.com/api/mcp/auth_callbackに変更される可能性があります。MCPクライアントコールバックURLをホワイトリストに登録することを選択した場合は、サーバーがClaudeで引き続き機能することを確認するために、このコールバックURLもホワイトリストに登録してください。

  • Claudeはトークンの有効期限と更新をサポートしています。サーバーはユーザーに最高のエクスペリエンスを提供するために、この機能をサポートする必要があります。

MCPサーバーへのインバウンドおよびアウトバウンド接続にClaudeが使用するIPアドレスについては、こちらを参照してください。非ClaudeMCPクライアントを許可しないことを希望するサーバー開発者は、これらのIPアドレス、ClaudeのOAuthコールバックURL、および/またはClaudeのOAuthクライアント名をホワイトリストに登録できます。

プロトコル機能

  • Claudeはツール、プロンプト、およびリソースをサポートしています。

    • Claudeはテキストおよび画像ベースのツール結果をサポートしています。

    • Claudeはテキストおよびバイナリベースのリソースをサポートしています。

  • Claudeはまだリソースサブスクリプション、サンプリング、およびその他のより高度なまたはドラフト機能をサポートしていません。

リモートMCPサーバーのテスト

サーバーをテストおよび検証する最良の方法は、Claudeに追加することを試みることです。

または、インスペクタツールを使用します。これにより、以下を検証できます:

  • サーバーが認証フローを正常に開始して完了すること。

  • サーバーが認証フローのさまざまな部分を正しく実装していること。

  • サーバーが公開するツール、プロンプト、リソース、およびその他のMCP機能。

インスペクタの使用方法の詳細および、サーバーのデバッグとトラブルシューティング方法に関するその他のヒントについては、MCPドキュメントを参照してください。

さらに、Cloudflareの AI Playgroundなどの他のソリューションを使用して、リモートMCPサーバー機能をテストできます。

こちらの回答で解決しましたか?