Langsung ke konten

Server MCP hosted

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.

Client yang mendukung OAuth hanya butuh URL. Mereka menemukan sendiri alur login Capgo dan membuka halaman persetujuan saat pertama kali Anda memakai server tersebut.

  1. Buka Pengaturan → Konektor lalu pilih Tambah custom connector.
  2. Beri nama Capgo lalu tempel https://api.capgo.app/mcp sebagai URL.
  3. Klik Hubungkan lalu masuk ke Capgo saat halaman persetujuan terbuka.

Client lain yang mengimplementasikan spec otorisasi MCP, seperti MCP Inspector, bekerja dengan cara yang sama: berikan URL-nya dan ikuti prompt login.

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.

Server yang di-hosting mengimplementasikan OAuth 2.1 dengan PKCE, mengikuti spesifikasi otorisasi MCP (2025-11-25).

  1. Klien MCP Anda membuka halaman persetujuan konsol Capgo (console.capgo.app/oauth/authorize).
  2. Anda masuk dengan akun Capgo Anda.
  3. Anda memilih organisasi mana yang boleh diakses oleh klien.
  4. 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.

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:

AspekCakupan fitur
Akun dan organisasiProfil saya, organisasi, anggota dan undangan, audit logs, kunci API
AplikasiDaftar, buat, perbarui, dan hapus aplikasi
BundleSiapkan upload dengan URL bertanda tangan, daftar bundle, perbarui metadata, hapus, periksa penggunaan
Channel dan rolloutBuat dan update channel, set bundle di channel, progressive rollout (pause, promote, rollback), auto-pause
PerangkatList dan inspeksi device, set atau hapus channel override
Statistik dan ObserveStatistik app, organisasi, dan akun, update health dari Observe
Native buildMinta, upload, dan mulai build, kelola kredensial tersimpan, baca status dan snapshot log terbatas, batalkan build
WebhookBuat, update, test, dan hapus webhook, inspeksi dan retry delivery
Event MCPBerlangganan ke event lonjakan kegagalan build, bundle, dan updater via webhook HTTPS bertanda tangan (Event MCP)
Notifikasi pushPengaturan 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.

AlatAnotasiCatatan
capgo_prepare_bundle_uploaddestructiveHint: trueBisa 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_uploaddestructiveHint: trueMengembalikan 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_statusreadOnlyHint: truePoll read-only pada server hosted (lihat di bawah). Tools delete dan overwrite tetap destructiveHint: true as before.

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: true
  • timeout_warning dengan panduan untuk memanggil capgo_cancel_build jika 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.

  • “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_spike di produksi dengan ambang batas yang sesuai dengan ukuran armada kami, dan hubungi saya hanya ketika lonjakan laju itu nyata.”

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.

Capgo punya dua server MCP. Anda bisa pakai keduanya sekaligus.

MCP TerhostingCLI MCP Lokal
Endpointhttps://api.capgo.app/mcpnpx @capgo/cli@latest mcp (stdio)
InstalTidak ada, cukup tempel URL-nyaMenjalankan Capgo CLI di mesin Anda
AutentikasiLogin OAuth, atau Authorization: Bearer <API key>npx @capgo/cli@latest login
Berfungsi diClaude.ai, ChatGPT, Cursor, VS Code, Lovable, n8n, dan klien MCP remote lainnyaAgen desktop dan terminal yang dapat memulai proses lokal
Manajemen akunAplikasi, bundle, channel, rollout, perangkat, statistik, Observe, build, webhook, notifikasiAplikasi, bundle, channel, organisasi, statistik, Observe, status dan log cloud build
Upload bundle dari folder build AndaSiapkan upload dan URL bertanda tangan setelah agen lokal mengemas fileYa
Ajukan native buildMinta/upload/mulai setelah agen lokal memaketkan proyekYa
doctor, probe, pengecekan kompatibilitas dengan proyek AndaTidakYa

Gunakan server hosted untuk pekerjaan akun sehari-hari dari aplikasi chat apa pun. Tambahkan server MCP CLI lokal saat asisten membutuhkan file proyek Anda.

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.