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

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

Genie Codeは、Model Context Protocol (MCP) サーバーと、Google Drive、SharePoint、GitHub、Glean、Atlassian、Slack向けのネイティブ コネクタを通じて、外部ツール、ドキュメント、データに接続します。一般的な SaaS ソースにはネイティブ コネクタを使用するか、ワークスペースから独自の外部 MCP サーバーまたはカスタム MCP サーバーを追加します。Genie Codeの設定で、有効にするツールを選択します。

MCPとは何ですか?

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

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

  • ドキュメントシステム :チームは、多くの場合、Confluence のようなツールでランブックや運用ドキュメントを保持しています。セクションをプロンプトにコピーするのではなく、そのコンテンツは外部MCPサーバー経由で一度公開され、関連する場合に参照されます。お客様のドキュメントは、AI Searchインデックスとして既にDatabricksに格納されている可能性があり、Genie Codeはこれを使用して関連ドキュメントをクエリできます。
  • ツールとサービス :プラットフォームチームは、セットアップ、検証、またはデプロイのために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、GitHub、Glean、Atlassian、Slack など、一般的なエンタープライズデータソース用の組み込みコネクタを提供しています。

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

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

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

認証後、Genie Codeは質問に回答する際にドキュメントを検索できます。メタストア管理者および接続所有者は、接続に対するユーザー権限を管理または取り消すことができます。ステップ4. チームメイトへのアクセスを許可するを参照してください。

注記

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

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

Googleドライブの制限事項

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

Google Workspace APIから受け取った生のまたは派生したユーザーデータの使用および転送は、制限付き使用要件を含むGoogle APIサービスユーザーデータポリシーに準拠します。

SharePointの制限事項

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

GitHubの制限事項

  • defaultでは、Databricks GitHub MCPコネクタはパブリックリポジトリのみにアクセスできます。コネクタにプライベートエンタープライズリポジトリへの読み取りアクセスを許可するには、GitHub組織管理者が追加のセットアップを完了する必要があります。プライベートリポジトリアクセスを有効にするを参照してください。
  • GitHub Enterprise Server(GitHubのセルフホスト型バージョン)はサポートされていません。

制限事項を収集する

  • 管理者以外のユーザーが接続を使用できるようにするには、まずメタストア管理者がGleanテナントIDを設定する必要があります。管理者は、Gleanに初めて接続する際にテナントIDを入力できます。
  • 特定の Glean MCPサーバー に接続するには、メタストア管理者が接続設定時にオプションでMCPサーバーパス(例: /mcp/eng)を設定できます。defaultのパス(/mcp/default)を使用する場合は、このフィールドを空白のままにします。管理者以外のユーザーは、Glean MCPサーバーのパスを指定または変更することはできません。

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クエリを実行できるようになります。

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

    • 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は、関連する場合にこれらのサーバーを自動的に利用します。

Genie Code の設定で、有効または無効にするツールとサーバーを選択できます。

制限事項