想让 Cursor 连上 Bitbucket Cloud，可不是点一下授权就完事的。要真能用，得搞定两条配置线：一条是开发者自己连个人的 Bitbucket 账户，另一条是先让工作区管理员装上 Cursor app，再由能访问这个工作区的 Cursor 团队管理员完成团队绑定。两条都通了之后，Cursor 才能用个人身份处理仓库相关操作，同时用 app 的身份展示 Bugbot 和 Cloud Agents（云端智能体）的评论和状态。

目前 Bitbucket Cloud 的集成还在公测阶段，只支持 bitbucket.org 上的仓库。要是你们团队用的是 Bitbucket Data Center，看到这就先打住，别直接套 Cloud 的授权流程——Data Center 还要涉及实例地址、网络连通性，管理员配置的路子也不一样。

先搞清楚：两种管理员、两条连接是两码事

开发者这边连的是自己的个人 Bitbucket OAuth 账户。入口在 Cursor 仪表盘的 Integrations 页面，作用是让 Cursor 能以这名开发者的身份克隆仓库、推分支、提交改动、建 PR。只要是会从 Cursor 启动 Cloud Agents 或者建 PR 的成员，都得自己单独连，团队管理员没法一次性替所有人授权。

工作区那边要装的是 Cursor app。这步得由 Bitbucket 工作区管理员来装，再由 Cursor 团队管理员把装好的 app 绑定到对应的团队上——而且负责绑定的人，必须得能访问对应的 Bitbucket 工作区才行。要是同一个人两边权限都有，也可以一个人搞定这两步。

动手之前先核对三件事：第一，开发者能在 Bitbucket 里看到要操作的目标仓库；第二，Bitbucket 工作区管理员有权限装 Forge app；第三，Cursor 团队管理员登录的，就是要接入这个工作区的那个团队。但凡有一条不满足，后面哪怕能看到按钮，仓库、工作区或者团队列表里也会缺东西，配不通的。

先让每位开发者连上自己的 Bitbucket 账户

从 Cursor 仪表盘发起连接

入口在哪：登录 Cursor 后进仪表盘，打开 Integrations 页面，找到 Bitbucket 那一行的 Connect 按钮。要做什么：点一下 Connect，浏览器会跳转到 Bitbucket 的授权页；先核对下当前登的是不是你要用的 Bitbucket 账户，没问题就批准 Cursor 的授权请求。怎么算成功：跳回 Cursor 仪表盘之后，Bitbucket 集成那栏显示「Connected」就对了。失败了怎么办：要是授权页没弹出来，先看看浏览器是不是拦了新窗口；要是跳回来还是没连上，先确认下 Bitbucket 的登录会话没切到别的账号，再回 Integrations 页面重新发起一次。

要是连成功了但看不到仓库，先回 Bitbucket 查查你这个个人账户，是不是真的有目标工作区和对应仓库的访问权限。个人 OAuth 连接只会同步你账号本来就有的权限，不会凭空给你加仓库访问权的。

安装 Cursor app 并绑定工作区

先从 Cursor 这边发起 app 安装

入口在哪：还是在 Cursor 仪表盘的 Integrations 页面，点开 Bitbucket 右边的管理菜单。要做什么：选「Install Cursor app」，等跳转到 Bitbucket 页面之后，把 app 装到你要对接的目标工作区里。怎么算成功：去 Bitbucket 的工作区设置里，能看到 Cursor 对应的 Forge app，就说明装好了。失败了怎么办：要是目标工作区不在安装列表里，大概率是你当前用的 Bitbucket 账号不是这个工作区的管理员，换个有安装权限的账号再试就行。

Bitbucket 把安装结果同步给 Cursor 可能要等个几分钟。刚装完 app 就找不到工作区的话，别反复点安装，稍等一会儿，再进工作区设置继续绑定就行。

再从 Bitbucket 工作区设置里连 Cursor

入口在哪：打开目标 Bitbucket 工作区的 Workspace settings，在 Forge Apps 分类里找到 Cursor。要做什么：点「Connect to Cursor」按钮。怎么算成功：页面会跳转到选 Cursor 团队的绑定流程，就对了。失败了怎么办：要是找不到 Cursor 的区块或者按钮，先确认下 app 是不是装在当前这个工作区，别是装到同一个账号下的另一个工作区去了。

这张图里重点看 Workspace settings 里的 Cursor 卡片，还有那个蓝色的「Connect to Cursor」按钮。按钮上方也提示了：装完 app 之后要等几分钟，让设置状态同步完再操作。

等 Cursor 团队列表加载完成

入口在哪：点完「Connect to Cursor」之后跳出来的团队绑定页面。要做什么：等着页面读取你当前账号能管理的 Cursor 团队就行，加载的时候别反复刷页面。怎么算成功：Team 那栏出现具体的团队名称，Confirm 按钮从灰的变成能点的状态，就ok了。失败了怎么办：要是一直停在「Loading your Cursor teams」，先查下你当前登的 Cursor 账号有没有团队管理员权限，再确认下这个账号能不能访问正在绑定的 Bitbucket 工作区；查完回工作区设置重新进一次这个流程就行。

加载阶段的 Confirm 按钮是灰色的，这时候点了也没用，先等 Team 字段里出现能认出来的团队名称再说。

核对好团队再确认绑定

入口在哪：还是刚才那个绑定页面的 Team 字段。要做什么：仔细核对显示的 Cursor 团队，确认没选到测试团队或者同名的其他组织，没问题再点 Confirm。怎么算成功：页面开始提交绑定请求，然后跳转到结果页，就对了。失败了怎么办：要是显示的团队不对，直接点 Cancel 返回，别先绑定了再改；换正确的 Cursor 管理员账号，或者切到正确的团队之后再重新走流程。

团队名称是这儿最关键的判断依据，一定要确认名字没错再点 Confirm，免得把同一个 Bitbucket 工作区绑到错的 Cursor 团队上去。

靠结果页确认绑定成功

入口在哪：确认绑定之后跳转到的结果页。要做什么：先看一眼状态文字，没问题就点「Go to Integrations」回到 Cursor 仪表盘。怎么算成功：页面显示「Bitbucket linked」，就说明这个工作区已经成功连到你选的 Cursor 团队了。失败了怎么办：要是没出现成功状态，先回 Bitbucket 的 Forge Apps 里看看 Cursor app 还在不在，再等会儿同步，之后重新走一遍工作区绑定流程就行，别上来就卸载了反复装。

看到「Bitbucket linked」，才算真的把工作区和 Cursor 团队的关系建好了。回到 Integrations 页面之后，还要再确认下这个 app 对应的工作区，是显示在正确的团队下面的。

连好之后，哪些操作走个人身份？

Bugbot 的摘要评论、行内评论、构建状态，还有 Cloud Agents 在 PR 上的进度评论，都会显示成 Cursor app 的身份。而 Git 克隆、推分支、提交代码、建 PR 这些操作，走的是发起操作的那个成员已经绑定的 Bitbucket 个人账号身份。所以啊，app 绑定好了不代表所有开发者都能建 PR；没连个人账号的成员，还是得回 Integrations 页面把自己的授权搞定。

由 Cloud Agents 创建的 PR，会算在启动这个智能体的开发者名下。要是你排查「这条评论是谁发的」或者「这个 PR 怎么归到某个成员名下了」这类问题，先搞清楚当前这个操作走的是 app 身份还是个人 Bitbucket 身份，别把两套授权混在一起瞎改。

断开连接的时候，别只改一边

要是在 Cursor 里断开个人账户，只会删掉这个成员的 Bitbucket OAuth 连接，不会自动把工作区的 app 卸掉。要是断开 Cursor app，只会取消 Bitbucket 工作区和 Cursor 团队的绑定，但 app 可能还留在 Bitbucket 工作区里。要是想彻底让这个工作区不再给 Cursor 发 app 事件，工作区管理员还得去 Bitbucket 的 Workspace settings 里把 Cursor app 卸载掉。

要是需要换绑到别的 Cursor 团队，先确认当前的工作区绑定已经解除了，再让两边都有权限的管理员去连新团队。这样能避免出现「个人账号还能访问仓库，但 app 的评论和状态都发到旧团队去了」的错位问题。

把这6项核对完，再给全团队用

• 目标仓库在 Bitbucket Cloud 上，也就是 bitbucket.org 的仓库。
• 所有需要克隆、推送、提交代码或者建 PR 的成员，Cursor Integrations 里的 Bitbucket 状态都显示 Connected。
• Bitbucket 工作区设置的 Forge Apps 里，能找到 Cursor app。
• Connect to Cursor 页面加载出来的是正确的 Cursor 团队，确认之后能看到 Bitbucket linked 的提示。
• 回到 Cursor Integrations 页面后，这个 app 显示在你预期的 Bitbucket 工作区和 Cursor 团队下面。
• 找一个有权限的测试仓库验证下功能通不通；要是失败了，就分别查个人仓库权限、个人 OAuth 连接、工作区 app、团队绑定这几项，别上来就把所有配置都拆了。

这六项都能对上明确的状态之后，再让团队启用 Bugbot 或者 Cloud Agents。后面要是再出现仓库找不到、评论身份不对、工作区搜不到这类问题，也能顺着个人连接和 app 绑定这两条线分别排查。