> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Toolset MCP Didit dan Mode Baca-Saja

> Muat hanya tool MCP Didit yang Anda butuhkan dengan toolset, hubungkan dalam mode baca-saja, dan akses tool lain sesuai kebutuhan lewat pencarian tool.

Toolset memungkinkan koneksi Didit MCP memuat daftar alat yang singkat alih-alih seluruh katalog, dan mode hanya baca memberi Anda koneksi yang tidak pernah dapat mengubah data.

Keduanya berupa parameter pada URL server:

```text theme={null}
https://mcp.didit.me/mcp?toolsets=core
https://mcp.didit.me/mcp?read_only=true
```

Tanpa parameter, server menampilkan setiap alat yang boleh digunakan oleh peran Anda, sehingga tidak ada yang berubah untuk koneksi yang sudah Anda miliki.

## Mengapa memuat lebih sedikit alat

Klien Anda mengirimkan definisi setiap alat yang terdaftar ke model sebelum pertanyaan pertama Anda.
Untuk seluruh katalog Didit, itu berarti puluhan ribu token pada setiap permintaan: sekitar 50.000 hingga 115.000, bergantung pada tokenizer model.
Beberapa klien juga membatasi jumlah alat yang dapat mereka terima.

| Yang dimuat oleh koneksi | Alat yang terdaftar | Porsi dari token tersebut |
| - | - | - |
| Semua (tanpa parameter) | Setiap alat yang dapat digunakan oleh peran Anda | Semuanya |
| Daftar singkat, `core` | Sekitar 30 | Sekitar sepersepuluh |
| Daftar singkat, hanya-baca | Sekitar 20 | Kurang dari sepersepuluh |

Konsekuensinya adalah satu langkah tambahan.
Alat di luar daftar tidak hilang, tetapi model harus menemukannya dengan [pencarian alat](#menjangkau-tool-yang-tidak-anda-muat) sebelum dapat menjalankannya, dan model yang melihat semua alat memilih alat yang tepat sedikit lebih sering daripada model yang harus mencari.
Muat semua alat ketika percakapan mencakup banyak area dan biaya konteks tidak menjadi masalah.
Muat `core`, ditambah kumpulan alat yang paling sering Anda gunakan, ketika hal itu menjadi masalah.

## Pilih toolset Anda

Tambahkan `toolsets` ke URL server dengan daftar yang dipisahkan koma:

```text theme={null}
https://mcp.didit.me/mcp?toolsets=core
https://mcp.didit.me/mcp?toolsets=core,workflows
https://mcp.didit.me/mcp?toolsets=core,transactions,cases
```

`core` adalah daftar singkat yang menjadi titik awal sebagian besar pekerjaan.
Toolset ini mencakup organisasi dan aplikasi Anda, sesi verifikasi (membuat, mencari, memutuskan, menjelaskan, mensimulasikan di sandbox, membaca pengiriman webhook), mencari alur kerja, analitik dan saldo, kunci API dan webhook aplikasi Anda, mencari kasus, pengguna, bisnis dan transaksi, serta pencarian dokumentasi.

* `core`: daftar singkat di atas.
* `account`: organisasi, aplikasi, kunci API, anggota, dan peran.
* `billing`: paket, saldo kredit, metode pembayaran, kuitansi, dan detail penagihan.
* `sessions`: sesi verifikasi (membuat, mencari, memutuskan, meninjau, membagikan, mengimpor, PDF, dan pengiriman webhook).
* `workflows`: alur kerja verifikasi dan kuesioner (membangun, mengedit, memvalidasi, dan mempublikasikan).
* `lists`: daftar kustom, daftar blokir, dan daftar izin.
* `vendors`: orang dan perusahaan yang Anda verifikasi (pengguna vendor dan bisnis vendor).
* `transactions`: pemantauan transaksi (transaksi, Skrining Dompet, dan aturan dengan backtesting).
* `cases`: Manajemen Kasus (membuat, menugaskan, mengeskalasi, dan menyelesaikan kasus).
* `investigator`: Investigator (antrean peninjauannya, laporan, keputusan, pertanyaan kebijakan, dan kinerja).
* `webhooks`: tujuan webhook dan alert.
* `reports`: analitik, ekspor, dan log audit.
* `branding`: branding White Label untuk alur verifikasi.
* `verification`: API verifikasi mandiri (dokumen identitas, wajah, AML, Bukti Alamat, telepon, email, Validasi Database, dan pemeriksaan bisnis).
* `travel_rule`: Travel Rule (pengaturan, direktori VASP, jaringan, alamat, transfer, dan pesan).
* `marketplace`: marketplace penyedia (katalog, koneksi Anda, dan permintaan integrasi).
* `networks`: jaringan penipuan (sesi, pengguna, dan bisnis yang terhubung karena berbagi perangkat, dokumen, atau kontak).
* `compliance`: asisten kepatuhan (profil regulasi Anda, persyaratannya, dan alur kerja yang dihasilkan darinya).
* `docs`: pencarian dokumentasi Didit.
* `all`: setiap tool yang boleh digunakan oleh peran Anda. Ini adalah bawaan.

[Referensi tool](https://docs.didit.me/id/integration/mcp/tools.md) mencantumkan setiap tool beserta jenisnya dan izin peran yang dibutuhkannya.

Cara kerja pemilihan:

* **Toolset harus diaktifkan secara eksplisit.** URL tanpa `toolsets` mencantumkan semua tool.
* **Menyebutkan toolset mencantumkan persis toolset tersebut.** `?toolsets=cases` mencantumkan tool kasus, ditambah `didit_context_get`, yang didapat setiap koneksi. Tambahkan `core` untuk tetap menyertakan daftar singkat.
* **Toolset menentukan apa yang dicantumkan, bukan apa yang boleh Anda jalankan.** Tool di luar pilihan Anda tetap berjalan ketika model memanggilnya berdasarkan nama, dengan izin peran yang sama seperti biasa.
* **Nama yang tidak dikenali server akan diabaikan.** Koneksi tetap berfungsi, dan server memberi tahu model nama mana yang diabaikan serta nama mana yang valid.
* **Peran Anda tetap berlaku.** Toolset tidak pernah memberikan izin: lihat [peran dan izin](https://docs.didit.me/id/integration/mcp/authentication.md#peran-dan-izin).

## Hubungkan dalam mode hanya baca

Tambahkan `read_only=true` ke URL server:

```text theme={null}
https://mcp.didit.me/mcp?read_only=true
https://mcp.didit.me/mcp?toolsets=core,reports&read_only=true
```

Koneksi hanya baca hanya mencantumkan tool yang membaca data, dan server menolak setiap panggilan yang akan membuat, mengubah, atau menghapus sesuatu.
Penolakan dilakukan di server untuk setiap panggilan, sehingga tetap berlaku meskipun klien Anda masih mengingat tool dari koneksi sebelumnya.
Gunakan mode ini untuk pelaporan, untuk menelusuri akun, atau untuk agen yang tidak ingin Anda biarkan bertindak sendiri.

Untuk mengizinkan perubahan lagi, hubungkan tanpa `read_only`.

## Menjangkau tool yang tidak Anda muat

Saat sebuah koneksi hanya mencantumkan sebagian katalog, server menambahkan empat tool agar tidak ada yang berada di luar jangkauan:

* `didit_tool_search` (baca): menemukan tool berdasarkan apa yang ingin Anda lakukan ("ekspor sesi ke CSV"), atau menampilkan satu toolset. Setiap hasil menjelaskan apa yang dilakukan tool tersebut, parameternya, dan apakah tool itu membaca, menulis, atau bersifat destruktif.
* `didit_tool_describe` (baca): mengembalikan deskripsi lengkap dan skema input dari hingga lima tool.
* `didit_tool_call_read` (baca): menjalankan tool hanya-baca yang tidak ada dalam daftar. Tool yang mengubah data akan ditolak.
* `didit_tool_call_write` (destruktif): menjalankan tool yang membuat, mengubah, atau menghapus data dan tidak ada dalam daftar. Tidak tersedia pada koneksi hanya-baca.

Panggilan melalui `didit_tool_call_read` atau `didit_tool_call_write` diperiksa persis seperti panggilan langsung: izin peran Anda, mode hanya-baca, dan setiap syarat `confirm: true` tetap berlaku.
Keduanya dipisah agar klien Anda dapat meminta persetujuan Anda sebelum perubahan dan tetap mengizinkan pencarian.

Dengan `core` dimuat, permintaan seperti "undang anggota tim baru ke organisasi saya" berjalan sebagai berikut:

1. Model memanggil `didit_tool_search` dengan `invite a teammate` dan mendapatkan `didit_org_invite_member`, yang ditandai sebagai operasi tulis.
2. Model memanggil `didit_tool_call_write`, dengan meneruskan `didit_org_invite_member` sebagai `name` beserta argumen milik tool tersebut.
3. Klien Anda meminta persetujuan Anda, seperti halnya untuk tool apa pun yang mengubah data.

Jika semuanya sudah dimuat, tidak ada yang perlu ditemukan lagi, sehingga keempat tool ini tidak dicantumkan.

## Atur di klien Anda

Gunakan langkah yang sama seperti di [panduan instalasi](https://docs.didit.me/id/integration/mcp/installation.md), dengan parameter yang ditambahkan ke URL.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http didit "https://mcp.didit.me/mcp?toolsets=core"
> ```
>
> Pertahankan tanda kutip: jika tidak, shell Anda sendiri akan membaca `?` dan `&`.

> [tab] Codex
>
> ```bash theme={null}
> codex mcp add didit --url "https://mcp.didit.me/mcp?toolsets=core"
> ```

> [tab] Cursor
>
> Di `~/.cursor/mcp.json`:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "didit": {
>       "url": "https://mcp.didit.me/mcp?toolsets=core"
>     }
>   }
> }
> ```

> [tab] VS Code
>
> Di `.vscode/mcp.json`:
>
> ```json theme={null}
> {
>   "servers": {
>     "didit": {
>       "type": "http",
>       "url": "https://mcp.didit.me/mcp?toolsets=core"
>     }
>   }
> }
> ```

> [tab] Claude web dan Desktop
>
> Buka **Settings**, lalu **Connectors**, lalu **Add custom connector**, dan tempelkan URL beserta parameternya:
>
> ```text theme={null}
> https://mcp.didit.me/mcp?toolsets=core
> ```

> [tab] Server lokal
>
> Server lokal menerima flag atau variabel lingkungan:
>
> ```bash theme={null}
> npx -y @didit-protocol/mcp-server --toolsets=core,workflows --read-only
> ```
>
> ```bash theme={null}
> DIDIT_TOOLSETS=core,workflows DIDIT_READ_ONLY=true npx -y @didit-protocol/mcp-server
> ```

Jika klien Anda memungkinkan Anda mengatur header tetapi tidak mengedit URL, kirimkan `X-MCP-Toolsets: core,workflows` dan `X-MCP-Readonly: true` sebagai gantinya.
Nilai di URL didahulukan daripada header untuk toolset, dan mode hanya baca aktif jika salah satunya memintanya.

> [!NOTE]
>
> Plugin ChatGPT menggunakan katalog tetap yang lebih ringkas di `https://mcp.didit.me/mcp/chatgpt`.
> Toolset dan mode hanya baca tidak berlaku untuk plugin tersebut.
> Lihat [Hubungkan ChatGPT](https://docs.didit.me/id/integration/mcp/chatgpt.md).

## Prompt, instruksi, dan pencarian dokumentasi

Server membantu model memulai dari titik yang tepat:

* **Instruksi.** Saat terhubung, server memberi tahu model untuk memulai dengan `didit_context_get`, cara `organization_id` dan `application_id` ditentukan, untuk membangun di aplikasi sandbox, serta toolset mana yang dimuat oleh koneksi ini.
* **Prompt.** Klien yang mendukung prompt MCP menampilkan lima titik awal: `integrate_didit`, `review_queue`, `explain_session`, `build_workflow`, dan `verification_report`. Di Claude Code, prompt tersebut muncul sebagai perintah slash.
* **Pencarian dokumentasi.** `didit_docs_search` mencari dokumentasi ini dan mengembalikan bagian yang cocok beserta tautannya, sehingga pertanyaan tentang cara kerja Didit dijawab berdasarkan halaman terkini.

## Periksa apa yang dimuat oleh sebuah koneksi

Tanyakan ke klien Anda:

```text theme={null}
Which Didit toolsets does this connection load, and is it read-only?
```

Model menjawab berdasarkan instruksi dari server.
Untuk memastikan server mendukung toolset sebelum Anda mengandalkannya, baca endpoint statusnya:

```bash theme={null}
curl https://mcp.didit.me/healthz
```

Jawabannya mencantumkan `toolsets` dan `read_only` di bawah `features`.

## Langkah selanjutnya

> [card] [Instalasi](https://docs.didit.me/id/integration/mcp/installation.md)
>
> Hubungkan Claude, ChatGPT, Cursor, VS Code, Codex, atau klien MCP apa pun.

> [card] [Referensi tool](https://docs.didit.me/id/integration/mcp/tools.md)
>
> Setiap tool, jenisnya, dan izin peran yang dibutuhkannya.

> [card] [Autentikasi](https://docs.didit.me/id/integration/mcp/authentication.md)
>
> Masuk dengan Didit, cakupan, dan izin peran.

> [card] [Contoh prompt](https://docs.didit.me/id/integration/mcp/examples.md)
>
> Prompt yang langsung bisa dipakai sejak hari pertama.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.