Bitbucket Cloud 与 Data Center
分别配置个人身份和 Cursor App,并识别 Data Center 的 Bugbot 限制。
Bitbucket Cloud 集成为 public beta,支持 bitbucket.org 的 Cloud Agents 与 Bugbot。Data Center 支持 Bugbot,不支持 Cloud Agents,且要求 Cursor Teams 或 Enterprise。
Cloud 的两层连接
每位发起 Cloud Agent 或开 PR 的开发者在 Integrations 连接自己的 Bitbucket 账号,授予仓库访问。另由 workspace admin 安装 Cursor App,为事件、评审和进度评论提供稳定 App 身份。
安装后在 Bitbucket workspace settings > Forge Apps > Cursor 点击 Connect to Cursor,关联 Cursor team。安装要求 Bitbucket workspace admin,关联要求有该 workspace 访问的 Cursor team admin;由同一人处理时需要两种角色。
安装事件同步可能延迟几分钟,暂时找不到 workspace 时稍后重试关联。
动作身份
| 动作 | 身份 |
|---|---|
| Bugbot 评论、行内 finding 与 build status | Cursor App |
| Cloud Agent PR 进度评论 | Cursor App |
| clone、push、提交与创建 PR | 连接的 Bitbucket 用户 |
只有个人 OAuth 连接不足以让评论显示为 Cursor App。应用权限涉及 account、repositories、PR 读写及 webhooks。
Data Center 配置
准备专用服务账号及 HTTP access token,账号对每个待评审仓库需要 repository admin,才能读取内容、管理 webhook 和发布状态。
在 Integrations > Advanced > Bitbucket Data Center 注册 clone URL 使用的 Bitbucket Hostname;API/负载均衡主机不同则填 External Host,再提供 Service Account Token。随后到 Bugbot 的仓库列表启用。
实例需让 Cursor 通过 HTTPS 访问 API/Git,并能出站发送 webhook。Enterprise 私网可使用PrivateLink 或 Tunnel。
Data Center 在 PR 创建/更新时自动评审;bugbot run、cursor review 评论不触发,Cursor 会回复说明。Autofix 也不支持,启用时会跳过并在 review 说明。
断开连接
Cloud 的 Disconnect account 仅移除个人 OAuth,Disconnect Cursor app 解除 workspace 与 Cursor team 关联,App 仍可能装在 Bitbucket。要停止 workspace App 事件,还需 workspace admin 在 Bitbucket 卸载。
Data Center 先在 Cursor 删除注册实例,再到 Bitbucket 撤销服务账号 token。仓库不可列出时检查 token、访问权限和 hostname/External Host 连通性。