Databricks提供のMCP
Databricksは、データおよび外部サービス向けに system.ai スキーマでMCPを提供します。以下からMCPを選択し、エージェントを接続します。サーバーをホストまたは登録する必要はありません。
各 MCP は、Unity Gateway を介して呼び出されるUnity Catalog のセキュリティ保護可能なオブジェクト です。グラントを使用して呼び出し元を管理し、ポリシーを使用して個々の呼び出しを管理できます。
MCPサーバーURL
system.ai MCPの場合は、このURLを使用します。
https://<workspace-hostname>/ai-gateway/mcp-services/<mcp-name>
<workspace-hostname> をワークスペースのホスト名に、<mcp-name> を下のテーブルにある完全名（system.ai.dbsqlなど）に置き換えます。
Databricks のデータとツール
Unity AIゲートウェイ ベータ版
system.ai.dbsql、system.ai.sandbox、または system.ai.web_search を使用するには、アカウント管理者がアカウント コンソールの Previews ページから Unity Gateway ベータ版を有効にする必要があります。アカウントプレビューの管理を参照してください。
Genie One MCP が一般公開されました。
MCP | 説明 |
|---|---|
ワークスペース全体での自然言語アナリティクスにおすすめです。Genieオントロジーに基づいて、Genie Oneで質問に回答します。 | |
呼び出し元の Unity Catalog と warehouse の権限を使用して、SQL warehouse で開発およびデータエンジニアリング向けの特定の SQL クエリーを実行します。 | |
パブリックウェブを検索し、引用付きの合成された回答を返します。 | |
分離された環境で Python、SQL、またはシェルのコードを実行します。 |
Genie One MCPとDatabricks SQL MCPサーバーの比較
アナリティクス ユースケースの場合は、Genie One MCP サーバーから起動します。Genie は、管理されたセマンティックレイヤーである Genie オントロジーを通じて、ビジネス用語、メトリクス定義、およびテーブルの関係性を解決します。これにより、エージェントが未加工テーブルに対して直接 SQL を記述する場合よりも、正確性の高い回答が得られます。
構文の検証やパイプラインの作成など、すでに記述した特定のクエリーを実行する必要がある場合は、Databricks SQL MCP serverを使用します。
External サービス
ツールからサインインを求められた場合は、MCPから返されたログインLinkを開き、プロバイダーアカウントへのアクセスを承認して、呼び出しを再試行してください。組織で承認が必要な場合は、同意画面に表示されるアプリ名を管理者に伝えてください。
MCP | 接続先： |
|---|---|
| |
| |
| Atlassian Rovo MCPサーバーを通じたJiraとConfluence |
| |
| |
| |
| Microsoft Graph を介した SharePoint、Outlook、および Teams |
各 MCP が要求する権限については、管理対象 OAuth プロバイダーを参照してください。プロバイダーと想定される用途が、組織のコンプライアンス要件を満たしていることを確認してください。
GitHubのプライベートリポジトリ
defaultでは、system.ai.github はパブリック リポジトリのみにアクセスできます。GitHub 組織の管理者は次の操作を行う必要があります：
-
Databricks GitHub connector appをインストールし、必要なリポジトリへのアクセス権を付与します。
-
組織で IP 許可リストを使用している場合は、ワークスペースのクラウドおよびリージョンに対応する Databricks Serverless アウトバウンド IP を追加します。
エージェントを接続する
ワークスペースで Unity Gateway を開き、 MCPs を選択します。system.ai.githubなどのMCP名をコピーし、セットアップガイドに従います。
サーバーURLを必要とするクライアントの場合は、上記のURLパターンを使用してください。
サインイン、権限、接続のエラーについては、MCP authentication and networking を参照してください。
制限事項
-
system.ai.web_searchは、HIPAA/BAAコンプライアンスが有効なワークスペースでは使用できません。これは、サポートされている米国リージョン、またはクロスGeo処理を許可するワークスペースで使用できます。 -
system.ai.sandboxにはネットワークエグレスがありません。
レガシーワークスペースEndpoint
既存の統合では、これらのワークスペースEndpointを引き続き使用できます。新しい Genie One および Databricks SQL 接続については、上記にリストされている system.ai MCP を使用してください。
従来のワークスペース Endpointは Unity Gateway をバイパスします。それらの呼び出しは Unity Gateway のトレース テーブルには表示されず、MCP レベルの Unity Catalog の権限付与、ポリシー、またはガードレールはサポートされません。アクセスは、テーブル、関数、インデックス、SQLウェアハウスなどの基盤となるリソースに対する権限によって制御されます。
これらのレガシーURLの場合、ワークスペース管理者がワークスペースのプレビューページ で Managed MCP Servers を有効にする必要があります。各サーバーのリリースステータスについては、各サーバーのページを参照してください。
MCP クライアントで以下の完全なサーバー URL を使用します。OAuth を使用する場合は、記載されているスコープをリクエストしてください。
サーバー | サーバーURL | OAuthスコープ |
|---|---|---|
|
| |
|
| |
|
| |
|
|
プレースホルダーをワークスペースの値に置き換えます。
- ワークスペース ホスト名： ワークスペースを開き、ブラウザーのアドレスバーから、
https://、パス、またはクエリーパラメーターを含めずにホスト名をコピーします。ワークスペース URL の見つけ方を参照してください。 - Genie space ID： Genie Agentを開き、その Settings tabからスペースIDをコピーします。
- カタログ、スキーマ、およびインデックスまたは関数名： [カタログ] を開き、インデックスまたは関数を見つけます。URL 内でフルネームの部分を使用します。たとえば、
main.tools.lookup_customerはmain/tools/lookup_customerになります。
新規エージェントの推奨パス
以下のSDKおよびツールキットのオプションは、Pythonエージェント向けです。コーディングエージェントのネイティブツールには、MCP接続を使用します。
レガシー MCP またはツール | 推奨されるアプローチ | 処理内容 |
|---|---|---|
Pythonから同じキュレーション済みのGenie Agentに対してクエリーを実行します。より広範なアナリティクスには、Genie One MCPを使用します。 | ||
Unity Gatewayを介してSQLをランします。 | ||
Pythonから直接AI Searchインデックスをクエリーします。 | ||
Pythonから登録済み関数を直接呼び出します。 | ||
コードインタープリター ( |
| MCPを介してPython、SQL、またはシェルコードをランします。 |
system.ai MCPの場合は、Unity Gateway URLとai-gateway OAuthスコープを使用してください。切り替える前に、MCPのアクセス要件を確認してください。
ワークスペースEndpointの価格
- Unity Catalog機能は、サーバーレスの一般的なコンピュート価格を使用します。
- GenieエージェントとDatabricks SQLでは、Databricks SQLの価格が適用されます。
- AI Searchインデックスでは、AI Searchの価格が使用されます。