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

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

Genie Code connects to external tools, documents, and data through Model Context Protocol (MCP) servers and native connectors for Google Drive, Gmail, Google Calendar, Microsoft 365, Atlassian, Glean, Slack, and GitHub.Use the native connectors for common SaaS ソース, or add your own external or custom MCP servers from the ワークスペース.You choose which tools to enable in Genie Code settings.

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 サーバーの詳細および独自のサーバーを作成する方法については、MCPs and agent tools を参照してください。

サードパーティのデータソースにはネイティブコネクタを使用する​

Genie Codeには、一般的なエンタープライズ データソース用の組み込みコネクタが用意されています：

  • Google Drive ：Googleドキュメント、スプレッドシート、スライドの検索と作成を行い、作成したドキュメントを編集します。
  • Gmail : Eメールの検索、閲覧、および下書きの作成を行います。
  • Google Calendar ：カレンダーのイベントを検索して作成します。
  • Microsoft 365 ：SharePoint、Teams、Outlook、カレンダーの検索、Outlook Eメールの下書き作成。
  • Atlassian ：Jira および Confluence の検索と更新を行います。
  • Glean (Beta): Glean を使用して組織の接続済みアプリを検索します。
  • Slack ：Slack のメッセージやチャンネルを検索し、メッセージを送信します。
  • GitHub ：コードの検索、リポジトリ、問題、およびプルリクエストの更新を行います。

これらのデータソースに接続することで、Genie Codeは質問への回答時にドキュメントを検索し、接続されたツールでアクションを実行できるようになります。各ユーザーが個別に認証を行い、OAuthトークンはユーザー間で共有されません。

These connections use Databricks-provided MCP connectors, so there's no server to host and no OAuth app to 登録する.Databricks governs every connection through Unity Catalog and Unity Gateway.The gateway authorizes each tool call against your Unity Catalog permissions, applies 組み込み ポリシー and approval requirements, and records usage and audit Logs in システムテーブル.See Register an external MCP server.

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

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

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

注記

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

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

スケジュールされたタスクと認証​

  • Genie Code は、接続の認証の有効期限が切れても警告を表示しません。ツール呼び出しが失敗したときや、接続リストを開いたときにのみ判明する場合があります。再認証を行って解決してください。
  • 接続の権限を変更するには、各ユーザーが再認証を行う必要があります。ユーザーが再認証を行うまで、その接続を使用するスケジュールされたタスクは失敗します。

Googleドライブの制限事項​

  • Googleドライブを認証する際に、「未確認アプリ」という画面が表示される場合があります。 「詳細設定」 をクリックして、認証プロセスを続行してください。
  • 最大ファイルサイズは25MBです。
  • ネイティブの Google ワークスペース ファイル (ドキュメント、スプレッドシート、スライド) のみがサポートされます。 PDF、画像、その他のバイナリ形式はサポートされていません。
  • Genie Codeは、Google ドキュメント、スプレッドシート、スライドを作成でき、コネクターを通じて作成したGoogle ドキュメントを編集できます。コネクター外で作成されたドキュメントの編集や、既存のスプレッドシートやスライドの編集はできません。
  • 非常に大きなドキュメントの読み取りは処理が遅くなる場合があります。
注記

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

Gmailの制限​

  • Genie CodeはEメールの検索、読み取り、下書き作成を行うことができますが、Eメールの送信や既存のメッセージの編集はできません。
  • Genie Codeは、DriveファイルをネイティブのGmail添付ファイルとして追加できません。回避策として、Eメール本文にファイルへのLinkを含めてください。

Microsoft 365 の制限​

  • SharePoint、Teams、Outlook、カレンダーが含まれます。
  • Genie CodeはOutlookのEメールの下書きを作成できますが、送信することはできません。
  • Maximum file size is 25 MB for SharePoint files.
  • サポートされているSharePointのファイル形式には、Officeドキュメント（.docx、.xlsx、.pptx）などが含まれます。また、.txt、.csv、.json、.mdなどの一般的なテキストベースの形式もサポートされています。PDF、画像、その他のバイナリ形式はサポートされていません。

Glean (Beta) の制限事項​

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

Slack の制限​

  • Genie Codeでは、メッセージの送信後に編集または削除することはできません。

GitHubの制限事項​

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

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 の設定で、有効または無効にするツールとサーバーを選択できます。

制限事項​

このページの見出し