Hubungkan Aplikasi AI (MCP)
MonoChat MCP Server memungkinkan aplikasi AI yang mendukung Model Context Protocol (MCP), seperti Claude Code atau Cursor, bekerja dengan akun MonoChat Anda. Aplikasi AI meminta data dari MonoChat melalui sekumpulan tool yang tetap; aplikasi hanya dapat melihat apa yang dapat Anda lihat.
MonoChat MCP Server tersedia di setiap paket, tanpa batasan berdasarkan paket.
Aplikasi AI yang terhubung dengan kunci akses Anda bertindak sebagai pengguna Anda. Aplikasi hanya menjangkau tenant yang dapat Anda akses dan tidak lebih. Cabut koneksi yang tidak lagi Anda gunakan.
Apa yang dapat dilakukan aplikasi AI
Tool berikut tersedia untuk setiap koneksi:
| Tool | Fungsinya |
|---|---|
list_tenants | Menampilkan daftar tenant yang dapat diakses koneksi. |
list_sessions | Menampilkan daftar sesi percakapan sebuah tenant, terbaru lebih dulu, opsional hanya sesi opened, assigned, atau closed. |
get_session | Mengembalikan satu sesi percakapan. |
list_messages | Menampilkan daftar pesan sebuah sesi, terbaru lebih dulu. |
search_customers | Mencari pelanggan sebuah tenant berdasarkan kata kunci. |
list_message_templates | Menampilkan daftar template pesan dari satu saluran milik sebuah tenant. |
Teks pesan berasal dari pelanggan dan agen. Teks itu adalah data untuk dibaca aplikasi AI, bukan instruksi.
Sebuah koneksi memiliki cakupan, Hanya baca atau Baca dan tulis. Koneksi hanya baca tidak pernah melihat tool yang mengubah data. Semua tool di atas hanya membaca.
Buat koneksi
Koneksi dimiliki akun Anda, bukan tenant. Anda perlu mengatur verifikasi dua langkah (lewat e-mail atau aplikasi autentikator) terlebih dahulu.
- Buka pengaturan profil Anda, pilih tab Koneksi MCP, lalu klik Buat.
- Masukkan nama, pilih cakupan (Hanya baca secara default) dan masa berlaku dalam hari (default 90, maksimal 365).
- Masukkan kode konfirmasi 6 digit dari metode verifikasi dua langkah Anda. Jika memakai verifikasi e-mail, klik Kirim kode konfirmasi terlebih dahulu.
- Salin kunci akses. Kunci hanya ditampilkan sekali; kunci diawali dengan
mcp_sk_.
Anda dapat memiliki maksimal 10 koneksi aktif.
Hubungkan aplikasi AI
Server berada di https://app.monochat.ai/api/mcp-server (gunakan alamat MonoChat Anda sendiri jika Anda menjalankan MonoChat di server sendiri) dan mengharapkan kunci akses sebagai bearer token di header Authorization.
Claude Code
claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
--header "Authorization: Bearer <access key>"
Cursor
Tambahkan server ke ~/.cursor/mcp.json:
{
"mcpServers": {
"monochat": {
"url": "https://app.monochat.ai/api/mcp-server",
"headers": { "Authorization": "Bearer <access key>" }
}
}
}
Klien MCP lain yang mendukung transport HTTP streamable dan header kustom terhubung dengan cara yang sama.
Batas
Panggilan dihitung per menit: 60 per koneksi, 300 per akun, dan 600 per tenant, serta maksimal 4 panggilan bersamaan per koneksi. Beberapa tool dihitung sebagai lebih dari satu panggilan. Saat batas tercapai, server menjawab dengan status 429 dan header Retry-After; aplikasi AI harus menunggu selama jumlah detik tersebut.
Cabut koneksi
Setiap koneksi di tab Koneksi MCP menampilkan status, cakupan, masa berlaku, dan penggunaan terakhir. Klik Cabut untuk langsung memutus aplikasi AI. Koneksi yang dicabut atau kedaluwarsa tidak dapat dipakai lagi; buat yang baru.
Kelola akses MCP untuk organisasi
Pengguna yang dapat mengubah pengaturan organisasi mengelola akses MCP-nya di Pengaturan › Organisasi › Server MCP.
- Matikan akses MCP untuk organisasi ini: aktifkan lalu klik Simpan untuk menolak setiap panggilan MCP ke organisasi ini, dari setiap koneksi setiap pengguna. Organisasi tidak lagi muncul di
list_tenants. Matikan lalu simpan untuk mengizinkan akses MCP lagi. - Panggilan MCP: setiap panggilan ke alat yang menyebut organisasi ini, terbaru lebih dulu, termasuk panggilan yang ditolak. Setiap baris menampilkan pengguna, koneksi, alat, status (Berhasil atau Gagal), alamat IP, dan waktu. Panggilan dari pengguna yang bukan anggota organisasi ini tidak ditampilkan.