将 Bitbucket Cloud 仓库连接至 Cloud Agents 和 Bugbot。将 Bitbucket Data Center 仓库连接至 Bugbot。
设置¶
Bitbucket Cloud¶
Bitbucket Cloud 集成目前处于公开测试阶段，支持 bitbucket.org 上的代码仓库。
Bitbucket Cloud 的设置分为两部分，分别需要不同的角色：
- 每位开发者都需要连接自己的 Bitbucket 账户，以便 Cursor 能够以该用户身份克隆代码仓库、推送分支和创建 PR。
- Bitbucket 工作区管理员需要安装 Cursor 应用，以便 Bugbot 和云端代理的状态评论能够显示为 Cursor。要将已安装的应用关联到您的 Cursor 团队，需要由可访问 Bitbucket 工作区的 Cursor 团队管理员操作。
连接您的 Bitbucket 账户¶
您需要有权访问要使用的 Bitbucket 工作区代码仓库。
- 前往仪表盘中的集成
- 点击 Bitbucket 旁边的 连接
- 在 Bitbucket 中授权 Cursor
- 返回仪表盘，确认集成状态显示为 已连接
每位通过 Cursor 启动云端代理或创建 PR 的用户，都应连接自己的 Bitbucket 账户。
在 Bitbucket 中安装 Cursor 应用¶
Bitbucket 工作区管理员必须在工作区中安装 Cursor 应用。这会为 Cursor 提供稳定的应用身份，用于处理代码仓库事件、Bugbot 审查评论、行内评论和状态更新。
步骤 1 至 4 需要由 Bitbucket 工作区管理员操作。步骤 5 和 6 需要由可访问 Bitbucket 工作区的 Cursor 团队管理员操作。如果由同一人完成全部设置，则需要同时具备这两个角色。
- 前往仪表盘中的集成
- 找到 Bitbucket 并打开管理菜单
- 点击 安装 Cursor 应用
- 在您的 Bitbucket 工作区中安装该应用
- 在 Bitbucket 工作区设置的 Forge Apps 下，选择 Cursor
- 点击 连接到 Cursor，然后选择要关联的 Cursor 团队
工作区关联后，仪表盘会显示 Cursor 应用已安装到该 Bitbucket 工作区。
应用安装后，Bitbucket 可能需要几分钟才能通知 Cursor。如果 Cursor 未能立即找到该工作区，请稍候后再次尝试关联。
Cursor 如何使用 Bitbucket Cloud 身份¶
Cursor 会针对不同操作使用不同的 Bitbucket 身份：
| 操作 | Bitbucket 身份 |
|---|---|
| Bugbot 摘要评论、行内评论和构建状态 | Cursor 应用 |
| PR 中的云端代理进度评论 | Cursor 应用 |
| Git 克隆、分支推送、提交和创建 PR | 已连接的 Bitbucket 用户 |
云端代理创建的 PR 会归属于启动该智能体的用户。安装工作区应用后，Bugbot 的输出会显示为来自 Cursor。
权限¶
Bitbucket Cloud 集成会请求支持云端代理和 Bugbot 所需的权限：
| 权限 | 用途 |
|---|---|
| 账户 | 识别已连接的 Bitbucket 用户 |
| 代码仓库 | 列出、克隆和读取代码仓库内容 |
| PR | 读取 PR diff 和元数据 |
| PR 写入 | 创建 PR 并发布评论 |
| Webhooks | 接收代码仓库和 PR 事件 |
断开 Bitbucket Cloud¶
断开 Bitbucket Cloud 会产生两种不同的效果：
- 断开账户连接 会从 Cursor 中移除您的个人 Bitbucket OAuth 连接。
- 断开 Cursor 应用连接 会解除 Bitbucket 工作区与您的 Cursor 团队的关联。在工作区管理员从 Bitbucket 中移除该应用之前，应用仍可保持安装状态。
要完全停止接收来自该工作区的应用事件，请在 Bitbucket 工作区设置中卸载 Cursor 应用。
Bitbucket Data Center¶
Bitbucket Data Center 需要 Teams 或 企业版 方案。支持 Bugbot，不支持云端代理。
前提条件¶
- Cursor 团队管理员权限
- 专用的 Bitbucket Data Center 服务账户
- 服务账户的 HTTP 访问令牌
- 服务账户对每个要与 Bugbot 配合使用的代码仓库均具有管理员权限
服务账户会读取代码仓库和 PR、管理 Webhook，并发布 Bugbot 评论和构建状态。
网络¶
Cursor 需要通过 HTTPS 访问您的 Bitbucket Data Center 实例，以发送 API 请求和克隆 Git 仓库。您的实例还需要具备出站 HTTPS 访问权限，以便向 Cursor 发送 Webhook 通知。
IP 允许列表 (推荐)¶
将以下 Cursor IP 地址添加到您的入站允许列表：
184.73.225.134
3.209.66.12
52.44.113.131
如果 Cursor 需要使用与代码仓库克隆主机名不同的负载均衡器或 API 主机名，请在注册时将其填写为外部主机。
对于不具备公网入站访问权限的实例，请参阅高级网络。
在 Cursor 中注册¶
- 为 Bitbucket 服务账户创建 HTTP 访问令牌
- 前往仪表盘中的集成
- 打开高级，然后选择 Bitbucket Data Center
- 输入代码仓库克隆 URL 中使用的 Bitbucket 主机名
- 如果 API 流量使用不同的主机名，请将其填写为外部主机
- 输入服务账户令牌
- 点击注册
- 打开自动化中的 Bugbot，在该实例的代码仓库中启用它
Cursor 会使用服务账户身份发布 Bugbot 评审评论、行内发现、Webhook 和构建状态。
断开 Bitbucket Data Center 连接¶
前往仪表盘中的集成，打开 Bitbucket Data Center 配置页面，然后删除已注册的实例。从 Cursor 中移除实例后，请在 Bitbucket Data Center 中撤销服务账户令牌。
高级网络¶
Bitbucket Data Center 支持为无法接收来自公共互联网流量的实例提供私有连接方式。
AWS PrivateLink 或 Cloudflare Tunnel¶
仅限企业版客户使用。允许 Cursor 通过私有网络连接访问您的实例。有关设置，请参阅私有网络连接，或联系您的 Cursor 代表。
最适合： 位于防火墙后的实例，包括托管在 AWS 上的实例以及可运行 cloudflared 的环境
安全性： HTTPS 加密、AWS PrivateLink、Cloudflare Tunnel、VPC 允许列表、服务账户访问 token
缺点： 需要与 Cursor 协调。目前不支持 Google Private Service Connect。
反向代理隧道¶
仅限企业版客户使用。在本地部署反向代理隧道，与 Cursor 建立出站连接。网络请求会通过隧道转发，因此 Bitbucket 实例无需开放公共入站访问。联系您的 Cursor 代表了解设置详情。
最适合： 没有入站网络访问权限的环境
安全性： HTTPS 加密、服务账户访问 token
缺点： 与更直接的连接方式相比，会增加复杂性、维护需求和潜在的安全风险
疑难排查¶
Cursor 找不到我的 Bitbucket 工作区¶
Bitbucket 应用安装事件可能需要几分钟才能同步。请稍候，然后在 Bitbucket 工作区设置中重试 连接到 Cursor 步骤。
我已安装 Cursor 应用，但无法将其关联到我的 Cursor 团队¶
- 确认您是 Cursor 团队管理员。安装应用需要 Bitbucket 工作区管理员权限，而将工作区关联到 Cursor 团队需要 Cursor 团队管理员权限。
- 确认您的 Bitbucket 用户有权访问要关联的工作区。
Bugbot 评论未显示为 Cursor¶
请在 Bitbucket 工作区中安装 Cursor 应用，并将其关联到您的 Cursor 团队。仅连接个人 Bitbucket 账户不足以发布 Cursor 应用评论。
Cloud Agent 无法访问 Bitbucket 仓库¶
- 在集成仪表盘中连接您的个人 Bitbucket 账户。
- 确认您的 Bitbucket 用户对该仓库具有读写权限。
- 确认该仓库位于
bitbucket.org上的 Bitbucket Cloud。
Cursor 无法列出我的 Bitbucket Data Center 仓库¶
- 确认服务账户令牌处于有效状态。
- 确认服务账户可以访问这些仓库。
- 确认 Cursor 可以通过 HTTPS 访问实例主机名或已配置的外部主机。
我无法在 Bitbucket Data Center 仓库上启用 Bugbot¶
- 确认您是 Cursor 团队管理员。
- 确认已注册的实例具有服务账户令牌。
- 确认服务账户拥有仓库管理员权限。
后续步骤¶
连接 Bitbucket 后，请配置使用 Bitbucket 的功能：
- Bugbot - 自动化 PR 审查，帮助发现缺陷和安全问题
- Cloud Agents - 面向 Bitbucket Cloud 仓库的 AI 智能体
