用 Genie Code 搜尋 GitHub 程式碼

Genie Code 在您透過 Databricks 原生 GitHub 連接器 或 自訂 GitHub MCP 伺服器 將其連線後，即可搜尋 GitHub 儲存庫。 大多數情況下使用原生連接器。 私有儲存庫存取需要 GitHub 組織管理員安裝 Databricks GitHub 連接器應用程式。

建議使用原生連接器

Important

這項功能位於 測試版 (Beta) 中。 若要使用第三方資料來源連接器，工作區管理員必須啟用 第三方代理連接器 預覽。 請參閱 管理 Azure Databricks 預覽。

要將 Genie One 或 Genie Code 連接到 GitHub，請使用 Databricks 第三方連接器。 請參閱 使用原生連接器連接第三方資料來源 ，並 連接外部工具與來源。 對於私人倉庫，管理員需要 啟用存取權限。

• 原生連接器使用預設的 Databricks 系統連線。 若要改用自訂 GitHub MCP 伺服器，請手動新增。 請參見 手動將 MCP 伺服器加入 Genie Code。
• 為了提升回應，為每個儲存庫加入個人情境，幫助 GitHub 搜尋工具理解你的程式碼庫。

啟用私人儲存庫存取

GitHub 預設的 Databricks 系統連線只能存取公開的儲存庫。 要讓連線取得私有企業倉庫的讀存取權，GitHub 組織管理員必須完成以下步驟：

1. 在你的 GitHub 組織上安裝 Databricks GitHub connector app，讓它能讀取你的私人倉庫。

2. 將 Databricks 的無伺服器輸出 IP 位址加入您工作區所在雲端和區域的允許清單。 關於 IP 位址列表，請參見 IP 位址與網域，Azure Databricks服務與資產。 關於如何為GitHub組織設定允許的 IP 位址，請參見 管理組織允許的 IP 位址。

管理員設定完成後，組織中的使用者可以使用預設的 Databricks 系統連線存取私人倉庫。

建立自訂的 GitHub MCP 伺服器（不建議）

如果你的 Databricks 工作區已經有 GitHub Unity 目錄連線可用，請跳過這部分。 如果你只需要存取公開資料庫和你自己帳號的資訊，請跳到步驟 3。

請依照以下步驟建立自訂的 GitHub MCP 伺服器。 這讓你能根據自己的資料和安全需求來設定伺服器。

1. 從你的 GitHub 帳號建立一個 GitHub 應用程式。 對於企業級程式碼庫，GitHub 組織管理員必須完成此步驟。

   • 前往個人資料> 設定 > 開發人員設定 > GitHub 應用程式，然後按一下 新增 GitHub 應用程式。
   • 請填寫所要求的欄位。 回調網址應該是 https://<your-databricks-workspace-url>/login/oauth/http.html。 這就是 GitHub 與你的 Databricks 工作區進行認證的方式。
     • 首頁網址不會影響 MCP 伺服器，且可設定為任何你喜歡的值。
     • 清除 「啟用」 核取方塊，將 webhook URL 設為選填欄位。
   • 授予你的 GitHub 應用程式必要的權限，以存取你的倉庫和組織。
   • 點擊 「建立 GitHub 應用程式」。

2. 在新建立的應用程式中，在 「用戶端秘密」中，點擊 「產生新的用戶端秘密」。 複製這個數值。

3. 為 GitHub 建立一個新的 Unity 目錄連結。 您必須擁有 CREATE CONNECTION 權限。

   • 如果你的工作區已經安裝了一個，只要你有 USE CONNECTION 權限，就可以使用現有的。
   • 請填寫以下欄位：
     • 連接類型： HTTP
     • 認證類型： OAuth User to Machine
     • OAuth 提供者： Manual configuration
       • 如果您只需要存取公開資料庫和您自己帳號的資訊，請選擇 Github MCP 此處並跳過其他步驟。
     • 主： https://api.githubcopilot.com
     • OAuth 範圍：你應用程式的範圍。 例如， mcp:access read:user user:email repo read:org
     • 用戶端秘密與用戶端 ID：由步驟 2 產生
     • 授權端點： https://github.com/login/oauth/authorize
     • 代幣端點： https://github.com/login/oauth/access_token
     • 基底路徑： /mcp
     • 是否是MCP連線：checked
   • 點選 「建立連線」。

4. 在右上角點選「 登入 」登入你的連線。 這會開啟一個新視窗，提示你將 GitHub 應用程式授權給你的 Databricks 帳號。 在你想連接的 GitHub 帳號上點選「連接」。

你的 GitHub MCP 現在已經準備好可以使用了。 把它加到 Genie Code 裡，作為外部 MCP 伺服器。