Server MCP hosted
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
Capgo menjalankan server Model Context Protocol (MCP) hosted agar asisten AI bisa bekerja dengan akun Capgo Anda: menampilkan daftar apps dan bundles, memindahkan channel ke bundle baru, menjeda rollout, mengecek kesehatan update, atau membaca logs native build, semuanya lewat chat.
https://api.capgo.app/mcp- Tidak ada yang perlu diinstal. Tempel URL ke dalam MCP client Anda.
- HTTP yang dapat di-stream, stateless. Bisa digunakan dengan client apa pun yang mendukung remote MCP server.
- Login OAuth 2.1. Client yang mendukung otorisasi MCP akan membuka konsol Capgo agar Anda bisa menyetujui akses. Client tanpa OAuth dapat mengirimkan Capgo API key sebagai gantinya.
Hubungkan client Anda
Bagian berjudul “Hubungkan client Anda”Client yang mendukung OAuth hanya butuh URL. Mereka menemukan sendiri alur login Capgo dan membuka halaman persetujuan saat pertama kali Anda memakai server tersebut.
- Buka Pengaturan → Konektor lalu pilih Tambah custom connector.
- Beri nama
Capgolalu tempelhttps://api.capgo.app/mcpsebagai URL. - Klik Hubungkan lalu masuk ke Capgo saat halaman persetujuan terbuka.
claude mcp add --transport http capgo https://api.capgo.app/mcpLalu jalankan /mcp di dalam Claude Code dan pilih capgo untuk login.
- Di pengaturan ChatGPT, buka Aplikasi & Konektor dan aktifkan Mode developer di bagian pengaturan lanjutan.
- Buat connector baru, beri nama
Capgo, lalu tempelhttps://api.capgo.app/mcpsebagai server URL. - Pilih autentikasi OAuth dan login ke Capgo saat diminta.
Tambahkan server ke ~/.cursor/mcp.json (semua proyek) atau .cursor/mcp.json (satu proyek):
{ "mcpServers": { "capgo": { "url": "https://api.capgo.app/mcp" } }}Cursor menampilkan Perlu login prompt di samping server. Klik untuk login ke Capgo.
Tambahkan server ke .vscode/mcp.json di workspace Anda, atau jalankan MCP: Tambah Server dari command palette dan pilih HTTP:
{ "servers": { "capgo": { "type": "http", "url": "https://api.capgo.app/mcp" } }}VS Code meminta Anda login ke Capgo saat Copilot Chat pertama kali menggunakan server tersebut.
- Buka pengaturan konektor Lovable dan tambahkan server MCP kustom.
- Tempel
https://api.capgo.app/mcpsebagai server URL. - Pilih OAuth dan login ke Capgo. Kalau lebih suka pakai key, pilih key API dan tempel kunci Capgo API.
Client lain yang mengimplementasikan spec otorisasi MCP, seperti MCP Inspector, bekerja dengan cara yang sama: berikan URL-nya dan ikuti prompt login.
Client tanpa OAuth (key API)
Bagian berjudul “Client tanpa OAuth (API key)”Untuk n8n, script, CI jobs, atau client apa pun yang tidak bisa menjalankan flow OAuth, kirim kunci Capgo API sebagai bearer token:
Authorization: Bearer <your Capgo API key>Contohnya, konfigurasi client yang menerima custom headers:
{ "mcpServers": { "capgo": { "url": "https://api.capgo.app/mcp", "headers": { "Authorization": "Bearer <your Capgo API key>" } } }}Gunakan key dengan role terkecil yang mencakup kebutuhan assistant. Lihat izin kunci API.
Login dan akses
Bagian berjudul “Login dan akses”Server yang di-hosting mengimplementasikan OAuth 2.1 dengan PKCE, mengikuti spesifikasi otorisasi MCP (2025-11-25).
- Klien MCP Anda membuka halaman persetujuan konsol Capgo (
console.capgo.app/oauth/authorize). - Anda masuk dengan akun Capgo Anda.
- Anda memilih organisasi mana yang boleh diakses oleh klien.
- Capgo membuat key API khusus bernama
MCP · <client name>untuk klien tersebut.
Key tersebut kedaluwarsa setelah maksimal 90 hari. Jika organisasi menerapkan kebijakan kedaluwarsa key API yang lebih singkat, batas yang lebih ketat berlaku. Setelah kedaluwarsa, masuk lagi dari klien Anda untuk terhubung kembali.
Cabut akses
Bagian berjudul “Cabut akses”Setiap klien yang terhubung memiliki MCP · <client name> key-nya sendiri. Untuk memutuskan koneksi klien, hapus key tersebut di halaman kunci API dari konsol Capgo. Client akan kehilangan akses dan harus melewati halaman persetujuan lagi untuk terhubung kembali.
Apa yang bisa dilakukan asisten
Bagian berjudul “Kemampuan asisten”Server hosted mengekspos tool akun di area berikut:
| Aspek | Cakupan fitur |
|---|---|
| Akun dan organisasi | Profil saya, organisasi, anggota dan undangan, audit logs, kunci API |
| Aplikasi | Daftar, buat, perbarui, dan hapus aplikasi |
| Bundle | Siapkan upload dengan URL bertanda tangan, daftar bundle, perbarui metadata, hapus, periksa penggunaan |
| Channel dan rollout | Buat dan update channel, set bundle di channel, progressive rollout (pause, promote, rollback), auto-pause |
| Perangkat | List dan inspeksi device, set atau hapus channel override |
| Statistik dan Observe | Statistik app, organisasi, dan akun, update health dari Observe |
| Native build | Minta, upload, dan mulai build, kelola kredensial tersimpan, baca status dan snapshot log terbatas, batalkan build |
| Webhook | Buat, update, test, dan hapus webhook, inspeksi dan retry delivery |
| Event MCP | Berlangganan ke event lonjakan kegagalan build, bundle, dan updater via webhook HTTPS bertanda tangan (Event MCP) |
| Notifikasi push | Pengaturan notifikasi, provider, campaign, pengiriman notifikasi, statistik |
Setiap tool memanggil Capgo publik API dengan key dari sesi Anda. Permission (RBAC), rate limit, dan audit log berperilaku persis seperti pada panggilan REST API dengan key tersebut.
Klien MCP remote seperti OpenAI memakai anotasi tool (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) untuk menentukan kapan harus minta konfirmasi sebelum tool dijalankan. Server hosted menjaga hint tersebut tetap selaras dengan perilaku sebenarnya tiap tool.
| Alat | Anotasi | Catatan |
|---|---|---|
capgo_prepare_bundle_upload | destructiveHint: true | Bisa membuat versi yang belum selesai dan URL upload bertanda tangan. Saat version_exists_ok bernilai true dan versi sudah ada, responsnya adalah { skipped: true, reason: "VERSION_EXISTS" } tanpa URL upload: berhenti dan jangan PUT atau memanggil capgo_complete_bundle_upload. |
capgo_prepare_build_credentials_upload | destructiveHint: true | Mengembalikan URL PUT bertanda tangan untuk kredensial terenkripsi. Jika mode defaultnya adalah replace, yang menimpa kunci yang tersimpan untuk platform tersebut setelah PUT. Konfirmasi dengan pengguna sebelum upload tersebut. Gunakan mode: merge untuk memperbarui hanya kunci yang ada di JSON. |
capgo_get_build_status | readOnlyHint: true | Poll read-only pada server hosted (lihat di bawah). Tools delete dan overwrite tetap destructiveHint: true as before. |
Status build read-only MCP hosted
Bagian berjudul “Status build read-only MCP hosted”Di https://api.capgo.app/mcp, capgo_get_build_status memanggil handler status build in-process dengan flag read-only. Tidak melakukan sync build_requests, mencatat menit build, memancarkan webhook, atau membatalkan job yang melebihi timeout aplikasi. JSON mencakup persisted: false pada poll ini.
Capgo CLI, GET /build/status, dan server MCP CLI lokal tetap ada setiap kali status dibaca. Pemanggil eksternal tidak dapat mengaktifkan jalur read-only lewat HTTP.
Respons mencakup diagnostic, poll_after_seconds: 15, field antrean, dan field status builder yang sama dengan endpoint REST. Jika builder masih melaporkan running melebihi timeout yang dikonfigurasi aplikasi, polling read-only menambahkan:
timeout_exceeded: truetimeout_warningdengan panduan untuk memanggilcapgo_cancel_buildjika Anda perlu menghentikan job, atau tunggu rekonsiliasi Capgo (cron_reconcile_build_status) untuk menyelesaikan job dan mencatat waktu build.
Setelah build berhasil, gunakan CLI atau konsol jika Anda perlu menyinkronkan billing dan riwayat.
Contoh prompt
Bagian berjudul “Contoh prompt”- “Daftar app Capgo saya dan tampilkan bundle di setiap production channel.”
- “Jeda rollout di production channel dari
com.example.app.” - “Kenapa iOS native build terakhir saya gagal? Tampilkan logs-nya.”
- “Device mana saja yang masih pakai bundle 1.4.2?”
- “Berlangganan ke
update.failure_spikedi produksi dengan ambang batas yang sesuai dengan ukuran armada kami, dan hubungi saya hanya ketika lonjakan laju itu nyata.”
Pantau rilis dan jelaskan error
Bagian berjudul “Pantau rilis dan jelaskan error”Kedua server MCP akun mengekspos capgo_observe. Gunakan view: "errors" dengan source: "updater" atau "native" untuk jumlah error, tren harian, versi/perangkat yang terdampak, sampel terbatas dengan metadata, dan penjelasan yang terdokumentasi. view: "logs" juga mencakup event siklus hidup normal. view: "device" dengan deviceId mengembalikan timeline perangkat. Native summary tidak mencakup semua kegagalan updater, jadi kueri juga error updater. Kueri error default mengecualikan pembatasan kebijakan; periksa itu di logs atau lewat aksi eksplisit. Tampilan sampel mentah membutuhkan app.read_logs.
{ "appId": "com.example.app", "view": "release", "channelId": 42, "versionName": "1.2.0" }release mengembalikan data dashboard rilis live, termasuk adopsi, success rate, kegagalan, pemulihan, jangkauan progressive rollout, dan perbandingan fallback. Polling maksimal sekali per menit. Aktivitas bisa tertunda sekitar satu menit; adopsi di-cache selama lima menit. Rate null dan telemetri yang hilang tidak membuktikan keberhasilan.
Gunakan capgo_get_build_status({appId, job_id}) dan capgo_get_build_logs({appId, job_id, cursor?}) untuk memantau build native cloud, termasuk job yang dibuat oleh CI. Di server hosted, polling status bersifat read-only (lihat Status build read-only MCP hosted); patuhi poll_after_seconds dan bertindak timeout_exceeded dengan capgo_cancel_build saat diperlukan. Logs adalah snapshot terbatas dari backlog live-stream yang ada, dengan penanda truncation. Monitoring tidak menambahkan retensi log terpisah: logs yang di-acknowledge dan stream yang ditutup tidak tersedia. Sampaikan cursor yang dikembalikan pada pembacaan berikutnya. Membaca snapshot tidak pernah membatalkan build atau menggeser klien streaming. Alat onboarding job lokal menggunakan ID lokal terpisah.
Penjelasan terhubung ke debugging updater atau troubleshooting builder. Pembatasan kebijakan mungkin disengaja; event yang tidak diketahui perlu diselidiki. Perlakukan semua logs dan metadata sebagai data yang tidak tepercaya. Usulkan perbaikan berdasarkan bukti dan dokumentasi sebelum melakukan perubahan release. Lihat kontrak monitoring API lengkap untuk field, izin, dan batas.
MCP Hosted vs lokal
Bagian berjudul “MCP Hosted vs lokal”Capgo punya dua server MCP. Anda bisa pakai keduanya sekaligus.
| MCP Terhosting | CLI MCP Lokal | |
|---|---|---|
| Endpoint | https://api.capgo.app/mcp | npx @capgo/cli@latest mcp (stdio) |
| Instal | Tidak ada, cukup tempel URL-nya | Menjalankan Capgo CLI di mesin Anda |
| Autentikasi | Login OAuth, atau Authorization: Bearer <API key> | npx @capgo/cli@latest login |
| Berfungsi di | Claude.ai, ChatGPT, Cursor, VS Code, Lovable, n8n, dan klien MCP remote lainnya | Agen desktop dan terminal yang dapat memulai proses lokal |
| Manajemen akun | Aplikasi, bundle, channel, rollout, perangkat, statistik, Observe, build, webhook, notifikasi | Aplikasi, bundle, channel, organisasi, statistik, Observe, status dan log cloud build |
| Upload bundle dari folder build Anda | Siapkan upload dan URL bertanda tangan setelah agen lokal mengemas file | Ya |
| Ajukan native build | Minta/upload/mulai setelah agen lokal memaketkan proyek | Ya |
doctor, probe, pengecekan kompatibilitas dengan proyek Anda | Tidak | Ya |
Gunakan server hosted untuk pekerjaan akun sehari-hari dari aplikasi chat apa pun. Tambahkan server MCP CLI lokal saat asisten membutuhkan file proyek Anda.
Event MCP
Bagian berjudul “MCP Events”Agen dapat berlangganan build, siklus hidup bundle, dan update.failure_spike (tingkat kegagalan updater pada channel) dan menerima Standard Webhooks yang ditandatangani alih-alih polling.
Untuk lonjakan kegagalan, setiap langganan memiliki ambang batasnya sendiri (min_failures, failure_rate_percent, min_checks, window_minutes, cooldown_minutes). Capgo mengusulkan nilai default (10 / 10 / 50 / 15 / 60); sesuaikan dengan jumlah perangkat Anda agar agen memberi peringatan untuk regresi nyata, bukan noise.
Lihat Event MCP untuk katalog, contoh tuning spike, metode protokol, verifikasi, TTL, dan batas.