Databricks提供のMCP

Databricksは、データおよび外部サービス向けに system.ai スキーマでMCPを提供します。以下からMCPを選択し、エージェントを接続します。サーバーをホストまたは登録する必要はありません。

各system.ai MCP は、Unity Gateway を通じて呼び出されるUnity Catalog で保護可能なオブジェクトです。権限を使用してそれらを呼び出すユーザーを管理し、ポリシーを使用して個々の呼び出しを管理できます。

Genie Agent MCPを含む他のワークスペース MCP endpointは、Unity Gatewayガバナンスなしで基盤となるリソースの権限を使用します。

MCPサーバーURL

system.ai MCPの場合は、このURLを使用します。

Text
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	説明
`system.ai.genie_one_mcp`	ワークスペース全体での自然言語アナリティクスにおすすめです。Genieオントロジーに基づいて、Genie Oneで質問に回答します。
`system.ai.dbsql`	呼び出し元の Unity Catalog と warehouse の権限を使用して、SQL warehouse で開発およびデータエンジニアリング向けの特定の SQL クエリーを実行します。
`system.ai.web_search`	パブリックウェブを検索し、引用付きの合成された回答を返します。
`system.ai.sandbox`	分離された環境で Python、SQL、またはシェルのコードを実行します。

MCP	説明
`system.ai.genie_one_mcp`	ワークスペース全体での自然言語アナリティクスにおすすめです。Genieオントロジーに基づいて、Genie Oneで質問に回答します。
`system.ai.dbsql`	呼び出し元の Unity Catalog と warehouse の権限を使用して、SQL warehouse で開発およびデータエンジニアリング向けの特定の SQL クエリーを実行します。
`system.ai.web_search`	パブリックウェブを検索し、引用付きの合成された回答を返します。
`system.ai.sandbox`	分離された環境で Python、SQL、またはシェルのコードを実行します。

Genie One、Genie Agent、およびDatabricks SQL MCPサーバーから選択してください

アナリティクスのユースケースでは、Genie One MCP サーバーから起動してください。Genieは、統治されたセマンティックレイヤーであるGenieオントロジーを通じて、ビジネス用語、メトリクスの定義、テーブルの関係を解決します。これは、エージェントが未加工テーブルに対して直接SQLを作成するよりも正確な回答を生成します。

MCPサーバー	ユースケース	ガバナンス
Genie One MCP (`system.ai.genie_one_mcp`)	ワークスペース全体で自然言語のビジネスの質問をします。	Unity Gatewayの権限とポリシー、および基盤となるリソースの権限。
Genie Agent MCP	テーブル、指示、例を使用して、厳選された1つのGenie Agentを対象に自然言語で質問してください。	Genie Agentおよびそのデータに対する権限。呼び出しはUnity Gatewayをバイパスします。
Databricks SQL MCP（`system.ai.dbsql`）	構文の検証やパイプラインの作成など、特定の SQL クエリーをランを実行します。	Unity Gatewayの権限とポリシー、および基盤となるリソースの権限。

MCPサーバー	ユースケース	ガバナンス
Genie One MCP (`system.ai.genie_one_mcp`)	ワークスペース全体で自然言語のビジネスの質問をします。	Unity Gatewayの権限とポリシー、および基盤となるリソースの権限。
Genie Agent MCP	テーブル、指示、例を使用して、厳選された1つのGenie Agentを対象に自然言語で質問してください。	Genie Agentおよびそのデータに対する権限。呼び出しはUnity Gatewayをバイパスします。
Databricks SQL MCP（`system.ai.dbsql`）	構文の検証やパイプラインの作成など、特定の SQL クエリーをランを実行します。	Unity Gatewayの権限とポリシー、および基盤となるリソースの権限。

External サービス

ツールからサインインを求められた場合は、MCPから返されたログインLinkを開き、プロバイダーアカウントへのアクセスを承認して、呼び出しを再試行してください。組織で承認が必要な場合は、同意画面のアプリ名を管理者に伝えてください。最初の呼び出しの前にサインインする、再度サインインする、またはサインアウトするには、プロバイダーのサインインを管理するを参照してください。

MCP	接続先：
`system.ai.slack`	Slack MCPサーバー
`system.ai.github`	GitHub MCP サーバー
`system.ai.atlassian`	Atlassian Rovo MCPサーバーを通じたJiraとConfluence
`system.ai.google_drive`	Google Drive、Docs、Sheets、および Slides APIs
`system.ai.google_calendar`	Google Calendar API
`system.ai.gmail`	Gmail API
`system.ai.microsoft_365`	Microsoft Graph を介した SharePoint、Outlook、および Teams

MCP	接続先：
`system.ai.slack`	Slack MCPサーバー
`system.ai.github`	GitHub MCP サーバー
`system.ai.atlassian`	Atlassian Rovo MCPサーバーを通じたJiraとConfluence
`system.ai.google_drive`	Google Drive、Docs、Sheets、および Slides APIs
`system.ai.google_calendar`	Google Calendar API
`system.ai.gmail`	Gmail API
`system.ai.microsoft_365`	Microsoft Graph を介した SharePoint、Outlook、および Teams

各 MCP が要求する権限については、管理対象 OAuth プロバイダーを参照してください。プロバイダーと想定される用途が、組織のコンプライアンス要件を満たしていることを確認してください。

GitHubの書き込みアクセスとプライベートリポジトリのアクセスを有効にする

defaultでは、system.ai.githubはパブリックリポジトリのみを読み取ることができます。プライベートリポジトリにアクセスしたり、ファイルをcommitしたり、課題やプルリクエストを作成したりするような変更を行うには、リポジトリの所有者またはGitHub組織の管理者が次の操作を行う必要があります。

Databricks GitHub connector appをインストールし、必要なリポジトリへのアクセス権を付与します。
組織で IP 許可リストを使用している場合は、ワークスペースのクラウドおよびリージョンに対応する Databricks Serverless アウトバウンド IP を追加します。

エージェントを接続する

ワークスペースで Unity Gateway を開き、 MCPs を選択します。system.ai.githubなどのMCP名をコピーし、セットアップガイドに従います。

サーバーURLを必要とするクライアントの場合は、上記のURLパターンを使用してください。

サインイン、権限、接続のエラーについては、MCP認証をご覧ください。

制限事項

system.ai.web_search は、HIPAA/BAAコンプライアンスが有効なワークスペースでは使用できません。これは、サポートされている米国リージョン、またはクロスGeo処理を許可するワークスペースで使用できます。
system.ai.sandbox にはネットワークエグレスがありません。
system.ai.web_search およびsystem.ai.sandboxは、コンシューマーアクセス資格のみを持つユーザーには利用できません。

Unity Gatewayの対象外のEndpoint

これらのワークスペースMCP Endpointは、Genieエージェント、テーブル、関数、インデックス、SQL Warehouseなど、基盤となるリソースの権限を使用します。

呼び出しは Unity Gateway をバイパスするため、そのトレーステーブルには表示されず、MCP レベルの付与、ポリシー、またはガードレールをサポートしません。新しい統合については、ユースケースをサポートしている場合は、Databricks データおよびツールおよび外部サービスの system.ai MCP を Databricks が推奨します。

これらのEndpointはパブリックプレビュー段階です。単一のキュレートされたエージェントをクエリーするにはGenie Agent Endpointを使用し、クライアントがそれらのリソースへのMCPアクセスを必要とする場合はAI SearchまたはFunctions Endpointを使用します。

これらのURLでは、ワークスペース管理者がワークスペースのプレビューページで マネージドMCPサーバー を有効にする必要があります。

MCP クライアントで以下の完全なサーバー URL を使用します。OAuth を使用する場合は、記載されているスコープをリクエストしてください。

サーバー	サーバーURL	OAuthスコープ
Genie Agent	`https://<workspace-hostname>/api/2.0/mcp/genie/{genie_space_id}`	`genie`
AI Search	`https://<workspace-hostname>/api/2.0/mcp/ai-search/{catalog}/{schema}/{index_name}`	`ai-search`
Databricks SQL	`https://<workspace-hostname>/api/2.0/mcp/sql`	`sql`
Unity Catalog の関数	`https://<workspace-hostname>/api/2.0/mcp/functions/{catalog}/{schema}/{function_name}`	`unity-catalog`

サーバー	サーバーURL	OAuthスコープ
Genie Agent	`https://<workspace-hostname>/api/2.0/mcp/genie/{genie_space_id}`	`genie`
AI Search	`https://<workspace-hostname>/api/2.0/mcp/ai-search/{catalog}/{schema}/{index_name}`	`ai-search`
Databricks SQL	`https://<workspace-hostname>/api/2.0/mcp/sql`	`sql`
Unity Catalog の関数	`https://<workspace-hostname>/api/2.0/mcp/functions/{catalog}/{schema}/{function_name}`	`unity-catalog`

プレースホルダーをワークスペースの値に置き換えます。

ワークスペースホスト名： ワークスペースを開き、ブラウザーのアドレスバーから、https://、パス、またはクエリーパラメーターを含めずにホスト名をコピーします。ワークスペース URL の見つけ方を参照してください。
カタログ、スキーマ、およびインデックスまたは関数名： [カタログ] を開き、インデックスまたは関数を見つけます。URL 内でフルネームの部分を使用します。たとえば、main.tools.lookup_customer は main/tools/lookup_customer になります。
Genie space ID： Genie Agentを開き、その Settings tabからスペースIDをコピーします。

Unity Gateway MCP サーバーを使用する

これらのMCPサーバーは、コーディングエージェント、デスクトップMCPクライアント、およびPythonエージェントと連携して動作します。Unity Gateway URLとai-gatewayOAuthスコープを使用します。切り替える前に、MCPのアクセス要件を確認してください。

ワークスペース MCP またはツール	UnityゲートウェイMCP	処理内容
Databricks SQL MCP（`/api/2.0/mcp/sql`）	Databricks SQL MCP（`system.ai.dbsql`）	Unity Gatewayを介してSQLをランします。
コードインタープリター (`system.ai.python_exec`)（MCP の機能を介して）	`system.ai.sandbox`（Unity Gateway ベータ版）	MCPを介してPython、SQL、またはシェルコードをランします。

ワークスペース MCP またはツール	UnityゲートウェイMCP	処理内容
Databricks SQL MCP（`/api/2.0/mcp/sql`）	Databricks SQL MCP（`system.ai.dbsql`）	Unity Gatewayを介してSQLをランします。
コードインタープリター (`system.ai.python_exec`)（MCP の機能を介して）	`system.ai.sandbox`（Unity Gateway ベータ版）	MCPを介してPython、SQL、またはシェルコードをランします。

Pythonエージェントからリソースを直接呼び出す

Pythonエージェントの場合、DatabricksはMCPなしで直接リソースを呼び出すためにこれらのライブラリを推奨します。これらのライブラリは、呼び出しをUnity Gateway経由でルーティングしません。

リソース	Pythonライブラリ	導入ガイド
AI Searchインデックス	AI Bridge レトリーバーツール	AI Searchインデックスをクエリーする。
Unity Catalog の関数	`UCFunctionToolkit`	登録済み関数を呼び出す。
Genie Agent	AI Bridge ツール	Genie Agentにクエリーする。

リソース	Pythonライブラリ	導入ガイド
AI Searchインデックス	AI Bridge レトリーバーツール	AI Searchインデックスをクエリーする。
Unity Catalog の関数	`UCFunctionToolkit`	登録済み関数を呼び出す。
Genie Agent	AI Bridge ツール	Genie Agentにクエリーする。

ワークスペースEndpointの価格

Unity Catalog機能は、サーバーレスの一般的なコンピュート価格を使用します。
Databricks SQLはDatabricks SQLの価格を使用します。
AI Searchインデックスでは、AI Searchの価格が使用されます。

MCPサーバーURL​

Databricks のデータとツール​

Genie One、Genie Agent、およびDatabricks SQL MCPサーバーから選択してください​

External サービス​

GitHubの書き込みアクセスとプライベートリポジトリのアクセスを有効にする​

エージェントを接続する​

制限事項​

Unity Gatewayの対象外のEndpoint​

Unity Gateway MCP サーバーを使用する​

Pythonエージェントからリソースを直接呼び出す​

ワークスペースEndpointの価格​