Genie Code 在您透過 Databricks 原生 GitHub 連接器 或 自訂 GitHub MCP 伺服器 將其連線後，即可搜尋 GitHub 儲存庫。 大多數情況下使用原生連接器。 私有儲存庫存取需要 GitHub 組織管理員安裝 Databricks GitHub 連接器應用程式。
建議使用原生連接器
Important
這項功能位於 測試版 (Beta) 中。 若要使用第三方資料來源連接器，工作區管理員必須啟用 第三方代理連接器 預覽。 請參閱 管理 Azure Databricks 預覽。
要將 Genie One 或 Genie Code 連接到 GitHub，請使用 Databricks 第三方連接器。 請參閱 使用原生連接器連接第三方資料來源，並參閱 將 Genie One 連接到外部工具和來源。 對於私人倉庫，管理員需要 啟用存取權限。
- 原生連接器使用預設的 Databricks 系統連線。 若要改用自訂 GitHub MCP 伺服器，請手動新增。 請參見 手動將 MCP 伺服器加入 Genie Code。
- 為了提升回應，為每個儲存庫加入個人情境，幫助 GitHub 搜尋工具理解你的程式碼庫。
註冊自訂的 GitHub MCP 伺服器（不建議）
如果你的 Azure Databricks 工作區已經有 GitHub Unity Catalog MCP 服務可供使用，請跳過這部分。 如果你只需要存取公開倉庫和自己帳號的資訊，請使用受管理的 OAuth，並直接前往 將 Unity Catalog 連線註冊為 MCP 服務。
請依照以下步驟註冊一台自訂的 GitHub MCP 伺服器，作為符合您特定資料與安全需求的 MCP 服務。 首先，選擇你的 MCP 服務如何進行身分驗證：
- 受管理 OAuth：Databricks 管理 GitHub OAuth 應用程式及憑證。 跳過以下 GitHub 應用程式和客戶端秘密步驟，建立連線時選擇受管理的提供者。
- 自訂 OAuth：建立自己的 GitHub 應用程式，並在建立連線時提供其憑證。
建立一個 GitHub 應用程式（僅限自訂 OAuth ）
建立一個 GitHub 應用程式。 對於企業級程式碼庫，GitHub 組織管理員必須完成此步驟。
- 前往個人資料> 設定 > 開發人員設定 > GitHub 應用程式，然後按一下 新增 GitHub 應用程式。
- 請填寫所要求的欄位。
回調網址應該是
https://<your-databricks-workspace-url>/login/oauth/http.html。 這就是 GitHub 與你的 Databricks 工作區進行認證的方式。- 首頁網址不會影響 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 使用者對機器（每位使用者） 驗證類型，以及 手動設定 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 工作區，點選目錄，選擇一個結構描述，然後點選建立>MCP 服務。
- 輸入 MCP 服務的目錄、綱要與名稱。
- 選擇你建立或重複使用的 HTTP 連線，選擇要暴露的工具，然後點 建立。
如果你選擇了每用戶 OAuth，請在目錄總管中開啟 MCP 服務，並點擊登入以授權你的 GitHub 帳號。
授權使用者或群組在 MCP 服務上具有
EXECUTE，並在其父目錄與架構上具有USE CATALOG和USE SCHEMA。 不要授權最終使用者USE CONNECTION。 請參見 「分享 MCP」。
您的 GitHub MCP 服務已準備好使用。 把它加入 Genie Code。