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

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

MCP とは

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

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

  • ドキュメント システム: Teams は、多くの場合、Confluence などのツールで Runbook や運用ドキュメントを保持します。 セクションをプロンプトにコピーする代わりに、そのコンテンツを外部 MCP サーバー経由で 1 回公開し、関連する場合に参照することができます。 ドキュメントは、関連するドキュメントのクエリに Genie Code が使用できる AI 検索インデックスとして Databricks に既にある場合もあります。
  • ツールとサービス: プラットフォーム チームは、セットアップ、検証、またはデプロイ用の API またはスクリプトを維持する場合があります。 MCP を使用すると、これらの機能を Genie Code で直接使用できます。
  • データ ソース: Databricks に既にデータがある場合は、Genie Code を Genie エージェントに接続して、自然言語を使用してデータを分析できます。 Databricks の外部に格納されているデータの場合は、外部 MCP サーバー経由で Genie Code に安全なアクセス権を付与できます。
  • カスタム アプリ: Databricks Apps でホストされるカスタム機能を追加することもできます。 これにより、Genie Code を、自分または組織専用に構築された独自のツール、ワークフロー、または統合に接続でき、すべて Databricks ワークスペース内で安全に管理されます。

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

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

DatabricksのMCPサーバーや自作の方法について詳しく知りたい方は、 MCPとエージェントツールをご覧ください。

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

Genie Codeは一般的な企業データソース向けの組み込みコネクタを提供しています:

  • Googleドライブ:Googleドキュメント、スプレッド、スライドを検索して作成します。作成したドキュメントを編集します。
  • Gmail:メールを検索し、読んで、下書きします。
  • Googleカレンダー:カレンダーイベントを検索して作成できます。
  • Microsoft 365:SharePoint、Teams、Outlook、カレンダーを検索;Outlookメールを作成してください。
  • Atlassian:JiraとConfluenceを検索して更新してください。
  • Glean (ベータ):Gleanを使って組織内の接続アプリ全体を検索しましょう。
  • Slack:Slackのメッセージやチャンネルを検索し、メッセージを送信します。
  • GitHub:リポジトリ、イシュー、プルリクエストの検索と更新が可能です。

これらのデータソースに接続することで、Genie Codeはあなたの文書を検索し、接続されたツールで質問に答える際にアクションを行うことができます。 各ユーザーは個別に認証され、OAuth トークンはユーザー間で共有されません。

これらの接続はDatabricksが提供するMCPコネクタを使っているため、サーバーをホストしたりOAuthアプリを登録したりする必要はありません。 Azure DatabricksはUnity CatalogとUnity Gatewayを通じてすべての接続を管理しています。 ゲートウェイはUnity Catalogの権限に対して各ツール呼び出しを承認し、組み込みのポリシーや承認要件を適用し、使用および監査ログをシステムテーブルに記録します。 「 外部MCPサーバーを登録する」を参照してください。

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

  1. ワークスペースで、 スパークル genie コード アイコンをクリックします。 右上隅の Genie Code でチャットを開きます。
  2. プロンプト バーで、[新規] アイコン をクリックします。プラスアイコン。
  3. 接続するデータ ソースの横にある [ 接続] をクリックします。
  4. サインインする手順を完了します。

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

注

データ ソース ツールは、常に自動的にトリガーされるとは限りません。 ドキュメント検索が開始されない場合は、"Google Docs の使用" や "SharePointの使用" などのツールの使用を Genie Code に明示的に求めてみます。

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

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

  • Genie Codeは接続の認証が切れても警告しません。 ツール呼び出しが失敗したり、接続リストを開いたときにだけ分かるかもしれません。 解決するために再認証します。
  • 接続の権限を変更するには、各ユーザーが再認証する必要があります。 接続を利用するスケジュールタスクは、ユーザーが再認証するまで失敗します。

Google ドライブの制限事項

  • Google ドライブを承認すると、"未確認のアプリ" 画面が表示されることがあります。 [ 詳細設定 ] をクリックし、承認プロセスを続行します。
  • 最大ファイル サイズは 25 MB です。
  • ネイティブの Google Workspace ファイル (Docs、スプレッドシート、スライド) のみがサポートされています。 PDF、画像、およびその他のバイナリ形式はサポートされていません。
  • Genie CodeはGoogleドキュメント、スプレッドシート、スライドを作成し、コネクタを通じて作成したGoogleドキュメントを編集できます。 コネクター外で作成されたドキュメントや、既存のスシートやスライドの編集はできません。
  • 非常に大きな文書を読むのは遅くなることがあります。

注

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

Gmailの制限

  • Genie Codeはメールの検索、閲覧、下書きはできますが、メール送信や既存メッセージの編集はできません。
  • Genie CodeはDriveファイルをネイティブのGmail添付ファイルとして追加できません。 回避策として、メール本文にファイルへのリンクを記載してください。

Microsoft 365の制限

  • SharePoint、Teams、Outlook、予定表が含まれます。
  • Genie CodeはOutlookのメールを下書きできますが、送信はできません。
  • SharePointファイルの最大ファイルサイズは25MBです。
  • サポートされているSharePointファイル形式には、Officeドキュメント(.docx、.xlsx、.pptx)や、.txt、.csv、.json、.mdなどの一般的なテキストベースのフォーマットが含まれます。 PDF、画像、およびその他のバイナリ形式はサポートされていません。

Glean(ベータ)の制限

  • Gleanは検索専用です。 直接リンクから文書を読み取ることができません。
  • メタストア管理者は、非管理者が接続を利用できるようにする前に、まずGleanのテナントIDを設定する必要があります。 管理者は、最初に Glean に接続するときにテナント ID を入力できます。
  • 特定の Glean MCPサーバーに接続するために、メタストア管理者は接続設定時にMCPサーバーパス(例: /mcp/eng)を設定できます。 このフィールドは空欄のままにしてデフォルトのパス(/mcp/default)を使います。 管理者でないユーザーはGlean MCPサーバーパスを指定または変更することはできません。

Slack の制限

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

GitHubの制限事項

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

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

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

  1. Genie Code の設定を開きます。 Genie Code ペインで、 歯車アイコン をクリックします。設定。
  2. [MCP サーバー] の [新規] アイコンをクリックします。サーバーを追加します。
  3. 追加する MCP サーバーを選択します。 Databricks マネージド MCP サーバーまたは外部 MCP サーバーを選択できます。
    • Unity カタログ関数: 関数のスキーマを選択します。 これにより、Genie Code は関数を使用して定義済みの SQL クエリを実行できます。
      • カスタム GitHub MCP サーバーの作成については、Genie Code を使用した Search GitHub コードを参照してください。
    • AI 検索: インデックスのスキーマを選択します。 これにより、Genie Code は AI Search インデックスに対してクエリを実行して、関連するドキュメントを検索できます。
    • Genie エージェント: Genie エージェントを選択します。 Genie MCP は Genie をツールとして呼び出し、Genie エージェントにクエリを実行して自然言語を使用してデータを分析できるようにします。
    • 外部 MCP サーバー: 外部 MCP サーバーとして使用する Unity カタログ接続を選択します。 接続を使用するには、まず接続にログインする必要があります。
    • カスタム 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 の設定で有効または無効にするツールとサーバーを選択できます。

制限事項

接続アプリケーションに関するコンプライアンスガイダンスについては、 Databricksが提供するMCPサービスの制限を参照してください。

  • 外部 MCP サーバーは、モデル サービスがサポートされているリージョンでのみ使用できます。 モデル提供機能の可用性を参照してください。
  • Last updated on