WhatsApp MCP

npx add-mcp 'https://server.wa-mcp.com/mcp'

Dokumentasi WhatsApp MCP

WhatsApp MCP menghubungkan asisten AI Anda (Claude, ChatGPT, Cursor, atau klien apa pun yang mendukung Model Context Protocol) ke nomor WhatsApp yang sudah Anda gunakan. Asisten Anda dapat membaca dan mencari obrolan Anda, menemukan siapa yang menunggu balasan, serta mengirim, menjadwalkan, mengedit, atau bereaksi terhadap pesan, selalu dari nomor Anda sendiri dan hanya saat Anda memintanya.

Layanan ini terhubung ke WhatsApp sebagai perangkat tertaut, sama seperti WhatsApp Web. Tidak ada aplikasi yang perlu dipasang, tidak ada nomor baru, dan tidak ada Meta Business API.

Penyiapan

Anda menghubungkan sekali, lalu menautkan WhatsApp Anda di obrolan.

Opsi A: direktori konektor Claude

1. Di Claude, buka direktori konektor dan temukan WhatsApp MCP.
2. Klik Connect. Halaman koneksi kami akan terbuka: pastikan halaman tersebut menyebutkan aplikasi AI Anda, lalu klik Connect lagi.
3. Kembali di Claude, buka obrolan baru dan ketik "Connect my WhatsApp" (lihat "Tautkan WhatsApp Anda" di bawah).

Tidak ada pendaftaran atau kata sandi: nomor WhatsApp Anda adalah akun Anda, dan menautkannya adalah cara kami mengetahui bahwa itu memang Anda.

Opsi B: URL koneksi pribadi (klien MCP apa pun)

1. Buka wa-mcp.com, pilih aplikasi AI Anda dan klik Generate my link.
2. Tambahkan tautan tersebut ke aplikasi AI Anda sebagai konektor kustom (server MCP). Situs menampilkan langkah-langkah persisnya untuk setiap aplikasi, dan How to Connect Claude to WhatsApp memandu Claude langkah demi langkah.
3. Buka obrolan baru dan ketik "Connect my WhatsApp".

Jaga kerahasiaan tautan tersebut: fungsinya seperti kata sandi. Anda dapat menggunakan tautan yang sama di beberapa aplikasi AI.

Tautkan WhatsApp Anda

Saat Anda meminta asisten menghubungkan WhatsApp Anda, asisten menawarkan dua cara:

• Kode QR: asisten Anda menampilkan kode QR (dan tautan ke halaman yang memuatnya). Di ponsel Anda, buka WhatsApp → Settings → Linked devices → Link a device dan pindai kode tersebut.
• Kode pemasangan: berikan nomor telepon Anda beserta kode negaranya kepada asisten Anda. Asisten akan mengembalikan kode 8 karakter. Di ponsel Anda, buka Linked devices → Link a device → Link with phone number instead dan ketik kode tersebut.

Setelah ditautkan, WhatsApp menyinkronkan riwayat terbaru Anda (hingga sekitar 90 hari) ke perangkat tertaut, yang bisa memakan waktu beberapa menit untuk akun besar.

Paket

• Uji coba gratis: semua fitur selama 1 jam setelah Anda pertama kali menautkan telepon.
• Paket gratis: setelah uji coba, membaca, merangkum, dan mencari obrolan serta mengirim pesan teks tetap berfungsi. Pesan teks diakhiri dengan "Sent via wa-mcp.com", dan percakapan baru (orang yang belum pernah menulis kepada Anda dalam 90 hari terakhir) tidak dapat dimulai.
• Paket berbayar: file (foto, video, pesan suara, dokumen), pesan terjadwal, mengedit, bereaksi terhadap, dan menghapus pesan, percakapan baru dengan pengaman anti-blokir, dan tanpa label.

Tanyakan kepada asisten Anda "What plan am I on?" untuk melihat paket dan opsi langganan Anda.

Alat

Asisten Anda yang memilih alatnya; Anda cukup bertanya dengan kata-kata biasa.

Membaca

Alat	Fungsinya
get_recent_chats	Obrolan terbaru Anda, beserta pesan terakhir dari masing-masing.
get_unanswered_chats	Obrolan yang pesan terakhirnya dari orang lain, sehingga Anda dapat melihat siapa yang menunggu balasan.
read_chat_history	Pesan-pesan dari satu obrolan, orang, atau grup.
search_messages	Mencari teks pesan Anda, secara opsional dalam satu obrolan atau dari satu orang.
search_contacts	Menemukan kontak atau grup berdasarkan nama atau nomor.
download_media	Membuka foto, pesan suara, video, dokumen, atau stiker dari sebuah pesan.
get_writing_style	Contoh cara Anda menulis, agar draf yang ditulis untuk Anda terdengar seperti Anda.

Menulis

Alat	Fungsinya
send_message	Mengirim teks, atau file dari tautan, kepada seseorang atau grup. Menampilkan indikator mengetik terlebih dahulu.
schedule_message	Menjadwalkan pesan untuk nanti, sekali atau berulang (harian, mingguan, bulanan, dan lainnya).
list_scheduled_messages	Menampilkan daftar pesan terjadwal yang akan datang dan riwayat pesan yang sudah lewat.
cancel_scheduled_message	Membatalkan pesan terjadwal (beserta semua pengulangannya).
react_to_message	Bereaksi terhadap pesan dengan emoji, atau menghapus reaksinya.
edit_message	Mengubah teks salah satu pesan Anda sendiri.
delete_message	Menghapus salah satu pesan Anda sendiri untuk semua orang.
mark_as_read	Menandai obrolan sebagai sudah dibaca.

Koneksi dan akun

Alat	Fungsinya
get_session_status	Menunjukkan apakah WhatsApp Anda sudah tertaut dan terhubung.
get_pairing_qr	Memulai penautan dengan kode QR.
request_pairing_code	Memulai penautan dengan kode pemasangan.
restart_session	Menghubungkan ulang ke WhatsApp jika pesan berhenti masuk.
manage_subscription	Menampilkan paket Anda dan opsi langganan.
report_feedback	Mengirimkan laporan bug atau permintaan fitur kepada kami.
unlink_whatsapp	Melepas tautan WhatsApp Anda (akun Anda tetap ada).
delete_account	Menghapus akun Anda dan semua datanya, setelah Anda mengonfirmasi.

Contoh perintah

• "Siapa yang menunggu balasan dari saya sejak kemarin?"
• "Rangkum apa yang dibicarakan grup keluarga minggu ini."
• "Temukan pesan saat Carlos mengirimi saya alamatnya."
• "Beri tahu Ana bahwa pesanannya dikirim hari Kamis." (asisten Anda menampilkan draf terlebih dahulu kecuali Anda memberikan kata-kata persisnya)
• "Setiap Senin pukul 9 pagi, ingatkan grup tim untuk mengirim pembaruan mingguan mereka."

Keamanan

• Anda tetap memegang kendali atas apa yang terkirim. Saat asisten Anda menulis pesan untuk Anda, asisten menampilkan drafnya sebelum mengirim kecuali Anda memberikan teks persisnya.
• Pengaman anti-blokir. Pesan kepada orang yang belum pernah menulis kepada Anda dalam 90 hari terakhir diberi jeda (paling banyak 1 per menit dan 10 orang berbeda setiap 12 jam), karena itulah yang membuat nomor ditandai sebagai spam. Obrolan dengan orang yang pernah menulis kepada Anda tidak pernah dibatasi. Tidak ada alat untuk pengiriman massal.
• Indikator mengetik. Tulisan singkat "typing…" muncul sebelum setiap pesan, seperti jika Anda mengetiknya sendiri.

Pemecahan masalah

• "WhatsApp is not linked": perangkat tertaut telah dihapus (dari ponsel Anda, atau dengan melepas tautan). Minta asisten Anda menghubungkan WhatsApp Anda lagi dengan nomor yang sama.
• Kode pemasangan tidak berfungsi: kode kedaluwarsa setelah waktu yang singkat. Minta kode baru, pastikan nomornya menyertakan kode negara, dan gunakan Link with phone number instead di ponsel Anda.
• Pesan berhenti masuk: minta asisten Anda memulai ulang koneksi WhatsApp Anda. Jika WhatsApp di ponsel Anda telah offline selama sekitar 14 hari, WhatsApp mengeluarkan perangkat tertaut: buka WhatsApp di ponsel Anda, lalu tautkan lagi.
• "This connection is permanently registered to phone number…": setiap koneksi milik satu telepon. Untuk menggunakan nomor lain, lepaskan tautan, lalu hapus konektor dan tambahkan lagi (atau, dengan URL pribadi, buat yang baru).
• Konektor menyatakan tidak terhubung (pengguna direktori): hapus WhatsApp MCP dari konektor Anda dan hubungkan lagi, lalu tautkan telepon yang sama. Akun dan langganan Anda tetap terbawa.

Privasi dan data Anda

Pesan Anda disimpan selama 90 hari di server kami agar asisten Anda dapat mencarinya, dan tidak pernah digunakan untuk iklan atau pelatihan AI. Apa yang dibaca asisten Anda ditangani oleh penyedianya sesuai kebijakan mereka. Minta asisten Anda untuk melepas tautan WhatsApp Anda atau menghapus akun Anda kapan saja; penghapusan akan menghapus semuanya seketika. Detail lengkapnya ada di Privacy Policy dan Terms kami.