メインコンテンツまでスキップ

MCP ネットワーキング

モデルコンテクストプロトコル(MCP)クライアントからワークスペースへのインバウンド、およびワークスペースから外部MCPサーバーへのアウトバウンドの双方向でネットワークアクセスを確認します。サインインとIDの詳細については、MCP認証を参照してください。

クライアントからワークスペースへ (インバウンド)​

MCPリクエストは、ワークスペースのインバウンドネットワーク制御によって許可されている必要があります。次の表は、クライアントのタイプとインバウンド制御ごとに許可する内容を示しています:

コンテキストベースのイングレス (推奨)

パブリック アクセスを無効にした フロントエンド Private サービス Connect

MCPクライアントは、ChatGPTやClaudeコネクタなどのホストされたサービスでランされます

ChatGPT または Claude をパートナー プラットフォームとして追加します。Databricks が IP 範囲を最新の状態に維持します。

ホストされているクライアントは接続できません。パブリックアクセスを有効のままにして、コンテキストベースのイングレスで制限します。

MCPクライアントは、Claude Code、Codex CLI、Cursorなど、コンピュータでランされます

ネットワークのパブリックアウトバウンドIPを許可します。

プライベートEndpoint経由で接続します。

コンテキストベースのイングレス (推奨)

パブリック アクセスを無効にした フロントエンド Private サービス Connect

MCPクライアントは、ChatGPTやClaudeコネクタなどのホストされたサービスでランされます

ChatGPT または Claude をパートナー プラットフォームとして追加します。Databricks が IP 範囲を最新の状態に維持します。

ホストされているクライアントは接続できません。パブリックアクセスを有効のままにして、コンテキストベースのイングレスで制限します。

MCPクライアントは、Claude Code、Codex CLI、Cursorなど、コンピュータでランされます

ネットワークのパブリックアウトバウンドIPを許可します。

プライベートEndpoint経由で接続します。

ホスト型クライアントの場合、ブラウザのサインインはネットワークから行われ、MCP呼び出しはプロバイダーのサーバーから行われます。両方を許可する必要があります。たとえば、企業VPNから正常にサインインしても、ChatGPTがMCPに到達できるとは限りません。

コンテキストベースのイングレスを持つクライアントを許可する (推奨)​

MCPクライアントの接続を許可しながらワークスペースへのインバウンドネットワークアクセスを保護するために、Databricksはコンテキストベースのイングレスコントロールの使用を推奨しています:

  • ホスト型クライアント : ワークスペースコンテキストベースのイングレスポリシーのパートナープラットフォームとしてChatGPTまたはClaudeを追加します。Databricksはプロバイダーが公開しているIP範囲を同期するため、自分で維持する必要はありません。「 コンテキストベースのイングレスポリシーでのパートナープラットフォームの許可」を参照してください。
  • コンピュータのクライアント : ネットワークのパブリックアウトバウンドIPを許可するルールを追加します。トラフィックが企業VPNまたはプロキシを経由する場合は、そのネットワークのアウトバウンドIPを使用してください。ネットワーク管理者に確認してください。

強制モードでは、コンテキストベースのイングレスは、許可ルールに一致しない要求をブロックします。許可された要求も認証されている必要があり、それらは認証済みのユーザーまたはそれを行ったService Principalの権限で実行されます。

フロントエンドPrivateサービスConnect​

ワークスペースでフロントエンド Private Service Connectを使用していてパブリックアクセスが無効になっている場合、コンピュータ上の MCP クライアントは接続できますが、ChatGPT や Claude コネクタなどのホストされたクライアントの MCP はブロックされます。

これらのクライアントを許可し、パブリックアクセスを制限するには、パブリックアクセスを有効にし、パートナープラットフォームとして許可するコンテキストベースのイングレスポリシーで制限します。

ワークスペース IP アクセスリスト​

ワークスペースが引き続きワークスペースIPアクセスリストを強制している場合、それらはコンテキストベースのイングレスと共に評価され、要求は両方によって許可される必要があります。IPアクセスリストがプロバイダーのIPをブロックしている間は、パートナープラットフォームルールだけでは不十分です。IPアクセスリストをコンテキストベースのイングレスに移行し、その適用をオフにします。ワークスペースIPアクセスリストのコンテキストベースのイングレスへの移行を参照してください。

注記

まだ移行できない場合は、プロバイダーの公開 IP 範囲を IP アクセスリストに追加してください。Claude のアウトバウンド IP および ChatGPT のアウトバウンド IP を参照してください。コンピュータ上のクライアントの場合は、ネットワークのパブリックアウトバウンド IP を追加します。プロバイダーの IP 範囲は変更される可能性があるため、変更時にはリストを更新してください。

アカウントIPアクセスリスト​

アカウントIPアクセスリストは、アカウントコンソールおよびアカウントAPIアクセス(管理者がOAuthアプリを作成する場合など)に適用されます。これらは、ワークスペースへのMCP呼び出しには適用されません。

ワークスペースからMCPサーバー(アウトバウンド)​

Unity Gatewayを介した外部MCPプロバイダへの呼び出しには、ワークスペースのServerlessコンピュートプレーンが使用されます。これは、登録済みの外部サーバーと外部サービス用としてDatabricksが提供するMCPに適用されます。Serverless出力制御は、Serverlessコンピュートが到達できる宛先を決定します。

パブリックインターネット上のMCPサーバー​

ワークスペースのServerlessエグレス制御で 制限付きアクセス を使用している場合は、サーバーの完全修飾ドメイン名 (FQDN) を 許可されたドメイン に追加してください。MCP の Unity Catalog 接続のホストから起動します。Serverless エグレス 制御のためのネットワークポリシーの管理を参照してください。

  • Unity Catalog接続は、自動的にその宛先を許可しません。
  • フルアクセス では、Serverlessコンピュートはdefaultでインターネットの宛先に到達できますが、明示的にブロックされたドメインは引き続き拒否されます。例えば、mcp.example.com をブロックすると、その MCP サーバーへの呼び出しが禁止されます。管理者に ブロックされた宛先 を確認するよう依頼してください。
  • MCPトラフィックをドライランモードでテストするには、 すべての製品 を選択します。 Databricks SQL および AI モデルサービング オプションでは、MCP トラフィックはドライランになりません。

クラウドネットワーク内の MCP サーバー​

Private Service Connectは、MCPをバックアップするHTTP接続ではサポートされていません。サーバーのファイアウォールでDatabricks serverlessの送信IPを許可します。Serverless アクセス用のファイアウォールの設定を参照してください。

ブロックされたリクエストのトラブルシューティング​

ネットワークアクセスシステムテーブルを使用して、どのルールがリクエストをブロックしたかを調べます:

一般的な原因:

  • サインインは成功しますが、ホストされたクライアントからのMCP呼び出しが失敗する :プロバイダーのIP範囲が許可されていません。プロバイダーをパートナープラットフォームとして追加するか、そのIP範囲をIPアクセスリストに追加してください。
  • パートナープラットフォームのルールが有効になっていますが、リクエストは引き続きブロックされています : ワークスペースのIPアクセスリストが引き続き適用されており、プロバイダーのIPが含まれていません。ワークスペース IP アクセスリストを参照してください。
  • ホストされたクライアントがフロントエンドのPrivate Service Connectを備えたワークスペースに到達できない :パブリックアクセスが無効になっている可能性があります。パブリックアクセスを有効にし、コンテキストベースのイングレスで制限します。
  • 外部MCPサーバーへの呼び出しが失敗する :サーバーのドメインが 「許可されたドメイン」 に含まれていないか、明示的にブロックされている可能性があります。