---
type: how-to
title: Pakai server MCP
summary: Hubungkan agen AI ke Caputchin lewat server MCP, autentikasi ia dengan access token, dan kemudikan management API dalam bahasa alami, dengan contoh kerja.
---

Server MCP Caputchin membiarkan agen AI (Claude, Cursor, atau klien [Model Context Protocol](https://modelcontextprotocol.io) mana pun) mengelola akunmu dengan memanggil [management API](/docs/automation/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 [#mint-an-access-token]

Server berautentikasi dengan sebuah access token dari variabel lingkungan `CAPUTCHIN_TOKEN`. Salah satu jenis berfungsi (lihat [autentikasi API](/docs/automation/management-api#mint-an-access-token)):

- sebuah [personal access token](/docs/account-management/personal-access-token) untuk kendali seluruh-akun, atau
- sebuah [troop access token](/docs/troops/tokens) 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 (stdio) | Terhosting (HTTP) |
|---|---|---|
| Apa itu | Paket `@caputchin/mcp`, dijalankan di mesinmu | Sebuah endpoint jarak jauh di `api.caputchin.com/mcp` |
| Klien butuh | Memunculkan proses lokal (stdio) | Terhubung ke server MCP jarak jauh (HTTP) |
| Auth | `CAPUTCHIN_TOKEN` di lingkungan proses | Header `Authorization: Bearer` pada koneksi |
| Terbaik saat | Dev lokal, klien desktop, tanpa jaringan masuk | Agen terhosting, tanpa proses lokal untuk dimunculkan |

### 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:

```json
{
  "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:

```bash
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://api.caputchin.com/mcp
```

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

```json
{
  "mcpServers": {
    "caputchin": {
      "url": "https://api.caputchin.com/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](/docs/audit-logs/overview)-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](/docs/automation/mcp-tools). Alat mencerminkan management API satu-lawan-satu, jadi [referensi API interaktif](/docs/api-reference) 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](/docs/automation/mcp-tools): tiap alat, deskripsinya, dan izin yang dibutuhkannya.
- [Kelola Caputchin dari API](/docs/automation/management-api): API HTTP yang dipanggil tiap alat.
- [Pakai Terraform atau OpenTofu](/docs/automation/terraform): permukaan infrastructure-as-code.
- [Personal access token](/docs/account-management/personal-access-token) dan [token tim](/docs/troops/tokens): kredensial yang dipakai server.