GitHub
Aplikasi GitHub Cursor menghubungkan repositori Anda agar Anda dapat menggunakan fitur seperti agen cloud dan Bugbot.
Konfigurasi
Memerlukan akses admin Cursor dan admin organisasi GitHub.
- Buka Integrasi di Dashboard
- Klik Hubungkan di samping GitHub (atau Kelola Koneksi jika sudah terhubung)
- Pilih Semua repositori atau Repositori terpilih
- Kembali ke Dashboard untuk mengatur fitur pada repositori Anda
Untuk memutuskan sambungan akun GitHub, kembali ke Dashboard integrasi lalu klik Putuskan Sambungan Akun.
Konfigurasi daftar IP yang diizinkan
Jika organisasi Anda menggunakan fitur daftar IP yang diizinkan GitHub untuk membatasi akses ke repositori Anda, Cursor dapat diatur untuk menggunakan proksi egress terkelola dengan sejumlah kecil alamat IP.
Sebelum mengatur daftar yang diizinkan, hubungi hi@cursor.com untuk mengaktifkan fitur ini bagi tim Anda. Langkah ini diperlukan untuk kedua metode konfigurasi di bawah ini.
Aktifkan konfigurasi daftar IP yang diizinkan untuk GitHub Apps yang diinstal (disarankan)
Aplikasi GitHub Cursor sudah memiliki daftar IP yang dikonfigurasikan sebelumnya. Anda dapat mengaktifkan daftar yang diizinkan untuk app yang diinstal agar otomatis menggunakan daftar ini. Ini adalah pendekatan yang disarankan, karena kami dapat memperbarui daftar tersebut dan organisasi Anda akan menerima pembaruan secara otomatis.
Untuk mengaktifkannya:
- Buka pengaturan Security organisasi Anda
- Buka pengaturan daftar IP yang diizinkan
- Centang "Izinkan akses oleh GitHub Apps"
Untuk petunjuk lengkap, lihat dokumentasi GitHub.
Tambahkan IP langsung ke daftar yang diizinkan
Jika organisasi Anda menggunakan daftar yang diizinkan yang ditentukan oleh IdP di GitHub atau tidak dapat menggunakan daftar yang telah dikonfigurasi sebelumnya, tambahkan IP proksi yang tercantum di Proksi egress Git dan daftar IP yang diizinkan.
Jaringan tingkat lanjut
Instance yang di-hosting sendiri mendukung berbagai metode koneksi selain daftar IP yang diizinkan. Untuk detail konfigurasi dan opsi jaringan private yang didukung, lihat Konektivitas Private.
Tersedia untuk pelanggan Enterprise. Gunakan AWS PrivateLink jika GitHub Enterprise Server Anda berada di AWS atau dapat ditempatkan di balik AWS Network Load Balancer. PrivateLink dapat mendukung Cursor mengakses GHES dan, jika diperlukan, GHES mengirim webhook kembali ke Cursor tanpa egress ke internet publik.
Paling cocok untuk: Instance GHES yang di-hosting di AWS dan tim yang menginginkan konektivitas endpoint VPC private
Keamanan: Enkripsi HTTPS, AWS PrivateLink, kebijakan endpoint VPC, token akses akun layanan
Kekurangan: Memerlukan koordinasi dengan Cursor dan konfigurasi layanan endpoint AWS.
Tersedia untuk pelanggan Enterprise. Gunakan Cloudflare Tunnel jika AWS PrivateLink tidak praktis atau jika Anda memerlukan model deployment yang hanya menggunakan outbound. Jaringan Anda menjalankan cloudflared, dan Cursor menyediakan hostname serta token tunnel.
Paling cocok untuk: Lingkungan tanpa akses jaringan inbound
Keamanan: Enkripsi HTTPS, Cloudflare Tunnel, token akses akun layanan
Kekurangan: Memerlukan pengoperasian dan pemeliharaan cloudflared di lingkungan Anda.
Izin
Aplikasi GitHub meminta izin berikut untuk mendukung fitur Cursor:
| Izin | Tujuan |
|---|---|
| Akses repositori | Mengkloning kode Anda dan membuat branch kerja |
| Pull request | Membuat PR dan menambahkan komentar tinjauan |
| Issue | Melacak bug dan tugas yang ditemukan selama peninjauan |
| Pemeriksaan dan status | Melaporkan kualitas kode dan hasil pengujian |
| Actions dan alur kerja | Memantau pipeline CI/CD dan memicu ulang CI dari pull request |
| Administrasi | Membaca aturan perlindungan branch dan pemeriksaan wajib untuk menentukan apakah PR dapat digabungkan |
| Peran repositori kustom | Menentukan tingkat akses pengguna agar opsi penggabungan dan peninjauan yang tepat muncul |
| Properti kustom organisasi | Menampilkan metadata repositori yang ditentukan organisasi dalam pemfilteran |
Semua izin mengikuti prinsip hak istimewa minimum.
Cakupan Git yang Dilindungi
Batasi organisasi GitHub Anda ke organisasi Cursor Anda agar hanya tim Anda yang dapat menggunakan repositorinya dengan agen cloud, otomatisasi, dan Bugbot. Untuk melindungi cakupan, Anda memerlukan akses owner atau admin organisasi GitHub. Lihat Cakupan Git yang Dilindungi.
Pemecahan masalah
- Instal aplikasi GitHub dengan akses ke repositori
- Periksa izin repositori untuk repo privat
- Verifikasi izin akun GitHub Anda
- Berikan aplikasi akses tulis ke pull request
- Periksa aturan perlindungan branch
- Instal ulang jika instalasi aplikasi telah kedaluwarsa
- Periksa apakah aplikasi diinstal di tingkat organisasi
- Instal ulang dari github.com/apps/cursor
- Hubungi dukungan jika instalasi rusak
Langkah selanjutnya
Setelah integrasi GitHub Anda terhubung, atur fitur yang menggunakannya:
- Bugbot — ulasan PR otomatis yang mendeteksi bug dan masalah keamanan
- Cloud Agents — agen AI yang berjalan di cloud pada repositori Anda