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 讀取脈絡、實作修正，並推送 commits。 如果你啟用了 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 允許清單設定
  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 位址新增或移除前事先收到通知。

​
疑難排解