將 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 智能體
