Lewati ke isi
CSWA.AIDocs

MCP: menghubungkan Claude Code, Cursor & lainnya

Hubungkan Claude Code, Cursor, VS Code, Windsurf, atau n8n ke WhatsApp CSWA.AI lewat server MCP.

± 4 menit

Server MCP menghubungkan asisten AI (Claude Code, Cursor, VS Code, Windsurf, n8n) ke WhatsApp CSWA.AI. Masuk memakai kunci API di header Authorization — tanpa login tambahan. Alamat server: https://mcp.cswa.ai.

Sebelum mulai

  • Izin peran: Integrasi › Kelola (pemilik & admin otomatis punya).
  • Kunci API — sebaiknya kunci khusus MCP dengan izin seperlunya (mis. hanya baca). Lihat membuat kunci API.

Langkah#

  1. Langkah 1: Buka tab MCP

    Di API & Webhook, pilih tab MCP. Kartu Server MCP menampilkan alamat server dan tombol salin.

    ① Alamat Server MCP. ② Pilihan klien. ③ Konfigurasi siap salin.

    API & Webhook tab MCP: alamat Server MCP, pilihan klien, dan konfigurasi siap salin

  2. Langkah 2: Pilih klien

    Di Konfigurasi klien pilih Claude Code, Cursor, VS Code, Windsurf, n8n, atau mcp-remote (klien tanpa header, mis. Claude Desktop).

  3. Langkah 3: Tempel konfigurasi

    Salin konfigurasinya, ganti kunci contoh dengan kunci Anda. Claude Code: jalankan sekali di terminal. Cursor: ~/.cursor/mcp.json. VS Code: .vscode/mcp.json lalu klik Start. Windsurf: ~/.codeium/windsurf/mcp_config.json lalu Refresh.

    Claude Code (terminal)

    claude mcp add --transport http cswa https://mcp.cswa.ai \ --header "Authorization: Bearer cswa_live_KUNCI_ANDA"

  4. Langkah 4: Coba

    Minta asisten AI, mis. “ringkas chat WhatsApp hari ini”. Alat yang tampil mengikuti izin kunci.

Hasilnya#

Asisten AI bisa membaca percakapan, mencari kontak, dan (bila diizinkan) mengirim pesan atau membuat broadcast — selalu lewat pratinjau & konfirmasi.

Terhubung dengan fitur lain#

  • Batas per kunci MCP: 30 permintaan/menit (lonjakan 10 per 10 detik), ditambah batas per Profil bersama REST.
  • Lewat MCP maks. 20 pesan/jam (WA Device), 60 pesan/jam (API Official), 5 broadcast/hari, 1.000 penerima per broadcast. Token pratinjau berlaku 10 menit.
  • Isi chat pelanggan ditandai sebagai data, bukan perintah, untuk asisten AI.
  • Panduan per klien — MCP (panduan teknis).

Alat MCP#

daftar_kanalNomor WhatsApp (Device & API Official) Profil ini, status koneksi, dan kuota pesan baru harian. · Izin pesan:baca · Baca
cari_percakapanCari chat WhatsApp: belum dibalas, sudah dibalas, butuh CS, per kanal, atau per kata (nama/nomor). · Izin pesan:baca · Baca
baca_percakapanRiwayat pesan satu percakapan (terbaru dulu). · Izin pesan:baca · Baca
ringkas_chat_hari_iniAngka chat hari ini (zona waktu bisnis Profil) dan daftar percakapan yang masih menunggu balasan. · Izin pesan:baca · Baca
cari_kontakCari kontak WhatsApp per nama/nomor atau tag. · Izin kontak:baca · Baca
ubah_tag_kontakTambah dan/atau lepas tag satu kontak. · Izin kontak:tulis · Tulis
kirim_pesanKirim SATU pesan teks ke satu kontak. Panggilan pertama hanya PRATINJAU (aturan WhatsApp diperiksa); kirim sungguhan dengan memanggil ulang isian yang sama + konfirmasi: true + token_pratinjau. Selalu tunjukkan pratinjau ke pengguna dan minta persetujuannya dulu. · Izin pesan:kirim · Konfirmasi
buat_broadcastBroadcast ke tag kontak atau daftar nomor. WAJIB pratinjau: panggilan pertama mengembalikan jumlah penerima, isi, dan perkiraan waktu + token_pratinjau; broadcast baru dibuat bila dipanggil ulang dengan isian sama + konfirmasi: true + token yang sama. Minta persetujuan pengguna dulu. · Izin broadcast:kelola · Konfirmasi
tugaskan_percakapanTugaskan percakapan ke anggota tim (user_id) atau lepas penugasan (null). · Izin inbox:kelola · Tulis
tutup_percakapanTandai percakapan selesai, atau buka lagi. · Izin inbox:kelola · Tulis
atur_ai_agentJeda AI Agent (CS ambil alih), lanjutkan AI, atau serahkan percakapan ke CS manusia. · Izin ai:kelola · Tulis
laporan_broadcastProgres & hasil satu broadcast, atau 10 broadcast terbaru. · Izin broadcast:kelola · Baca
analitik_whatsappAngka WhatsApp yang sama dengan halaman Analitik (pesan masuk, broadcast, respons, tiket, CSAT, pesanan). · Izin analitik:baca · Baca
daftar_pesananPesanan Inbox › Penjualan & halaman toko, bisa disaring status/percakapan/kata. · Izin pesanan:baca · Baca
status_pesananDetail satu pesanan: item, total, status bayar, pengiriman & resi. · Izin pesanan:baca · Baca

Masalah umum#

Klien tidak menampilkan alat apa pun
Kunci salah/dicabut atau izinnya kosong. Periksa header Authorization dan izin kunci.
Claude Desktop tidak bisa memakai header
Pakai konfigurasi mcp-remote: jembatan npx mcp-remote meneruskan header kunci.
Pesan tidak terkirim lewat MCP
kirim_pesan & buat_broadcast selalu pratinjau dulu; konfirmasi dalam 10 menit. Periksa juga batas per jam.

Terkait#