Cursor Composer 2.5 cukup cepat dan murah untuk memungkinkan agen menulis seluruh klien API dan pengendali rute untuk Anda. Masalah muncul saat kode menyentuh layanan nyata: model menulis permintaan yang terlihat bersih ke /v2/orders padahal layanan Anda sebenarnya mengekspos /orders dan mengharapkan payload yang berbeda. Kode tersebut terkompilasi. Hanya saja tidak berfungsi, dan Anda mengetahuinya tiga file kemudian.
Panduan ini menunjukkan alur kerja yang memperbaiki hal tersebut: arahkan Composer 2.5 ke spesifikasi API Anda yang sebenarnya melalui MCP, biarkan ia menghasilkan kode sesuai kontrak yang sebenarnya, lalu verifikasi hasilnya di Apidog sebelum sampai ke rekan satu tim. Jika Anda baru mengenal model ini, panduan Cursor Composer 2.5 membahas apa itu dan cara mengaksesnya.
tombol
Mengapa Model Agentik Menerka Bentuk API
Composer 2.5 dibangun untuk tugas agen yang panjang dan multi-langkah. Minta ia untuk "menambahkan klien untuk layanan penagihan kami dan menghubungkannya ke alur checkout" dan ia akan merencanakan, mengedit beberapa file, dan menjalankan tes hingga lulus. Itu adalah peningkatan dari Composer 2, dan ini benar-benar berguna.
Kelemahannya bersifat struktural, bukan bug. Ketika model tidak memiliki kontrak API Anda dalam konteks, ia mengisi kekosongan tersebut dengan bentuk yang paling mungkin secara statistik: nama bidang umum, konvensi REST, awalan versi yang paling sering dilihat dalam pelatihan. Outputnya terlihat benar. Lolos lint. Gagal terhadap server Anda karena server Anda bukanlah rata-rata setiap API di internet.
Tiga gejala dari hal ini:
- Endpoint yang hampir cocok (
/api/users/{id}vs/users/{userId}Anda). - Bidang yang dibuat-buat atau salah dalam badan permintaan.
- Otentikasi ditangani secara generik alih-alih skema aktual layanan Anda.
Anda bisa mengatasi sebagiannya dengan prompt, tetapi menempel seluruh file OpenAPI Anda ke dalam obrolan tidak stabil dan menghabiskan konteks. Perbaikan yang tahan lama adalah memberikan akses terstruktur model ke spesifikasi.
Perbaikan: Arahkan Composer 2.5 ke Spesifikasi API Nyata Anda melalui MCP
Model Context Protocol (MCP) adalah standar terbuka untuk menyediakan alat dan data ke model AI. Cursor mendukung server MCP, dan server MCP Apidog mengekspos spesifikasi API Apidog Anda ke model sebagai sumber terstruktur yang dapat ia tanyakan saat melakukan pengkodean.
Perbedaan dalam praktiknya: alih-alih menerka, Composer 2.5 membaca endpoint, skema, parameter, dan bentuk respons Anda yang sebenarnya, lalu menulis kode sesuai dengan itu. Ini adalah ide yang sama di balik "vibe coding" dengan server MCP Apidog, diterapkan pada model yang kini cukup kuat untuk melakukan seluruh tugas.
Langkah 1: Siapkan spesifikasi API Anda di Apidog
Kontrak API Anda perlu berada di suatu tempat yang dapat dibaca oleh model. Desain atau impor API Anda di Apidog sehingga skema, endpoint, dan contohnya mutakhir. Jika Anda memulai dari dokumen yang sudah ada, Apidog mengimpor koleksi OpenAPI dan Postman secara langsung. Spesifikasi adalah sumber kebenaran yang akan diikuti model, jadi menjaganya tetap akurat adalah keseluruhan permainannya.
Langkah 2: Sambungkan server MCP Apidog ke Cursor
Cursor membaca server MCP dari file konfigurasi di proyek Anda (umumnya .cursor/mcp.json). Server MCP Apidog berjalan melalui npx dan menunjuk ke proyek Anda. Konfigurasi tipikal terlihat seperti ini:
{
"mcpServers": {
"apidog-api-spec": {
"command": "npx",
"args": ["-y", "apidog-mcp-server@latest", "--project=<id-proyek-anda>"],
"env": { "APIDOG_ACCESS_TOKEN": "<token-akses-anda>" }
}
}
}
Gunakan perintah, ID proyek, dan token yang persis sama dari panduan pengaturan MCP Apidog, karena nilai-nilai tersebut spesifik untuk akun Anda dan versi server. Mulai ulang Cursor setelah menyimpan agar ia mengambil server baru.
Langkah 3: Konfirmasi Composer 2.5 dapat melihat spesifikasi
Buka sesi agen, pilih composer-2.5 di pemilih model, dan ajukan pertanyaan hanya-baca terlebih dahulu:
"Menggunakan server MCP apidog-api-spec, daftar endpoint di bawah sumber daya orders dan bidang yang diperlukan untuk membuat order."
Jika ia mengembalikan endpoint dan bidang Anda yang sebenarnya, koneksi berfungsi. Jika ia menjawab dari pengetahuan umum, server tidak terhubung; periksa kembali konfigurasi dan mulai ulang.
Langkah 4: Biarkan ia membangun sesuai kontrak
Sekarang berikan tugas sebenarnya dan sebutkan spesifikasi secara eksplisit:
"Menggunakan server apidog-api-spec sebagai sumber kebenaran, tulis klien TypeScript yang di-typed untuk API orders, termasuk panggilan create-order dan get-order. Cocokkan skema permintaan dan respons secara tepat. Tambahkan penanganan kesalahan untuk respons validasi 422 yang didefinisikan spesifikasi."
Karena Composer 2.5 mampu mempertahankan tugas yang panjang dengan baik, ia dapat melakukan ini di beberapa file dan menjaga konsistensi kontrak. Menyebutkan sumber MCP dalam prompt menjaganya tetap berlabuh alih-alih kembali ke asumsi.
Verifikasi sebelum Anda percaya: siklus pengujian Apidog
Mengaitkan model sangat mengurangi halusinasi. Ini tidak membuat verifikasi menjadi opsional. Spesifikasi bisa sedikit tertinggal dari layanan yang berjalan, dan model masih bisa salah membaca kasus tepi.
Tutup siklusnya:
- Kirim panggilan yang dihasilkan sebagai permintaan nyata. Ambil endpoint yang ditulis Composer 2.5 dan jalankan di Apidog terhadap lingkungan nyata atau tiruan (mock). Periksa kode status, badan respons, dan otentikasi berfungsi seperti yang diasumsikan kode.
- Ubah panggilan yang berfungsi menjadi tes. Simpan permintaan yang divalidasi sebagai skenario tes otomatis sehingga regresi berikutnya ditangkap oleh CI, bukan oleh pengguna.
- Tirukan (mock) apa yang belum dibuat. Jika model menulis klien untuk endpoint yang belum dikirim oleh backend, server mock Apidog mengembalikan respons yang realistis sehingga pekerjaan frontend terus berlanjut. Ini cocok dengan pola dalam agen AI dan pengujian API.
Prinsipnya: model menulis draf pertama berdasarkan kontrak, dan Anda mengonfirmasi draf tersebut berfungsi terhadap server nyata. Kecepatan dari agen hanya akan berlipat ganda jika Anda tidak membayarnya kembali dalam proses debugging nanti.
Contoh menyeluruh yang realistis
Misalnya Anda menambahkan fitur pengembalian dana ke layanan pembayaran.
- Endpoint dan skema pengembalian dana sudah ada di proyek Apidog Anda dari fase desain.
- Apidog MCP terhubung ke Cursor; Composer 2.5 dipilih.
- Anda memberi prompt: "Menggunakan apidog-api-spec, bangun klien pengembalian dana dan sebuah React hook yang memanggilnya. Ikuti skema persis, termasuk header idempotency-key yang disyaratkan spesifikasi."
- Composer 2.5 membaca kontrak nyata, menulis klien, hook, dan tipe, serta menjalankan tes proyek.
- Anda membuka Apidog, mengirim permintaan create-refund nyata, mengonfirmasi perilaku idempotensi dan 409 pada duplikat, lalu menyimpan keduanya sebagai skenario tes.
Apa yang Anda hindari: klien yang lupa header idempotensi, dikirim, dan melakukan pengembalian dana ganda kepada pelanggan di staging. Itu adalah jenis bug yang dihilangkan oleh penanaman + verifikasi.
Pertanyaan yang Sering Diajukan
Apakah Composer 2.5 mendukung MCP? Ya. Ia memiliki akses ke seluruh set alat agen Cursor, termasuk server MCP. Pilih di pemilih model dan konfigurasikan server di proyek Anda. Panduan Composer 2.5 mencakup pemilihan model.
Apakah saya memerlukan Apidog untuk menggunakan MCP dengan Composer 2.5? Anda memerlukan sumber spesifikasi terstruktur. Server MCP Apidog adalah jalur yang dibahas di sini karena juga memberi Anda pengujian dan mocking di tempat yang sama. Opsi lain ada dalam rangkuman server MCP terbaik untuk Cursor.
Akankah menambatkan model pada spesifikasi menghentikan semua halusinasi? Ini menghilangkan kategori terbesar, yaitu endpoint dan skema yang salah, karena model membaca kontrak nyata alih-alih menerka. Ini tidak menggantikan pengujian; spesifikasi dapat bergeser dari layanan yang berjalan, jadi Anda tetap perlu memverifikasi.
Apakah ini sepadan untuk proyek kecil? Jika model menyentuh API nyata mana pun, ya. Pengaturannya adalah file konfigurasi sekali pakai. Imbalannya adalah setiap panggilan yang dihasilkan sesuai dengan kontrak Anda, bukan tebakan yang masuk akal.
Intinya
Composer 2.5 cukup cepat dan murah untuk memungkinkan agen mengerjakan pekerjaan API yang nyata. Itu hanya akan membuahkan hasil jika model membuat kode sesuai kontrak Anda yang sebenarnya alih-alih tebakan rata-rata. Hubungkan spesifikasi Anda melalui server MCP Apidog agar Composer 2.5 membaca kebenaran, lalu Unduh Apidog untuk mengirim permintaan langsung, mengonfirmasi respons, dan mengunci panggilan yang berfungsi menjadi tes otomatis dan tiruan (mock). Generasi yang berbasiskan kebenaran ditambah verifikasi adalah alur kerja yang mengubah kecepatan agen menjadi fitur yang siap dikirim.