メインコンテンツまでスキップ

Genie Agent MCPサーバー

Genie Agent MCPサーバーを使用すると、エージェントはSQLを記述せずに、自然言語で単一のGenie Agentにクエリーを実行できます。エージェントは自然言語の質問を送信し、Genieはそのエージェントのテーブルに対してSQLを作成して実行し、結果を返します。すべてのリクエストでUnity Catalogの権限が適用されます。

ヒント

MCPを使用せずにPythonからGenie Agentにクエリーを実行するには、AI Bridgeツールの例を使用します。ワークスペース全体のビジネス上の質問には、Genie One MCP(system.ai.genie_one_mcp)を使用します。

Genie Agentは、最大50個のUnity Catalogのテーブル、ビュー、またはメトリクスビューのコレクションであり、Genieがコンテキスト内に保持するため、サーバーはワークスペース全体ではなく、そのキュレーションされたデータに限定されます。

URL パターン

OAuthスコープ

https://<workspace-hostname>/api/2.0/mcp/genie/{genie_space_id}

genie

URL パターン

OAuthスコープ

https://<workspace-hostname>/api/2.0/mcp/genie/{genie_space_id}

genie

Genie space IDを確認するには、Genie Agentを開き、その 設定 tabからspace IDをコピーします。

このEndpointへの呼び出しはUnity Gatewayを経由しないため、アクセスはGenie Agentとその基盤となるデータに対する権限によって制御されます。

Genie Agent MCPの呼び出しには、Databricks SQLの価格が適用されます。

前提条件​

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

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

エージェントをGenie Agent MCPサーバーに接続するには、Genie Agentを作成し、アクセスが必要なユーザーまたはService Principalと共有して、そのスペース用の事前設定済みMCP URLをエージェントの接続先として指定します。上記のURLをserver_urlに設定して、PythonエージェントでMCPツールを使用するの手順に従います。

CursorやClaude Desktopなどの外部クライアントを接続するには、サポートされているコーディングエージェントを参照してください。

制限事項​

  • 読み取り専用。 Genie Agent MCPサーバーはデータをクエリーしますが、テーブルへの書き込みは行いません。
  • 会話履歴はありません。 サーバーはGenieをツールとして呼び出すため、会話履歴をGenie APIに渡しません。Python から会話を続けるには、AI Bridge を使用します。