MCP認証とネットワーキング

ステップバイステップのセットアップには、コーディングエージェントのガイドやPythonクイックスタートを活用してください。 このページを使って、共有認証要件やネットワークアクセスを確認してください。

Azure Databricksにサインイン

インタラクティブな作業にはAzure Databricksのユーザーアカウントを使い、無人で動作するエージェントにはサービスプリンシパルを使います。 エージェントのセットアップに従ってください:

利用シーン 推奨されるセットアップ
コーディング エージェント Unity Gateway CLIを使いましょう。 サインインや認証情報の更新を管理します。
ローカルPython開発 DatabricksのCLIサインインを使いましょう。
その他のインタラクティブMCPクライアント OAuthを登録クライアントIDで設定します。
無人エージェント OAuthマシン間(M2M)でサービスプリンシパルを活用しましょう。 Databricksアプリ上のエージェントについては、 エージェント認証を参照してください。

ユーザーまたはサービス主体は MCPを呼び出すための許可が必要です。 もしツールが外部プロバイダーへのサインインを求めたら、「 外部サービス設定」に従ってください。

ローカルテストのために、Databricks提供および登録済みのMCP、レガシーワークスペースエンドポイントは、Authorization: Bearer <token>ヘッダーに個人アクセストークンを受け入れています。 トークンはソース管理から除外しましょう。 Databricksアプリ上でホストされているサーバーはOAuthを必要とし、個人アクセストークンは受け付けません。

カスタムOAuthクライアントの設定

クライアントが独自のOAuthアプリを必要とする場合に使うと良いでしょう。 Claude CodeやCodexのガイドには、クライアント固有の設定が含まれています。

  1. クライアントからホスト、ポート、パスを含む正確なリダイレクトURLを取得してください。

  2. アカウント管理者にアカウントコンソールで設定を開き、「アプリの接続」を選択し、「接続を追加する」をクリックしてください。

  3. 名前を入力し、リダイレクトURLを追加し、サーバーのスコープを選択します:

    [サーバー] URL Scope
    提供または登録されたMCP https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service> ai-gateway
    Data bricks Apps 上のサーバー https://<app-url>/mcp アプリの ユーザー認証範囲を含めてください。 アプリには「 CAN USE 」も必要です。
    Workspace MCPエンドポイント(レガシー) サーバーのページのURLです そのサーバーに記載されているスコープを使ってください。

  4. クライアントシークレットを生成するかどうかを選択してください:

    • デスクトップまたはCLIクライアント(パブリッククライアント): クリア クライアントシークレットを生成する。
    • 秘密を安全に保存するサーバーサイドクライアント(機密クライアント): Leave クライアント 秘密を生成 する

  5. 接続を保存し、 クライアントIDをコピーします。 クライアントシークレットを生成したなら、その値もコピーしてください。

  6. MCPクライアントにサーバーのURLとクライアントの認証情報を入力してください。 Streamable HTTPを使い、サーバーのリフレッシュトークンのスコープとoffline_accessをリクエストし、サインインしてください。

UIやCLIのオプションについては 「Create a OAuth app 」をご覧ください。 変更は効果が現れるまでに最大30分かかることがあります。 Azure DatabricksのMCPエンドポイントは動的クライアント登録をサポートしていないため、事前に設定されたクライアントIDを受け入れるクライアントを使いましょう。

ネットワークアクセス

クライアントからワークスペースへのアクセス、ワークスペースから外部サーバーへのアクセスを確認しましょう。

クライアントからワークスペースへ

MCPリクエストは、ワークスペースの受信ネットワーク制御によって許可されている必要があります。 ワークスペースの IPアクセスリスト が有効になっている場合は、リクエストが発信されるパブリックIPアドレスを管理者に許可してもらうよう依頼してください:

MCPクライアントが動作する場所 許可すべきアドレス
Claude Code、Codex CLI、Cursorなど、あなたのパソコンで あなたのネットワークのパブリックアウトバウンドIPです。 トラフィックが企業のVPNやプロキシを経由する場合は、そのネットワークの送信IPを使いましょう。 ネットワーク管理者が提供できます。
ClaudeコネクターやChatGPTのようなホスティングサービスにおいて プロバイダーが公開したアウトバウンドIP範囲。 ClaudeのアウトバウンドIPとChatGPTのアウトバウンドIPを参照してください。

ホストクライアントの場合、ブラウザのサインインはあなたのネットワークから、MCPの通話はプロバイダーのサーバーから行われます。 どちらも許可されなければなりません。 例えば、企業のVPNから正常にサインインしても、ChatGPTがあなたのMCPにアクセスできるわけではありません。

もし組織が コンテキストベースのイングレスコントロールを使用している場合、リクエストもそれらのポリシーを満たしなければなりません。 アカウントIPアクセスリストは 、管理者がOAuthアプリを作成する場合など、アカウントコンソールやアカウントAPIアクセスに適用されます。

ワークスペースから外部MCPサーバーへ

Unity Gatewayを経由した外部MCPプロバイダーへの呼び出しは、ワークスペースのサーバーレスコンピュートプレーンを使用します。 これは登録済みの外部サーバーおよび Databricksが提供する外部サービス用MCPに適用されます。

サーバー レスネットワークポリシー が 制限付きアクセスを使っている場合は、サーバーの完全認証ドメイン名(FQDN)を 許可ドメインに追加してください。 まずはMCPのUnity Catalog接続上のホストから始めましょう。 system.access.outbound_networkで追加のブロック先を確認してください。 「 ネットワークポリシー管理 」および 「アウトバウンドネットワークログ」を参照してください。

  • Unity Catalogの接続は、その宛先を自動的に許可するわけではありません。
  • フルアクセス はサーバーレスネットワークポリシーのモードで、デフォルトでアウトバウンドインターネット接続を許可しています。 明示的にブロックされたドメインは依然として拒否されます。 例えば、 mcp.example.com ブロックポリシーはそのMCPサーバーへの呼び出しを阻止します。 管理者にポリシーの ブロックされた宛先を確認してもらうよう依頼してください。
  • MCPトラフィックをドライランモードでテストするには、 すべての製品を選択してください。 DatabricksのSQLおよびAIモデルサービスオプションは、MCPトラフィックをリハーサルに入らせることはありません。

プライベート接続

クラウドネットワーク内のMCPサーバーにアクセスするには、Azure Databricksサーバーレスコンピュートがどのように接続するかを選択してください:

  • プライベートエンドポイント:Private Linkを使ってトラフィックをプライベート接続に保持します。 アカウント管理者は、サーバードメインのプライベートエンドポイントルールを、ワークスペースに紐づくネットワーク接続設定(NCC)に追加します。 クラウド管理者がエンドポイント接続を承認します。 「 プライベート接続の設定」を参照してください。
  • ファイアウォール付きのパブリックエンドポイント:サーバーのファイアウォールを設定し、ワークスペースのクラウドとリージョンに対してAzure DatabricksがサーバーレスのアウトバウンドIPを許可するようにしてください。 これらのIPはAzure Databricksの顧客間で共有されているため、サーバー上で認証を有効にしたままにしてください。 「 送信IPを見つけてファイアウォールを設定する」をご覧ください。

プライベートエンドポイントルールに追加されたドメインはネットワークポリシーによって自動的に許可されるため、 許可ドメインに別々に追加する必要はありません。 公開エンドポイントの場合は 、上記のネットワークポリシー設定に従ってください。

  • 最終更新: