Pakai server MCP

Server MCP Caputchin membiarkan agen AI (Claude, Cursor, atau klien Model Context Protocol mana pun) mengelola akunmu dengan memanggil management API yang sama yang dipakai dasbor. Server adalah shell transport-dan-auth yang tipis: ia memaparkan satu alat MCP per operasi manajemen dan mem-proxy tiap panggilan ke API. Jadi agen bisa melakukan apa pun yang bisa kamu lakukan, selain penagihan, dalam bahasa alami.

Cetak sebuah access token

Server berautentikasi dengan sebuah access token dari variabel lingkungan CAPUTCHIN_TOKEN. Salah satu jenis berfungsi (lihat autentikasi API):

• sebuah personal access token untuk kendali seluruh-akun, atau
• sebuah troop access token untuk mencakupkan agen ke tim tertentu dengan hak-paling-kecil, yang merupakan default lebih aman saat menyerahkan akses ke agen otonom.

Salin token saat pembuatan; ia ditunjukkan sekali.

Dua cara menghubungkan

Ada dua transport, dan mereka memaparkan alat yang sama yang didukung management API yang sama. Pilih berdasarkan cara klienmu terhubung:

Lokal: server npx (stdio)

Server dipublikasikan sebagai @caputchin/mcp di npm. Kamu biasanya tak menjalankannya dengan tangan; kamu menyambungkannya ke config klien MCP-mu dan ia dimunculkan lewat stdio, dengan token di lingkungannya:

{
  "mcpServers": {
    "caputchin": {
      "command": "npx",
      "args": ["-y", "@caputchin/mcp"],
      "env": { "CAPUTCHIN_TOKEN": "cpt_pat_..." }
    }
  }
}

Untuk memeriksa ia berjalan, luncurkan langsung; ia berbicara MCP lewat stdio dan keluar dengan galat jika token hilang:

CAPUTCHIN_TOKEN=cpt_pat_... npx -y @caputchin/mcp

Terhosting: endpoint HTTP

Untuk klien yang terhubung ke server MCP jarak jauh alih-alih memunculkan satu yang lokal, Caputchin menghosting server yang sama di:

https://caputchin.com/api/mcp

Ia berautentikasi dengan token-mu sebagai header Bearer pada koneksi (kredensial yang sama, hanya dilewatkan lewat HTTP ketimbang lingkungan):

{
  "mcpServers": {
    "caputchin": {
      "url": "https://caputchin.com/api/mcp",
      "headers": { "Authorization": "Bearer cpt_pat_..." }
    }
  }
}

Bentuk config persisnya bergantung pada klien MCP-mu; yang penting adalah URL dan header Authorization: Bearer. Tak ada yang perlu dipasang, dan tanpa proses lokal; tukar-tambahnya adalah token berjalan ke endpoint terhosting per permintaan ketimbang tinggal di lingkungan proses lokal.

Alat-alatnya

Tiap alat dinamai caputchin_<verb>_<noun> dan memetakan ke satu operasi manajemen, misalnya caputchin_list_troops, caputchin_create_site, caputchin_rotate_site_secret, caputchin_add_troop_member, caputchin_site_stats. Agen menemukan set lengkap dan parameter tiap alat secara otomatis lewat MCP, jadi kamu menjelaskan tujuannya dan agen memilih alatnya.

Contoh kerja

Dengan server tersambung ke klienmu, kamu bisa meminta agen dalam bahasa biasa:

"Buat kunci situs bernama shop-frontend di tim shop-team-ku, lalu nyalakan gerbang game untuknya."

Agen menyelesaikannya menjadi urutan panggilan alat: caputchin_list_troops untuk menemukan id tim, caputchin_create_site dengan troop_id itu, lalu caputchin_update_site_security untuk mewajibkan sebuah game. Tiap panggilan menghantam management API di bawah token-mu, dan di Apex masing-masing mendarat di log audit-mu yang diatribusikan ke token, jadi tindakan agen seperti bisa dilacaknya tindakan seseorang.

Karena agen bertindak dengan jangkauan penuh token-mu, lebih baik pilih token tim tercakup saat kamu bisa, dan cabut ia begitu tugas selesai.

Referensi lengkap

Untuk daftar lengkap alat, masing-masing dengan deskripsi satu-baris dan izin yang harus dipegang token-nya, lihat referensi alat MCP. Alat mencerminkan management API satu-lawan-satu, jadi referensi API interaktif adalah deskripsi otoritatif parameter dan respons tiap operasi: baca deskripsi MCP sebuah alat untuk ringkasan menghadap-agen, dan referensi API untuk skema persisnya.

Lihat juga

• Referensi alat MCP: tiap alat, deskripsinya, dan izin yang dibutuhkannya.
• Kelola Caputchin dari API: API HTTP yang dipanggil tiap alat.
• Pakai Terraform atau OpenTofu: permukaan infrastructure-as-code.
• Personal access token dan token tim: kredensial yang dipakai server.