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

GitHubコードをGenie Codeで検索します

Genie Codeは、ネイティブDatabricks GitHubコネクターまたはカスタムGitHub MCPサーバーを介して接続すると、GitHubリポジトリを検索できます。ほとんどの場合にネイティブコネクターを使用してください。プライベートリポジトリへのアクセスには、GitHub組織の管理者がDatabricks GitHubコネクターアプリをインストールする必要があります。

ネイティブコネクタを使用する(推奨)​

備考

プレビュー

この機能はベータ版です。サードパーティのデータソースコネクタを使用するには、ワークスペース管理者が エージェント向けサードパーティコネクタの プレビューを有効にする必要があります。Databricksのプレビューを管理するを参照してください。

Genie One または Genie Code を GitHub に接続するには、Databricks サードパーティコネクタを使用してください。サードパーティデータソースにネイティブコネクタを使用するおよび外部ツールとソースに接続するを参照してください。プライベートリポジトリの場合、管理者はアクセスを有効にする必要があります。

  • ネイティブコネクタは、デフォルトのDatabricksシステム接続を使用します。代わりにカスタムのGitHub MCPサーバーを使用する場合は、手動で追加してください。「Genie CodeにMCPサーバーを手動で追加する」を参照してください。
  • 検索結果の精度を向上させるには、各リポジトリに個人的なコンテキストを追加して、GitHubの検索ツールがコードベースを理解できるようにしてください。

カスタム GitHub MCP サーバーを登録する (推奨されません)​

Databricks ワークスペースですでに使用可能な GitHub Unity Catalog MCP サービスがある場合は、このセクションをスキップしてください。パブリックリポジトリとご自身の アカウント情報 へのアクセスのみが必要な場合は、マネージドOAuth を使用し、「 Unity Catalog 接続を MCP サービスとして登録する 」に進んでください。

特定のデータとセキュリティの要件に合わせてカスタム GitHub MCP サーバーを MCP サービスとして登録するには、以下のステップに従います。まず、MCP サービスが認証を行う方法を選択します。

  • マネージド OAuth :Databricks が GitHub の OAuth アプリと認証情報を管理します。以下の GitHub アプリおよびクライアントシークレットのステップをスキップし、接続の作成時にマネージドプロバイダーを選択します。
  • Custom OAuth : 独自の GitHub アプリを作成し、接続の作成時にその認証情報を指定します。

GitHub アプリの作成 (カスタム OAuth のみ)​

  1. GitHub アプリを作成します。エンタープライズコードベースの場合、GitHub 組織の管理者がこのステップを完了する必要があります。

    • プロフィール > 設定 > 開発者設定 > GitHub Apps に移動し、 「New GitHub App」 をクリックします。

    • 必要な項目を入力してください。 コールバックURLは https://<your-databricks-workspace-url>/login/oauth/http.htmlある必要があります。これは、 GitHub Databricksワークスペースで認証する方法です。

      • ホームページURLはMCPサーバーに影響せず、任意の値に設定できます。
      • 「Active」 チェックボックスをオフにして、Webhook URLをオプションフィールドにします。
    • GitHubアプリに、リポジトリと組織にアクセスするために必要な権限を付与してください。

    • 「GitHub アプリの作成」を クリックします。

  2. 新しく作成したアプリで、 「クライアントシークレット」 の下にある 「新しいクライアントシークレットを生成」 をクリックします。この値をコピーしてください。

Unity Catalog 接続を MCP サービスとして登録する​

  1. GitHub 用の Unity Catalog HTTP 接続を作成するか、既存の接続を再利用します。スキーマを作成するには、そのスキーマに対する CREATE CONNECTION 権限が必要です。既存の接続を再利用する場合は、その接続に対する USE CONNECTION が必要です。次のステップで、その接続を MCP サービスとして登録し続けます。新しい接続の場合は、次のいずれかの認証オプションを使用します。

    • Managed OAuth : OAuth User to Machine Per User 認証タイプと GitHub OAuth プロバイダーを選択します。Databricks は、GitHub のホスト、ベースパス、および OAuth 認証情報を提供します。

    • カスタム OAuth : OAuth User to Machine Per User 認証タイプと Manual configuration 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
    • 接続の作成 をクリックします。

  2. HTTP 接続を使用する MCP サービスを登録します。必要な権限については、外部 MCP サーバーを登録するを参照してください。

    • Databricks ワークスペースで、 カタログ に移動し、スキーマを選択して、 作成 > MCP サービス をクリックします。
    • MCP サービスのカタログ、スキーマ、名前を入力します。
    • 作成または再利用した HTTP 接続を選択し、公開するツールを選択して、 作成 をクリックします。
  3. ユーザーごとの OAuth を選択した場合は、カタログエクスプローラーで MCP サービスを開き、 [ログイン] (Login) をクリックして GitHub アカウントを承認します。

  4. ユーザーまたはグループに MCP サービスに対する EXECUTE を付与し、さらにその親カタログおよびスキーマに対する USE CATALOG と USE SCHEMA を付与します。エンドユーザーに USE CONNECTION を付与しないでください。「ステップ 4: MCP サービスへのアクセス権を付与する」を参照してください。

GitHub MCP サービスを使用する準備が整いました。Genie Code に追加します。