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

Genie One MCPサーバー

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

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

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

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

ヒント

アナリティクスを1つのキュレーションされたGenie Agentにスコープするには、Genie Agent MCPサーバーを使用します。

Unity Gateway経由でのアクセス​

Genie One MCP サーバーは、Databricks が提供する MCP サービス（system.ai.genie_one_mcp）であり、Unity Gateway を介して管理されます。Unity Catalog の権限によって呼び出し可能なユーザーが制御され、サービスポリシーによって個々のツール呼び出しの許可または拒否が制御されます。また、すべての呼び出しが使用量と監査のために記録されます。

パスに完全修飾されたUnity Catalog名を含め、Unity Gateway URLでサービスを呼び出します。

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

アカウントユーザーはデフォルトで system.ai に対して EXECUTE を保持しているため、通常は追加の権限付与は必要ありません。ユーザーの代理としての認証で接続する場合は、ai-gateway OAuth スコープを含めてください。サービスを呼び出すことができるユーザーとそれが公開するツールを管理し、サービスポリシーを適用する方法については、MCP サービスの管理を参照してください。サービスをエージェントに追加するには、カスタムエージェントでの MCP サーバーの使用を参照してください。Cursor や Claude Desktop などの外部クライアントを接続するには、MCP を AI アシスタントおよびコーディングエージェントに接続するを参照してください。

注記

Genie One MCP サービスの以前のバージョンは非推奨になりました

新しい 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 Serviceポリシーでアクセスをガバナンスするには、Unity Gatewayでsystem.ai.genie_one_mcp MCP Serviceを使用します。

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

Claude、Claude Code、ChatGPT、CursorなどのMCPクライアントからGenie Oneを使用するには、クライアントを上記のMCPサービスURLに向け、OAuthを使用して認証します。クライアントごとのステップバイステップのセットアップについては、OAuthの例を参照してください。

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 で warehouse_id _meta パラメーター を渡します。
  • 価格 : Genie One MCPサーバーは Genie Oneでのチャットを使用します。Genieの価格を参照してください。

その他のリソース​

このページの見出し