外部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: サーバーを登録する
-
ワークスペースで Unity Gateway を開き、 MCPs を選択して、 + MCP をクリックします。
-
既存のMCPサーバーに接続 を選択します。
-
カタログとスキーマを選択し、MCP 名を入力します。名前は作成後に変更することはできません。
-
既存の HTTP 接続を選択するか、 新しい接続を作成 をクリックします。
- MCPサーバーURLを入力します。
- 認証方法を選択し、プロバイダーの資格情報を入力します。サポートされているプロバイダーの場合は、マネージド OAuth を使用します。
- 独自のリダイレクト URL で OAuth を使用する場合は、アプリの許可されたリダイレクト URL に
https://<workspace-hostname>/login/oauth/http.htmlを追加します。プロバイダーによっては、これがないとサインインが拒否される場合があります。各認証方法のフィールドについては、外部サービスへの接続を作成するを参照してください。 - Create & load tools をクリックして接続を保存し、そのツールを検出します。
-
[ツール] で、プロンプトが表示されたら [ログイン] をクリックし、プロバイダーにサインインします。次に、公開するツールを選択します。フィルターオプションについては、ツールの選択を参照してください。
-
MCPサービスを作成する をクリックします。
Use a schema-level connection for new MCPs.すでにメタストアレベルの接続がある場合は、 [メタストアレベルの接続を使用] をクリックして選択します。Marketplace のサーバーについては、MCP サーバーのインストールに従ってください。
ステップ 2: ツールをテストする
AI Playgroundでテスト:
- AI Playground を開き、 ツールの有効化 ラベルが付いたモデルを選択します。
- [ツール] を開き、 [+ ツールの追加] をクリックして、 [MCP サーバー] を選択します。
- 外部MCPサーバー を選択し、次に MCP を選択してください。
- 読み取り専用ツールを使用するようにモデルに求めます。ツール呼び出しが実行され、予期される結果が返されることを確認します。
コマンドラインのテストについては、MCPの詳細ページの Get 起動 にある例を使用してください。呼び出しが失敗した場合は、MCPの認証とネットワーキングを参照してください。
ステップ 3:エージェントを接続する
Use the MCP's full name, <catalog>.<schema>.<service>, in your agent's setup:
サーバー URL を必要とするクライアントでは、次を使用します:
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 ページで見つけてください。