跳轉到主要內容
Background Agents 和 Bugbot 需要 Cursor 的 GitHub 應用程式來複製儲存庫並推送修改。

​
安裝

  1. 前往 儀表板的 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 讀取內容、實作修正，並推送 commit。 如果你啟用了 Bugbot，可以留言 @cursor fix，讓背景 agent 讀取 Bugbot 的修正建議並處理該 issue。

​
權限

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 App 已預先設定好 IP 清單。你可以為已安裝的 App 啟用允許清單，讓它自動繼承這份清單。這是推薦的做法，因為我們可以更新清單，而你的組織也會自動收到更新。 要啟用這個功能：
  1. 前往你組織的 Security 設定
  2. 前往 IP allow list 設定
  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 位址前預先收到通知。

​
疑難排解

  • 安裝具備儲存庫存取權的 GitHub 應用程式
  • 檢查私人儲存庫的權限設定
  • 確認你的 GitHub 帳號權限
  • 授予應用程式對 pull request 的寫入權限
  • 檢查分支保護規則
  • 如果應用程式安裝已過期，重新安裝
  • 檢查是否以組織層級安裝
  • 從 github.com/apps/cursor 重新安裝
  • 如果安裝已損毀，聯絡支援