Genie CodeをMCPサーバーに接続する
Genie Codeは、Model Context Protocol (MCP) サーバー、およびGoogleドライブ、Gmail、Googleカレンダー、Microsoft 365、Atlassian、Glean、Slack、GitHub用のDatabricks提供の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 サーバーの詳細や独自サーバーの作成方法については、MCP を参照してください。
サードパーティソースに Databricks が提供する MCP コネクタを使用する
Genie Codeは、一般的なサードパーティソース向けにDatabricks提供のMCPコネクタを提供します。
- Google Drive :Googleドキュメント、スプレッドシート、スライドの検索と作成を行い、作成したドキュメントを編集します。
- Gmail : Eメールの検索、閲覧、および下書きの作成を行います。
- Google Calendar :カレンダーのイベントを検索して作成します。
- Microsoft 365 :SharePoint、Teams、Outlook、カレンダーの検索、Outlook Eメールの下書き作成。
- Atlassian :Jira および Confluence の検索と更新を行います。
- Asana : タスク、プロジェクト、ポートフォリオ、ユーザー、チームを検索し、書き込みアクションが許可されている場合にタスクの作成または更新を行います。
- Glean (Beta): Glean を使用して組織の接続済みアプリを検索します。
- Slack :Slack のメッセージやチャンネルを検索し、メッセージを送信します。
- GitHub :コードの検索、リポジトリ、問題、およびプルリクエストの更新を行います。
これらのデータソースに接続することで、Genie Codeは質問への回答時にドキュメントを検索し、接続されたツールでアクションを実行できるようになります。各ユーザーが個別に認証を行い、OAuthトークンはユーザー間で共有されません。
これらの接続はDatabricksが提供するMCPコネクタを使用するため、ホストするサーバーや登録するOAuthアプリはありません。Databricksは、Unity CatalogおよびUnity Gatewayを通じてこれらの接続をガバナンスします。ただし、Glean (Beta) はゲートウェイを経由しません。ゲートウェイは、各ツール呼び出しを Unity Catalog 権限に対して承認し、組み込みポリシーと承認要件を適用し、使用状況と監査 Logs をシステムテーブルに記録します。外部MCPサーバーを参照してください。
サードパーティのデータソースを接続するには:
-
ワークスペースで、 をクリックします。
右上隅にあるGenie Codeを入力するとチャットが開きます。
-
プロンプトバーで、
プラスアイコン。
-
接続したいデータソースの横にある 「接続」 をクリックします。
-
ステップを完了してサインインします。
組織がサインインをブロックしている場合は、「コネクターの管理者承認を取得する」を参照してください。
認証すると、Genie Codeは質問への回答時にドキュメントを検索できます。メタストア管理者と接続所有者は、接続に対するユーザー権限を管理または取り消すことができます。接続に対するアクセス許可の付与と取り消しを参照してください。
データソースツールは必ずしも自動的に起動するとは限りません。ドキュメント検索が開始されない場合は、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コネクタはパブリックリポジトリにのみアクセスできます。プライベートリポジトリにアクセスしたり、ファイルのcommitや課題やプルリクエストの作成などの変更を行うには、リポジトリの所有者または GitHub 組織の管理者が追加の設定を行う必要があります。GitHubの書き込みアクセスとプライベートリポジトリへのアクセスを有効にするを参照してください。
- GitHub Enterprise Server(GitHubのセルフホスト型バージョン)はサポートされていません。
コネクタの管理者承認を取得する
ユーザーがコネクタにサインインするには、組織の Slack、Google ワークスペース、Microsoft 365、または GitHub の管理者がコネクタを承認する必要がある場合があります。各プロバイダーの管理者に共有するための承認ステップについては、「コネクタの管理者承認を取得する」をご覧ください。
MCPサーバーをGenie Codeに手動で追加する
Genie Code を MCP サーバーに接続するには、Genie Code 設定に追加します。
-
Genie Code設定を開きます。Genie Codeペインで、
設定 をクリックします。
-
MCPサーバー の下で、
サーバーを追加します 。
-
追加したいMCPサーバーを選択してください。Databricksが管理するMCPサーバー、または外部のMCPサーバーを選択できます。
-
UC MCP Service : Select a UC MCP Service からサービスを選択します。Unity Catalogに登録された外部サーバーのMCPサービスを使用します。外部MCPサーバーを参照してください。
- ユーザーごとの OAuth については、使用する前に サービスにサインインしてください。
- カスタム GitHub MCP サーバーの作成に関するヘルプについては、「Genie Code で GitHub コードを検索」を参照してください。
-
Unity Catalog関数 :関数のスキーマを選択します。 これにより、Genie Codeは関数を使用して、事前に定義されたSQLクエリを実行できるようになります。
-
AI検索 : インデックスのスキーマを選択します。これにより、Genie Code は AI Search インデックスにクエリを実行して、関連するドキュメントを見つけることができます。
-
Genieエージェント : Genieエージェントを選択します。Genie MCPはツールとしてGenieを呼び出し、Genieエージェントにクエリを実行して自然言語を使用してデータを分析できます。
-
カスタム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= ["*"])を設定します。
-
-
保存 をクリックします。
追加後、MCPサーバーはGenie Codeですぐに利用可能になります。プロンプトや指示を変更することなく、使用を開始できます。Genie Codeは、関連する場合にこれらのサーバーを自動的に利用します。
Genie Code の設定で、有効または無効にするツールとサーバーを選択できます。
接続されたアプリケーションのコンプライアンスガイダンスについては、外部プロバイダーの要件を参照してください。
制限事項
- 外部MCPサーバーは、モデルサービングがサポートされている地域でのみ利用可能です。「モデルサービング機能の利用可能性」を参照してください。