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

Genie CodeをMCPサーバーに接続する

Model Context Protocol (MCP) を介してGenie Codeを外部ツールおよびデータソースに接続します。 Genie Code は、ワークスペースに追加され、使用権限を持つ任意の MCP サーバーを使用できます。

注記

MCP サーバーは Genie Code Agent モードでのみサポートされます。

MCPとは何ですか?

MCPは、 AIエージェントをツール、リソース、プロンプト、その他のコンテキスト情報に接続するオープンソース標準です。 MCP は、コンテキストをプロンプトや指示に直接埋め込むことなく、ツール、データ、ワークフローを Genie Code に公開するための標準化された方法を提供します。

MCP は、重要なコンテキストがすでに存在しているが、Genie Code などの AI エージェントからアクセスするのが難しい場合向けに設計されています。MCP は、次のようなコンテキストへの Genie Code アクセスを安全に提供する方法を提供します。

  • ドキュメント システム : チームは多くの場合、Confluence などのツールにランブックや運用ドキュメントを保存します。セクションをプロンプトにコピーする代わりに、そのコンテンツを外部の MCP サーバーを通じて一度公開し、関連するときに参照することができます。ドキュメントがすでにDatabricksに追跡検索インデックスとして存在している場合もあります。Genie Code Genieこれを使用して、関連ドキュメントをクエリすることができます。
  • ツールとサービス :プラットフォームチームは、セットアップ、検証、またはデプロイのためのAPIsやスクリプトを保守する場合があります。 MCPは、これらの機能をGenie Codeに直接提供します。
  • データソース :Databricksに既にデータがある場合は、Genie CodeをGenieスペースに接続することで、自然言語を使用してデータを分析できます。Databricksの外部に保存されているデータについては、外部MCPサーバーを介してGenie Codeに安全なアクセス権限を付与することができます。
  • カスタムアプリ :Databricks Appsを通じてホストされるカスタム機能を追加することもできます。これによりGenie Code独自のツール、ワークフロー、または個人または組織向けに特別に構築された統合に接続でき、すべてDatabricksワークスペース内で安全に管理されます。

このような場合、MCP は手動でのコピー アンド ペーストを構造化された再利用可能なアプローチに置き換え、必要なときにのみ適切なコンテキストを利用できるようにします。

使用権限があるワークスペース内の任意の MCP サーバーに Genie Code を接続できます。ワークスペース管理者は利用可能なサーバーを制御し、ユーザーは必要に応じて承認されたソースから選択できます。

Databricks の MCP サーバーの詳細と独自のサーバーの作成方法については、 「Databricks のモデル コンテキスト プロトコル (MCP)」を参照してください。

サードパーティのデータソースに接続する

備考

プレビュー

この機能はベータ版です。サードパーティのデータソースコネクタを使用するには、ワークスペース管理者が エージェント向けサードパーティコネクタの プレビューを有効にする必要があります。Databricksのプレビューを管理するを参照してください。

Genie Codeは、Google DriveやSharePointなど、一般的な企業データソース向けの組み込みコネクタを提供します。

これらのデータソースに接続することで、Genie Codeは質問に答える際にドキュメントを検索できるようになります。各ユーザーは個別に認証を行い、 OAuthユーザー間で共有されません。

サードパーティのデータソースを接続するには:

  1. ワークスペースで、 をクリックします。キラキラ光る精霊のコードアイコン。右上隅にあるGenie Codeを入力するとチャットが開きます。
  2. プロンプトバーで、新しいアイコン。プラスアイコン。
  3. 接続したいデータソースの横にある 「接続」 をクリックします。
  4. ステップを完了してサインインします。

認証が完了すると、Genie Codeは質問に答える際にあなたのドキュメントを検索できるようになります。メタストアの管理者と接続の所有者は、接続に対するユーザー権限を管理または取り消すことができます。MCPサーバー接続の共有を参照してください。

注記

データソースツールは必ずしも自動的に起動するとは限りません。ドキュメント検索が開始されない場合は、Genie Codeにツールを使用するように明示的に指示してみてください。たとえば、「Googleドキュメントを使用する」または「SharePointを使用する」などです。

他のデータソースを接続するには、Genie Codeに手動で追加してください。「Genie CodeにMCPサーバーを手動で追加する」を参照してください。

Googleドライブの制限事項

  • 最大ファイルサイズは10MBです。
  • ネイティブの Google ワークスペース ファイル (ドキュメント、スプレッドシート、スライド) のみがサポートされます。 PDF、画像、その他のバイナリ形式はサポートされていません。
  • エージェントの出力に、接続エラーまたはトークンの有効期限切れエラーが表示される場合があります。解決するには再認証してください。

SharePointの制限事項

  • 最大ファイルサイズは10MBです。
  • サポートされているファイルの種類には、Office ドキュメント (.docx、.xlsx、.pptx)また、 .txt.csv.json.mdなどの一般的なテキストベースの形式も含まれます。PDF、画像、その他のバイナリ形式はサポートされていません。

MCPサーバーをGenie Codeに手動で追加する

Genie Code を MCP サーバーに接続するには、Genie Code 設定に追加します。

  1. Genie Code の設定を開きます。Genie Codeパネルで、 歯車アイコン。設定

  2. MCPサーバー の下で、 新しいアイコン。サーバーを追加します

  3. 追加したいMCPサーバーを選択してください。Databricksが管理するMCPサーバー、または外部のMCPサーバーを選択できます。

    • Unity Catalog関数 :関数のスキーマを選択します。 これにより、Genie Codeは関数を使用して、事前に定義されたSQLクエリを実行できるようになります。

    • ベクトル検索 :インデックスのスキーマを選択します。これにより、Genie Codeはベクトル検索インデックスにクエリを実行して、関連するドキュメントを検索できるようになります。

    • Genieスペース : Genieスペースを選択します。 Genie MCPはGenieツールとして呼び出し、自然言語を使用してGenieにクエリを実行してデータを分析できるようにします。

    • 外部MCPサーバー :外部MCPサーバーとして使用するUnity Catalog接続を選択します。 接続を使用するには、まずログインする必要があります。

    • カスタムMCPサーバー :カスタムMCPサーバーとして使用するDatabricksアプリを選択します。これにより、独自に定義したツールを自由に使用できます。以下の要件が適用されます。

      • アプリは、接続しようとしているワークスペースと同じワークスペースにデプロイされている必要があります。
      • MCPサーバーにはhttps://<server-url>/mcpでアクセスする必要があります。
      • アプリはステートレスでなければなりません。例えば、 mcp_app = mcp_server.http_app(stateless_http=True)を設定します。
      • CORS エラーを実行する場合は、アプリの許可されたオリジンのリストにワークスペース URL を追加する必要がある場合があります。 例えば、 app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"])を設定します。
  4. 保存 をクリックします。

MCP サーバーは追加された後、すぐに Genie Code で利用できるようになります。プロンプトや指示を変更せずに、エージェント モードで使用を開始できます。Genie Code は、関連する場合には自動的にこれらのサーバーを利用します。

現在、MCP アクセスはすべてのサーバーにわたって 20 個のツールに制限されています。Genie Code 設定で、有効または無効にするツールとサーバーを選択できます。