后台智能体 和 Bugbot 需要安装 Cursor 的 GitHub 应用来克隆仓库并推送变更。

​
安装

  1. 前往 Dashboard 的 Integrations
  2. 点击 GitHub 旁的 Connect
  3. 选择仓库范围：All repositories 或 Selected repositories
要断开你的 GitHub 账户，回到 Integrations 仪表盘并点击 Disconnect Account。

​
在 GitHub 中使用 Agent

GitHub 集成让你可以直接在 pull request 和 issue 中启动后台 agent 工作流。你可以在任意 PR 或 issue 里评论 @cursor [prompt]，触发 agent 读取上下文、实现修复并推送提交。 如果你启用了 Bugbot，可以评论 @cursor fix，读取 Bugbot 的建议修复，从而触发后台 agent 来处理该问题。

​
权限

GitHub 应用需要特定权限才能与后台代理协同工作：
权限目的
Repository access克隆你的代码并创建工作分支
Pull requests基于代理的更改创建 PR，供你审核
Issues跟踪代理发现或修复的缺陷和任务
Checks and statuses报告代码质量与测试结果
Actions and workflows监控 CI/CD 流水线与部署状态
所有权限都遵循最小权限原则，仅限于支撑后台代理所需的功能。

​
IP 允许列表配置

如果你们组织使用 GitHub 的 IP 允许列表来限制仓库访问，需要先联系支持为你们团队开启 IP 允许列表功能。

​
联系支持

在配置 IP 允许列表之前，发邮件到 hi@cursor.com 为你们团队开启此功能。下面两种配置方式都需要先完成这一步。 Cursor 的 GitHub 应用已经预先配置了 IP 列表。你可以为已安装的应用启用允许列表来自动继承这份列表。这个方法是推荐的，因为我们可以持续更新该列表，你们组织也会自动收到更新。 启用方法：
  1. 进入你们组织的 Security 设置
  2. 打开 IP 允许列表设置
  3. 勾选 “Allow access by GitHub Apps”
详细步骤见 GitHub 文档。

​
直接把 IP 加入允许列表

如果你们组织在 GitHub 中使用 IdP 定义的允许列表，或者无法使用预配置的允许列表，可以手动添加以下 IP 地址： 
184.73.225.134
3.209.66.12
52.44.113.131
IP 地址列表可能会偶尔变更。使用 IP 允许列表的团队会在新增或移除 IP 前提前收到通知。

​
故障排查