Panduan Integrasi
Clavitor + Cursor
Mode Agen Cursor menjalankan perintah shell dan panggilan HTTP dari dalam editor. Arahkan ke Clavitor CLI untuk kredensial bernama dan proksi Clavitor untuk autentikasi API transparan — kunci tidak pernah masuk ke memori editor atau riwayat percakapan Anda.
Apa yang dilihat agen Cursor
Bidang yang dibagikan
Agen membaca ini melalui terminal terintegrasi untuk menyebarkan, mengautentikasi, dan memanggil API.
- Kunci API (Anthropic, OpenAI, GitHub, AWS, Stripe...)
- Kredensial host SSH
- String koneksi database
- Seed TOTP — kode 2FA langsung sesuai permintaan
- Kata sandi akun layanan
Apa yang tidak pernah dilihat agen
Bidang pribadi
Dienkripsi di sisi klien dengan sidik jari, wajah, atau kunci keamanan Anda. Server menyimpan ciphertext. Tanpa kunci, tanpa akses.
- Nomor kartu kredit & CVV
- Paspor & ID pemerintah
- Kode pemulihan & frasa benih
- Nomor jaminan sosial
- Detail rekening bank
Tidak ada MCP. Proxy dan CLI yang melakukan pekerjaan.
Cursor mendukung MCP untuk panggilan alat — tetapi Clavitor sengaja tidak menyediakan server MCP. MCP mengekspos enumerasi (daftar, cari, jelajahi) ke agen; permukaan agen hanya berupa kemampuan, bukan enumerasi. CLI mengambil apa yang telah ditetapkan untuk agen dan tidak lebih dari itu. Proksi menyuntikkan kredensial ke dalam permintaan keluar tanpa agen melihatnya sama sekali.
Ini adalah pilihan arsitektur, bukan integrasi yang hilang. Dua pola berikutnya mencakup semua yang dibutuhkan Cursor.
Penyiapan
Luncurkan Cursor dari terminal agar mewarisi HTTPS_PROXY dan PATH Anda. Di macOS, peluncuran GUI dari Finder melewati file rc shell Anda — gunakan cursor . dari terminal, atau atur proxy melalui LaunchAgent untuk persistensi.
1. Buat agen
Buka brankas Anda → Agen → Buat. Beri nama "Cursor" dan pilih entri mana yang dapat diaksesnya. Salin token penyiapan.
2. Inisialisasi CLI
$ echo "$CLAVITOR_TOKEN" | clavitor-cli init
3. Luncurkan Cursor dengan proxy aktif
$ export HTTPS_PROXY=http://localhost:1983 $ cursor .
Pola 1 — Pencarian bernama melalui terminal terintegrasi
Agen Cursor dapat memanggil perintah shell apa pun. Ketika membutuhkan satu nilai spesifik, ia mengeksekusi shell:
# In a script Cursor's agent generated:
key=$(clavitor-cli get "Anthropic API" --field key)
curl -H "x-api-key: $key" https://api.anthropic.com/v1/messages -d '{...}'Variabel tersebut hanya berlaku untuk satu pernyataan. Agen tidak melihat key antara penetapan dan penggunaan — dan kredensial tidak pernah muncul dalam riwayat obrolan karena Cursor tidak menampilkan nilai yang diekspansi kembali ke percakapan.
Untuk file konfigurasi multi-kredensial, gunakan render:
$ clavitor-cli render app.config.json | myapp --config -
Pola 2 — Injeksi transparan melalui proxy
Dengan HTTPS_PROXY diatur, agen menulis referensi, dan proksi meresolusinya saat transmisi. Rahasia tidak pernah masuk ke memori agen atau percakapan:
# Cursor's agent runs this verbatim curl -H "Authorization: Bearer clavitor://OpenAI/key" \ https://api.openai.com/v1/models
Agen melihat clavitor://OpenAI/key dalam riwayat perintahnya sendiri. Permintaan jaringan keluar dengan nilai sk-... yang sebenarnya di header Authorization. Scraper log, crash dump, dan riwayat cursor bersih.
Ini adalah pola yang tepat ketika:
- Agen menghasilkan panggilan curl/HTTP ad-hoc selama sesi
- Alat yang dipanggil agen membuat panggilan HTTPS sendiri
- Anda ingin rahasia keluar dari jendela konteks percakapan sepenuhnya
Cursor CLI (mode agen dari skrip)
Cursor 1.x menyediakan CLI terpisah untuk eksekusi agen headless. Aturan HTTPS_PROXY yang sama berlaku — atur di shell sebelum pemanggilan:
$ export HTTPS_PROXY=http://localhost:1983 $ cursor-agent "deploy the latest tag to staging" --workspace ~/dev/myapp
Untuk pekerjaan yang berjalan lama, daftar putih IP token agen mengunci pembacaan kredensial ke host tempat agen berjalan. Jika dijalankan di tempat lain, brankas akan menolak.
Setiap akses dicatat
Log audit mencatat agen mana yang mengakses kredensial mana, kapan, dan dari mana. Aktivitas agen Cursor ditandai secara berbeda dari aktivitas manusia.
# TIME ACTION ENTRY ACTOR 2026-03-08 10:23:14 read anthropic cli:cursor 2026-03-08 10:23:15 read openai proxy:cursor 2026-03-08 11:45:02 read github-deploy cli:cursor 2026-03-08 14:12:33 render - cli:cursor