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

外部MCPサーバー

チームが Unity Gateway を通じて使用できるように、セルフホストまたはサードパーティの MCP サーバーを登録します。登録の一環として接続を作成します。

Databricksがすでに提供しているサーバーの場合、Databricks提供のMCPを選択します。自動化されたセットアップについては、APIおよびSDKリファレンスを参照してください。

始める前に​

必要なもの:

  • Unity Catalogが有効なワークスペースと、 ワークスペースアクセス エンタイトルメント。 Consumer access を持つユーザーは、MCPを登録できません。
  • Streamable HTTPをサポートするMCPサーバー、そのURL、および認証の詳細。
  • USE CATALOG また、親カタログとスキーマに対してはUSE SCHEMA、スキーマに対してはCREATE SERVICEが必要です。
  • CREATE CONNECTION スキーマ上で USE CONNECTION を実行して接続を作成するか、既存の接続上で を実行します。
  • ワークスペースからサーバーへのネットワークアクセス。MCP の認証とネットワーキングを参照してください。

ワークスペースは、Model Serving をサポートするリージョン内にある必要があります。

ステップ1: サーバーを登録する​

  1. ワークスペースで Unity Gateway を開き、 MCPs を選択して、 + MCP をクリックします。

  2. 既存のMCPサーバーに接続 を選択します。

  3. カタログとスキーマを選択し、MCP 名を入力します。名前は作成後に変更することはできません。

  4. 既存の HTTP 接続を選択するか、 新しい接続を作成 をクリックします。

    • MCPサーバーURLを入力します。
    • 認証方法を選択し、プロバイダーの資格情報を入力します。サポートされているプロバイダーの場合は、マネージド OAuth を使用します。
    • 独自のリダイレクト URL で OAuth を使用する場合は、アプリの許可されたリダイレクト URL に https://<workspace-hostname>/login/oauth/http.html を追加します。プロバイダーによっては、これがないとサインインが拒否される場合があります。各認証方法のフィールドについては、外部サービスへの接続を作成するを参照してください。
    • Create & load tools をクリックして接続を保存し、そのツールを検出します。
  5. [ツール] で、プロンプトが表示されたら [ログイン] をクリックし、プロバイダーにサインインします。次に、公開するツールを選択します。フィルターオプションについては、ツールの選択を参照してください。

  6. MCPサービスを作成する をクリックします。

Use a schema-level connection for new MCPs.すでにメタストアレベルの接続がある場合は、 [メタストアレベルの接続を使用] をクリックして選択します。Marketplace のサーバーについては、MCP サーバーのインストールに従ってください。

ステップ 2: ツールをテストする​

AI Playgroundでテスト:

  1. AI Playground を開き、 ツールの有効化 ラベルが付いたモデルを選択します。
  2. [ツール] を開き、 [+ ツールの追加] をクリックして、 [MCP サーバー] を選択します。
  3. 外部MCPサーバー を選択し、次に MCP を選択してください。
  4. 読み取り専用ツールを使用するようにモデルに求めます。ツール呼び出しが実行され、予期される結果が返されることを確認します。

コマンドラインのテストについては、MCPの詳細ページの Get 起動 にある例を使用してください。呼び出しが失敗した場合は、MCPの認証とネットワーキングを参照してください。

ステップ 3:エージェントを接続する​

Use the MCP's full name, <catalog>.<schema>.<service>, in your agent's setup:

サーバー URL を必要とするクライアントでは、次を使用します:

Text
https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>

制限事項​

  • 外部MCPサーバーを登録できます。Genie、Databricks Apps、またはUnity Catalogエンティティソースを独自のMCPとして登録することはサポートされていません。Databricksが提供するMCPを使用するか、Databricks Apps上のサーバーに直接接続します。
  • CREATE MCP SERVICE などのSQLコマンドはサポートされていません。
  • Unity Catalog グローバル検索には MCP が表示されません。 MCP ページで見つけてください。

次のステップ​