Background Agents dan Bugbot memerlukan aplikasi GitHub dari Cursor untuk mengkloning repositori dan mendorong perubahan.

Instalasi

  1. Buka Integrations di Dashboard
  2. Klik Connect di sebelah GitHub
  3. Pilih repositori: All repositories atau Selected repositories
Untuk memutuskan akun GitHub lo, kembali ke dashboard Integrations dan klik Disconnect Account.

Menggunakan Agent di GitHub

Integrasi GitHub memungkinkan alur kerja agent di latar belakang langsung dari pull request dan issue. Kamu bisa memicu agent untuk membaca konteks, menerapkan perbaikan, dan mendorong commit dengan menambahkan komentar @cursor [prompt] pada PR atau issue mana pun. Kalau kamu mengaktifkan Bugbot, kamu bisa menulis komentar @cursor fix untuk mengambil perbaikan yang disarankan Bugbot dan memicu agent di latar belakang untuk menangani issue tersebut.

Permissions

Aplikasi GitHub memerlukan izin tertentu untuk bekerja dengan agen latar belakang:
PermissionPurpose
Repository accessMengklon kode kamu dan membuat branch kerja
Pull requestsMembuat PR dengan perubahan dari agen untuk kamu tinjau
IssuesMelacak bug dan tugas yang ditemukan atau diperbaiki agen
Checks and statusesMelaporkan kualitas kode dan hasil tes
Actions and workflowsMemantau pipeline CI/CD dan status deployment
Semua izin mengikuti prinsip least privilege yang diperlukan untuk fungsionalitas agen latar belakang.

Konfigurasi Daftar Izinkan IP

Kalau organisasi kamu pakai fitur daftar izinkan IP GitHub untuk membatasi akses ke repositori, kamu perlu hubungi support dulu buat mengaktifkan fungsionalitas allowlist IP untuk tim kamu.

Hubungi Support

Sebelum mengonfigurasi allowlist IP, hubungi hi@cursor.com untuk mengaktifkan fitur ini buat tim kamu. Ini wajib untuk kedua metode konfigurasi di bawah. Aplikasi GitHub Cursor sudah punya daftar IP yang dikonfigurasi sebelumnya. Kamu bisa mengaktifkan allowlist untuk aplikasi yang terpasang supaya otomatis mewarisi daftar ini. Ini adalah pendekatan yang direkomendasikan, karena memungkinkan kami memperbarui daftar tersebut dan organisasi kamu menerima pembaruan secara otomatis. Untuk mengaktifkannya:
  1. Buka pengaturan Security organisasi kamu
  2. Masuk ke pengaturan IP allow list
  3. Centang “Allow access by GitHub Apps”
Untuk instruksi detail, lihat dokumentasi GitHub.

Tambahkan IP langsung ke allowlist kamu

Kalau organisasi kamu pakai allowlist yang ditentukan IdP di GitHub atau nggak bisa pakai allowlist yang sudah dikonfigurasi sebelumnya, kamu bisa menambahkan alamat IP secara manual:
184.73.225.134
3.209.66.12
52.44.113.131
Daftar alamat IP mungkin sesekali berubah. Tim yang menggunakan daftar izinkan IP akan diberi pemberitahuan terlebih dahulu sebelum alamat IP ditambahkan atau dihapus.

Pemecahan Masalah