メインコンテンツまでスキップ
に最終更新

Genie One MCPサーバー

Genie One MCP サーバーは、Databricks が提供するMCPであり、 Genie One でのチャット を活用して、Model Context Protocol (MCP) を介して Genie を会話型ツールとして公開します。MCP クライアントまたはエージェントが自然言語の質問を送信すると、Genie がエンタープライズデータを検索し、SQL を記述して、引用された Databricks ソースへのディープリンクとともに Genie オントロジーに基づく回答を返します。

MCP クライアントまたはエージェントを接続して、Genie の信頼できる知見に基づいてデータに関する質問を行えるようにします。MCP Apps をサポートするクライアントは、Genie の進捗状況、視覚化、結果をインラインで表示するインタラクティブな View をレンダリングできます。

Unity Catalogのアクセス許可は常に適用されるため、ユーザーとエージェントはアクセスを許可されたデータのみをクエリーできます。

ワークスペース全体のアナリティクスにこのサーバーを使用します。自然言語で質問されるビジネス上の問いに対し、データの意味を理解することで正確な回答を提供します。Genieは、管理されたセマンティックレイヤーであるGenie Ontologyを通じて、ビジネス用語、メトリクス定義、およびテーブル関係を解決します。これにより、エージェントが生のテーブルに対して直接SQLを記述するよりも正確な回答が得られます。

ヒント

Pythonから厳選された1つのGenie Agentにクエリーを実行するには、AI Bridgeツールの例を使用します。MCP経由で特定のエージェントにクエリーを実行する方法については、Genie Agent MCPサーバーを参照してください。

Unity Gateway経由でのアクセス​

Genie One MCP サーバーは、Databricks が提供する MCP であり、system.ai.genie_one_mcp、Unity Gateway を通じて管理されます。

Unity Gateway URLでMCPを呼び出します。パスには、完全修飾Unity Catalog名を指定します。

Text
https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.genie_one_mcp

on-behalf-of ユーザー認証を使用して接続する場合は、ai-gateway OAuth スコープを含めます。アクセスを制御し、ポリシーを適用するには、Govern an MCP を参照してください。エージェントに MCP を追加するには、Python エージェントでの MCP ツールの使用を参照してください。Cursor や Claude Desktop などの外部クライアントを接続するには、サポートされているコーディングエージェントをご覧ください。

注記

新しいGenie One MCPであるsystem.ai.genie_one_mcpが一般公開されました。以前のベータEndpointであるhttps://<workspace-hostname>/api/2.0/mcp/genieは非推奨となり、2026年10月31日に廃止されます。それまでにすべてのワークロードをMCPに移行してください。非推奨のEndpointは、genie OAuthスコープを使用します。MCPポリシーでアクセスをガバナンスするには、Unity Gatewayでsystem.ai.genie_one_mcp MCPを使用します。

Claude や ChatGPT などのクライアントを接続する​

クライアントを上記のMCP URLに向け、OAuthで認証します。コーディングエージェントまたはClaudeやChatGPTなどのその他のMCPクライアントのセットアップに従ってください。

MCPとそのURLを表示するには、ワークスペースに移動し、 Unity Gateway > MCPs を選択します。

利用可能なツール​

Genie One MCPサーバーは、以下のツールを公開します。実際には、エージェントは genie_ask (またはMCP Appsクライアント上の view_ask) を呼び出して質問を行います。エージェントは、回答を作成する過程で、残りのツールをユーザーの代わりに管理します。

ツール

説明

genie_ask

Genieに自然言語でデータに関する質問をして、回答を起動します。conversation_id、response_id、およびstatusを返します。以前の会話を続けるには、conversation_idを渡します。

genie_poll_response

進行中または完了した応答の最新状態を取得します。これには、進捗ステップ、最終的な回答、および Databricks ソースへのディープLinkが含まれます。

genie_get_query_result

Genieがランしたクエリーについて、列スキーマと行を含む完全なSQL結果を取得します。

genie_cancel_response

実行中の Genie ターンのキャンセルをリクエストします。

view_ask

Genie に質問して、インタラクティブなビューを開きます。MCP Apps クライアントに対して genie_ask の代わりとして提供され、利用可能な場合はこちらが推奨されます。

ツール

説明

genie_ask

Genieに自然言語でデータに関する質問をして、回答を起動します。conversation_id、response_id、およびstatusを返します。以前の会話を続けるには、conversation_idを渡します。

genie_poll_response

進行中または完了した応答の最新状態を取得します。これには、進捗ステップ、最終的な回答、および Databricks ソースへのディープLinkが含まれます。

genie_get_query_result

Genieがランしたクエリーについて、列スキーマと行を含む完全なSQL結果を取得します。

genie_cancel_response

実行中の Genie ターンのキャンセルをリクエストします。

view_ask

Genie に質問して、インタラクティブなビューを開きます。MCP Apps クライアントに対して genie_ask の代わりとして提供され、利用可能な場合はこちらが推奨されます。

質問を入力​

Genie はデータを検索して SQL をランするエージェントをランするため、回答は非同期になります。あなた（またはエージェント）が質問を伴って genie_ask を呼び出すと、エージェントがその後のやり取りを自動的に管理します。一般的なフローは次のようになります。

  1. genie_ask 応答を起動し、conversation_id および response_id を status: in_progress とともに返します。Genieはバックグラウンドで動作し続けます。
  2. エージェントは応答が完了するまで genie_poll_response をポーリングし、その過程で progress_steps と narration_instruction を表示して状況を通知します。
  3. status が completed (または incomplete / failed) の場合、エージェントはレンダリングされた回答を返します。これには、完全な会話への Explore in Databricks ディープLinkと、Genie が生成した視覚化が含まれます。

同じ会話を続けるために、フォローアップの質問では以前の conversation_id を再利用します。

MCPアプリ​

Genie One MCPサーバーは、サーバーがプレーンテキストの代わりにインタラクティブなビューを返せるようにする拡張機能である MCP App を提供します。MCPアプリをサポートするクライアントでは、サーバーはインタラクティブな View を返します。これは、テキストのみの返信ではなく、会話の進行に合わせてGenieの進捗状況、可視化、最終的な回答を表示するクライアント埋め込み型のパネルです。

Claude Desktop 内で棒グラフ、サマリーメトリクス、および Genie Ontology の引用を表示する Genie One MCP アプリ。

Claude Desktop 内で棒グラフ、サマリーメトリクス、および Genie Ontology の引用を表示する Genie One MCP アプリ。

追加のセットアップは不要です。MCPアプリをサポートするクライアントは、自動的にインタラクティブなビューを取得します。テキスト結果の受信を継続しないクライアント。

考慮事項​

  • 権限 : Unity Catalog の権限はすべてのリクエストで適用されるため、結果はユーザーがアクセスできる範囲に限定されます。
  • ユーザー認証 : データガバナンスのベストプラクティスに従い、Genie ソースへのスムーズなクリックスルーを可能にする ユーザーの代理の OAuth 認証 が推奨されます。プログラムおよび自動化されたワークロードでは、Service Principal による認証もサポートされています。
  • 構成 : サーバーは、Databricks 内の Genie One 構成を尊重します。そこで Genie の動作を調整および構成します。Chat in Genie One を参照してください。
  • ポーリング間隔 : 前の genie_poll_response 呼び出しが完了するのを待ってから、再度ポーリングします。
  • 結果サイズ ：モデルのコンテキストウィンドウを保護するため、genie_ask および genie_poll_response は切り捨てられたクエリー結果を返します。エージェントが完全な結果を必要とする場合、genie_get_query_result を呼び出して完全なスキーマと行を取得できます。非常に大きな結果には依然としてサイズ制限が適用されます。制限を超えた場合、応答は切り捨てられます。
  • SQL Warehouse ：特定のSQL Warehouseでクエリーをランするには、genie_askまたはview_askの_metaパラメーターでwarehouse_idを渡します。
  • 価格 : Genie One MCPサーバーは Genie Oneでのチャットを使用します。Genieの価格を参照してください。

その他のリソース​

このページの見出し