---
type: reference
title: Referensi alat MCP
summary: Setiap alat MCP Caputchin, apa yang dilakukannya, dan izin yang harus dipegang token-nya, dikelompokkan per area.
---

Inilah alat yang dipaparkan [server MCP](/docs/automation/mcp), baik dalam bentuk lokal maupun terhosting. Masing-masing mem-proxy satu operasi [management API](/docs/automation/management-api), jadi izin yang dibutuhkan sebuah alat adalah izin yang dibutuhkan operasi itu; [token](/docs/automation/management-api#mint-an-access-token) agen harus memegangnya. Katalog dan deskripsi berasal dari server itu sendiri; untuk skema permintaan dan respons persis operasi di balik sebuah alat, lihat [referensi API interaktif](/docs/api-reference).

## Bagaimana izin bekerja di sini

Sebuah alat berjalan hanya jika token di baliknya diizinkan melakukan operasi yang mendasarinya. Kolom **Izin** memakai nilai-nilai ini, yang memetakan ke model [izin dan cakupan](/docs/troops/permissions) tim:

| Nilai | Berarti |
|---|---|
| **Account** | Token sah mana pun pada akun. Alat pencetak token dan kursi tambahan membutuhkan kredensial master-akun (sesi dasbor atau [personal access token](/docs/account-management/personal-access-token)); token tim tak bisa mencetak token atau kursi. |
| **read** | Izin `read`. Alat bercakupan-situs juga membutuhkan kunci situs berada di cakupan token. |
| **create** | Izin `create` pada tim (membuat kunci situs di dalamnya). |
| **edit** | Izin `edit`, tercakup ke kunci situs yang dituju alat. |
| **manage** | Izin `manage`: administrasi tim (anggota, token, pengaturan seluruh-tim). |

Beberapa alat juga butuh jenjang paket, dicatat di deskripsi: white-label adalah **Apex**, kustomisasi bahasa dan skin game adalah **Alpha ke atas**, dan log audit adalah **Apex**.

## Akun dan kesehatan

| Alat | Melakukan | Izin |
|---|---|---|
| `caputchin_ping` | Pemeriksaan kesehatan; mengembalikan id akun terselesaikan saat token sah. | Account |
| `caputchin_get_account` | Akun terautentikasi (id, email, paket). | Account |
| `caputchin_me_billing` | Ringkasan penagihan (paket, status, periode). | Account |
| `caputchin_get_seats` | Pemakaian kursi untuk akun (terpakai, total, rincian). | Account |

## Token dan kursi

| Alat | Melakukan | Izin |
|---|---|---|
| `caputchin_list_tokens` | Mendaftar token akun; tak pernah mengembalikan secret. | Account |
| `caputchin_create_token` | Mencetak token (`type` troop atau account); nilai dikembalikan sekali. | Account (master) |
| `caputchin_rotate_token` | Memutar secret sebuah token; nilai baru dikembalikan sekali. | Account (master) |
| `caputchin_revoke_token` | Mencabut sebuah token; berlaku seketika. | Account (master) |
| `caputchin_invite_seat_user` | Mengundang pengguna ke tim (sadar-kursi); memakai kursi jika baru. | Account (master) |
| `caputchin_remove_seat_user` | Menghapus pengguna dari setiap tim di akun. | Account (master) |
| `caputchin_mint_seat_pat` | Mencetak dan melekatkan token tim dalam satu panggilan; nilai dikembalikan sekali. | Account (master) |
| `caputchin_attach_seat_pat` | Melekatkan token tim yang ada ke tim lain. | Account (master) |
| `caputchin_revoke_seat_pat` | Mencabut token tim lintas akun. | Account (master) |

## Tim

| Alat | Melakukan | Izin |
|---|---|---|
| `caputchin_list_troops` | Mendaftar tim akun. | Account |
| `caputchin_get_troop` | Satu tim berdasarkan id. | read |
| `caputchin_create_troop` | Membuat tim bersama. | Account |
| `caputchin_rename_troop` | Mengganti nama tim. | manage |
| `caputchin_delete_troop` | Menghapus tim; menolak jika masih memiliki kunci situs. | manage |
| `caputchin_list_troop_members` | Anggota tim dengan izin dan cakupan mereka. | read |
| `caputchin_add_troop_member` | Menambah pengguna lewat email dengan izin dan cakupan; bisa memakai kursi. | manage |
| `caputchin_update_troop_member` | Mengubah izin atau cakupan anggota. | manage |
| `caputchin_remove_troop_member` | Menghapus anggota; membebaskan kursinya jika itu yang terakhir. | manage |
| `caputchin_list_troop_pats` | Token tim yang dilekatkan ke sebuah tim. | read |
| `caputchin_attach_troop_pat` | Melekatkan token tim dengan izin dan cakupan; memakai kursi. | manage |
| `caputchin_update_troop_pat` | Mengubah izin atau cakupan token yang dilekatkan. | manage |
| `caputchin_detach_troop_pat` | Melepaskan token tim; membebaskan kursinya. | manage |
| `caputchin_get_troop_security` | Pengaturan keamanan tim (plafon paksa-game plus default mode Pratinjau dan Pemakaian ulang verifikasi). | read |
| `caputchin_update_troop_security` | Menyetel plafon paksa-game dan default se-tim untuk mode Pratinjau dan Pemakaian ulang verifikasi. | manage |

## Kunci situs

| Alat | Melakukan | Izin |
|---|---|---|
| `caputchin_list_sites` | Semua kunci situs lintas tim akun. | read |
| `caputchin_get_site` | Satu kunci situs berdasarkan id. | read |
| `caputchin_create_site` | Membuat kunci situs (di tim, atau Personal); mengembalikan secret sekali-pakai. | create |
| `caputchin_update_site` | Memperbarui nama key atau flag nonaktif. | edit |
| `caputchin_delete_site` | Menghapus key; mengaskade sesi dan config. Tak bisa dibalik. | edit |
| `caputchin_rotate_site_secret` | Memutar secret; yang lama berhenti seketika; yang baru dikembalikan sekali. | edit |
| `caputchin_get_site_cap_config` | Config proof-of-work sebuah key. | read |
| `caputchin_update_site_cap_config` | Memperbarui config proof-of-work. | edit |
| `caputchin_get_site_security` | Pengaturan keamanan sebuah key (gerbang wajib-game, mode Pratinjau, dan Pemakaian ulang verifikasi). | read |
| `caputchin_update_site_security` | Menyalakan per-key gerbang wajib-game, mode Pratinjau, dan Pemakaian ulang verifikasi. | edit |
| `caputchin_list_site_sessions` | Sesi verifikasi terkini untuk sebuah key. | read |

## Verifikasi terhosting

| Alat | Melakukan | Izin |
|---|---|---|
| `caputchin_get_hosted_verification` | Config verifikasi-terhosting sebuah key. | read |
| `caputchin_set_hosted_verification` | Menyetel flag aktif dan tujuan. | edit |
| `caputchin_test_hosted_verification` | Menembakkan pengiriman sintetis ke tujuan yang dikonfigurasi. | edit |

## Statistik, pengiriman, dan log audit

| Alat | Melakukan | Izin |
|---|---|---|
| `caputchin_site_stats` | Statistik verifikasi situs sepanjang sebuah rentang. | read |
| `caputchin_site_stats_dashboard` | Gulungan dasbor statistik situs. | read |
| `caputchin_site_stats_activity` | Seri aktivitas statistik situs. | read |
| `caputchin_site_stats_durations` | Persentil waktu statistik situs. | read |
| `caputchin_site_stats_rejections` | Hitungan penolakan situs. | read |
| `caputchin_troop_stats` | Total seumur-hidup statistik tim. | read |
| `caputchin_troop_stats_dashboard` | Gulungan dasbor statistik tim. | read |
| `caputchin_troop_stats_activity` | Seri aktivitas statistik tim. | read |
| `caputchin_troop_stats_durations` | Persentil waktu statistik tim. | read |
| `caputchin_troop_stats_rejections` | Hitungan penolakan tim. | read |
| `caputchin_quick_stats_sites` | Cuplikan statistik ringkas per-situs lintas akun. | read |
| `caputchin_quick_stats_troops` | Cuplikan statistik ringkas per-tim lintas akun. | read |
| `caputchin_site_delivery_dashboard` | Statistik pengiriman verifikasi-terhosting untuk sebuah situs. Apex. | read |
| `caputchin_troop_delivery_dashboard` | Statistik pengiriman verifikasi-terhosting untuk sebuah tim. Apex. | read |
| `caputchin_account_audit_logs` | Log audit tingkat-akun. Apex. | Account |
| `caputchin_troop_audit_logs` | Log audit tim. Apex. | read |
| `caputchin_site_audit_logs` | Log audit kunci-situs. Apex. | read |

## Game marketplace

| Alat | Melakukan | Izin |
|---|---|---|
| `caputchin_list_games` | Mendaftar game marketplace. | Account |
| `caputchin_search_games` | Mencari game marketplace berdasarkan teks. | Account |
| `caputchin_get_game` | Satu game marketplace berdasarkan id. | Account |

## Kustomisasi game

Ini menargetkan sebuah cakupan (sebuah kunci situs atau sebuah tim), jadi perubahan bercakupan-situs butuh `edit` pada key itu dan perubahan seluruh-tim butuh `manage`. Kustomisasi bahasa dan skin adalah **Alpha ke atas**.

| Alat | Melakukan | Izin |
|---|---|---|
| `caputchin_list_customized_games` | Game terdaftar (terpasang) sebuah cakupan. | read |
| `caputchin_register_customized_game` | Mendaftarkan (memasang) sebuah game pada cakupan; memin snapshot. | edit (site) atau manage (troop) |
| `caputchin_repin_customized_game` | Memin ulang game terdaftar ke versi terbaru. | edit (site) atau manage (troop) |
| `caputchin_update_customized_game` | Memperbarui pengaturan game terdaftar (pembaruan otomatis). | edit (site) atau manage (troop) |
| `caputchin_delete_customized_game` | Mencopot game terdaftar dari sebuah cakupan. | edit (site) atau manage (troop) |
| `caputchin_list_game_presets` | Preset kustomisasi untuk sebuah cakupan dan game. | read |
| `caputchin_set_game_preset` | Membuat atau memperbarui preset game. Alpha+. | edit (site) atau manage (troop) |
| `caputchin_delete_game_preset` | Menghapus preset game. Alpha+. | edit (site) atau manage (troop) |
| `caputchin_set_game_default` | Menyetel preset game baku untuk sebuah sumbu. Alpha+. | edit (site) atau manage (troop) |
| `caputchin_get_custom_game_schema` | Skema bidang sebuah game kustom untuk sebuah cakupan. | read |
| `caputchin_set_custom_game_schema` | Menyetel skema bidang sebuah game kustom. Alpha+. | edit (site) atau manage (troop) |
| `caputchin_delete_custom_game_schema` | Menghapus skema bidang sebuah game kustom. Alpha+. | edit (site) atau manage (troop) |
| `caputchin_upload_custom_game_run` | Mengunggah artefak run headless sebuah game kustom. | edit (site) atau manage (troop) |
| `caputchin_get_custom_game_run` | Mengambil rujukan artefak run tersimpan sebuah game kustom. | read |
| `caputchin_delete_custom_game_run` | Menghapus artefak run sebuah game kustom. | edit (site) atau manage (troop) |

## White-label

White-label shell widget adalah fitur **Apex**. Seperti kustomisasi game, perubahan bercakupan-situs butuh `edit` dan yang seluruh-tim butuh `manage`.

| Alat | Melakukan | Izin |
|---|---|---|
| `caputchin_list_white_label_presets` | Preset white-label untuk sebuah cakupan. | read |
| `caputchin_set_white_label_preset` | Membuat atau memperbarui preset white-label. Apex. | edit (site) atau manage (troop) |
| `caputchin_delete_white_label_preset` | Menghapus preset white-label. Apex. | edit (site) atau manage (troop) |
| `caputchin_set_white_label_default` | Menyetel preset white-label baku untuk sebuah sumbu. Apex. | edit (site) atau manage (troop) |

## Lihat juga

- [Pakai server MCP](/docs/automation/mcp): menghubungkan agen lewat salah satu transport.
- [Izin dan cakupan](/docs/troops/permissions): model read / create / edit / manage yang dipakai tabel di atas.
- [Referensi API interaktif](/docs/api-reference): skema persis operasi di balik tiap alat.