Genie Code は、ネイティブ Databricks GitHub コネクタまたはカスタム GitHub MCP サーバーを介して接続すると、GitHub リポジトリを検索できます。 ほとんどの場合、ネイティブ コネクタを使用します。 プライベート リポジトリへのアクセスには、GitHub組織の管理者が Databricks GitHub コネクタ アプリをインストールする必要があります。
ネイティブ コネクタを使用する (推奨)
Important
この機能は ベータ版です。 サード パーティのデータ ソース コネクタを使用するには、ワークスペース管理者が サード パーティ コネクタ for Agents プレビューを 有効にする必要があります。 Manage Azure Databricks プレビューを参照してください。
Genie One または Genie Code をGitHubに接続するには、Databricks サードパーティ コネクタを使用します。 「サードパーティのデータソースにはネイティブコネクターを使用する」および「Genie Oneを外部ツールやソースに接続する」を参照してください。 プライベート リポジトリの場合、管理者はアクセスを 有効にする必要があります。
- ネイティブ コネクタでは、既定の Databricks システム接続が使用されます。 代わりに custom GitHub MCP サーバーを使用するには、手動で追加します。 「Genie Code に MCP サーバーを手動で追加する」を参照してください。
- 応答を改善するには、各リポジトリの個人用コンテキストを追加して、GitHub検索ツールでコードベースを理解できるようにします。
カスタムGitHub MCPサーバーを登録する(推奨されません)
もしAzure DatabricksのワークスペースにすでにGitHub Unity Catalog MCPサービスがあるなら、このセクションは飛ばしてください。 公開リポジトリと自分のアカウント情報だけが必要な場合は、管理されたOAuthを使い、Unityカタログ接続をMCPサービスとして登録に進んでください。
以下の手順に従って、特定のデータおよびセキュリティニーズに合わせたカスタムGitHub MCPサーバーをMCPサービスとして登録してください。 まず、MCPサービスがどのように認証するかを選択してください:
- マネージドOAuth:DatabricksはGitHub OAuthアプリと認証情報を管理しています。 以下のGitHubアプリとclient-secretの手順は飛ばし、接続を作成する際にマネージドプロバイダーを選択してください。
- カスタムOAuth:自分だけのGitHubアプリを作成し、接続時にその認証情報を提供します。
GitHubアプリを作成する(カスタムOAuthのみ)
GitHubアプリを作成しましょう。 エンタープライズ コードベースの場合、GitHub組織の管理者がこの手順を完了する必要があります。
- [プロファイル] > [設定] > [開発者向け設定] > GitHub [アプリ] に移動し、[新しいGitHub アプリ] をクリックします。
- 要求されたフィールドに入力してください。
コールバック URL は
https://<your-databricks-workspace-url>/login/oauth/http.htmlする必要があります。 これは、Databricks ワークスペースGitHub認証する方法です。- ホームページ URL は MCP サーバーには影響せず、任意の値に設定できます。
- [アクティブ] チェック ボックスをオフにして、Webhook URL を省略可能なフィールドにします。
- GitHub アプリに、リポジトリと組織にアクセスするために必要なアクセス許可を付与します。
- [ GitHub アプリの作成] をクリックします。
新しく作成されたアプリの [ クライアント シークレット] で、[ 新しいクライアント シークレットの生成] をクリックします。 この値をコピーします。
Unity Catalog接続をMCPサービスとして登録します
GitHub用にUnity CatalogのHTTP接続を作成または再利用してください。 スキーマを作成するには
CREATE CONNECTION権限が必要です。 既存の接続を再利用する場合は、必ずその接続にUSE CONNECTIONが設定されている必要があります。 次のステップでその接続をMCPサービスとして登録を続けてください。 新しい接続の場合は、以下のいずれかの認証オプションを使用します。- マネージドOAuth: OAuth User to Machine Per User 認証タイプおよび GitHub OAuthプロバイダーを選択します。 DatabricksはGitHubホスト、ベースパス、OAuth認証情報を提供します。
-
カスタムOAuth: OAuth User to Machine Per User 認証タイプと 手動設定 OAuthプロバイダーを選択します。 次の値を入力します。
- ホスト:
https://api.githubcopilot.com - OAuth スコープ: アプリのスコープ。 たとえば、
mcp:access read:user user:email repo read:orgのように指定します。 - クライアントシークレットとクライアントID: 上記のGitHubアプリの手順で生成された
- 承認エンドポイント:
https://github.com/login/oauth/authorize - トークン エンドポイント:
https://github.com/login/oauth/access_token - 基本パス:
/mcp
- ホスト:
- [接続の作成] をクリックします。
HTTP接続を使用するMCPサービスを登録します。 必要な権限については「 外部MCPサーバー」を参照してください。
- Azure DatabricksワークスペースでCatalogに移動し、スキーマを選択して、「Create>MCP Service」をクリックします。
- MCPサービスのカタログ、スキーマ、名前を入力してください。
- 作成したまたは再利用したHTTP接続を選択し、公開するツールを選択して「 作成」をクリックします。
ユーザーごとのOAuthを選択した場合は、カタログエクスプローラーでMCPサービスを開き、ログインをクリックしてGitHubアカウントを認証してください。
ユーザーやグループに、MCPサービスでは
EXECUTEを、さらにその親カタログとスキーマではUSE CATALOGおよびUSE SCHEMAを付与します。 エンドユーザーにUSE CONNECTIONを許可しないでください。 「 MCPを共有する」を参照してください。
あなたのGitHub MCPサービスはすぐに使える状態です。 ジーニーコードに追加してください。