Skip to content
FunCoding

Search

Search docs, Skills and MCP

GitHub 与 Enterprise Server

安装 Cursor GitHub App,配置 GHES 网络和组织访问,定位仓库与 PR 权限问题。

This page has not been translated into English yet. The original Chinese version is shown below.

Cursor GitHub App 为 Cloud Agents 和 Bugbot 提供仓库、分支、PR 和检查访问。安装时选择 All repositories 或 Selected repositories,之后仍需分别启用所需功能。

GitHub.com 设置

需要 Cursor 管理员和 GitHub 组织管理员权限。在 Dashboard > Integrations 的 GitHub 点击 Connect/Manage Connections,完成 App 安装和仓库选择,返回 dashboard 配置功能。断开个人账号使用 Disconnect Account。

App 请求的权限包含仓库、PR、issues、checks/statuses、Actions/workflows、分支保护读取、自定义仓库角色和组织自定义属性。检查完整安装授权,不把它缩减为只有 clone 权限。

GHES 注册

官方建议 GitHub Enterprise Server 3.8 或以上,并要求实例管理权限及 Cursor team admin。实例必须接受 Cursor 的安全入站访问,并能出站发送 webhook。

  1. 在 Integrations > Source Control 找到 GitHub Enterprise > Manage apps。
  2. 填 GHES base URL 和拥有 App 的组织名称。
  3. Register 后在 GHES 创建 Cursor Enterprise App,再回 dashboard 配置仓库功能。

组织内需要管理员权限;留空组织会使用个人账号,官方不推荐。其他组织可在注册后获得 App 访问。

代理与允许列表

GHES 前置代理必须允许认证的 GitHub REST 和 GraphQL 请求。它们用于安装、仓库身份解析、PR/check/review 状态和更新旧 Bugbot 输出,能 clone 不代表代理已满足全部要求。

GitHub 组织使用 IP allowlist 时,官方推荐勾选 Enable IP allow list configuration for installed GitHub Apps,继承 Cursor App 已登记的地址并接收更新。该设置在 GitHub 生效,无需 Cursor 另行启用,也不是允许所有来自这些地址的客户端。

无法继承 App 地址而手动使用 git egress proxy IP 时,还需联系 Cursor 为团队启用该 proxy;仅把 IP 加入列表不会改变实际出口。GHES 入站 IP 与 git proxy IP 用途不同,按官方当前列表配置。

Enterprise 私网可用 AWS PrivateLink 或 Cloudflare Tunnel,见私网连接。

组织绑定与排障

Protected Git Scopes 可把 GitHub 组织绑定到 Cursor 组织,要求 GitHub owner/admin。仓库不可见时检查 App 安装范围、个人访问和私有仓库权限;无法开 PR 时检查 App 写权限与分支保护;App 不可见时确认组织级安装位置。