当你通过 原生 Databricks GitHub 连接器 或 自定义 GitHub MCP 服务器 连接 Genie Code 后,它就可以搜索 GitHub 存储库。 在大多数情况下,请使用原生连接器。 专用存储库访问需要GitHub组织管理员才能安装 Databricks GitHub 连接器应用。
使用本机连接器(建议)
若要将 Genie One 或 Genie Code 连接到 GitHub,请使用 Databricks 第三方连接器。 请参阅 使用 Databricks 提供的用于第三方源的 MCP 连接器,并 将 Genie One 连接到外部工具和源。 对于专用存储库,管理员需要 启用访问权限。
- 原生连接器使用默认的 Databricks 系统连接。 若要改用 custom 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 应用。
- 填写所需字段。
回调 URL 应为
https://<your-databricks-workspace-url>/login/oauth/http.html。 这就是GitHub使用 Databricks 工作区进行身份验证的方式。- 主页 URL 不会影响 MCP 服务器,并且可以设置为任何喜欢的值。
- 清除 “活动 ”复选框,使 Webhook URL 成为可选字段。
- 向GitHub应用授予访问存储库和组织所需的权限。
- 单击“ 创建 GitHub 应用”。
在新建的应用的 “客户端机密”下,单击“ 生成新的客户端密码”。 复制此值。
将 Unity Catalog 连接注册为 MCP 服务
为 GitHub 创建或重用一个 Unity Catalog HTTP 连接。 你必须在架构上具有
CREATE CONNECTION权限才能创建一个。 如果重用现有连接,你必须对其具有USE CONNECTION。 下一步继续将该连接注册为MCP服务。 对于新连接,请使用以下认证选项之一:- 托管 OAuth:选择 OAuth 用户到机器(每用户) 认证类型和 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 工作区中,转到目录/catalog,选择一个架构,然后点击创建>MCP 服务。
- 输入目录、模式和MCP服务的名称。
- 选择你创建或复用的 HTTP 连接,选择要暴露的工具,然后点击 “创建”。
如果你选择了按用户使用OAuth,请登录MCP服务授权你的GitHub账户。
向用户或组授予 MCP 服务上的
USE CATALOG,以及其父目录和架构上的USE SCHEMA和EXECUTE。 不要向最终用户授予USE CONNECTION。 参见 共享一个MCP。
您的 GitHub MCP 服务已准备好使用。 把它加入 Genie Code。