- URL:
http://<host>:3000<APP_BASE_PATH>/mcp(defaulthttp://localhost:3000/mcp) - Aktif secara default. Nonaktifkan dengan
MCP_ENABLED=falseor--mcp-enabled=false. - Stateless: tidak ada handshake sesi yang perlu dipertahankan di antara pemanggilan.
Jika Anda memperbarui dari rilis lama, perintah mandiri
./whatsapp mcp dan endpoint SSE-nya pada port 8080 (/sse) sudah dihapus. Jalankan ./whatsapp rest dan arahkan klien ke /mcp. Kumpulan tool lama yang menyediakan satu tool untuk setiap operasi telah diganti dengan tool terpadu di bawah ini.Hubungkan klien
/mcp dilindungi Basic Auth yang sama dengan REST API. Kirim header Authorization, serta X-Device-Id jika Anda menjalankan lebih dari satu perangkat:
YWRtaW46Y2hhbmdlbWU= adalah base64("admin:changeme"); buat nilai Anda sendiri dengan echo -n 'user:pass' | base64. Hilangkan Authorization jika Basic Auth tidak aktif, dan X-Device-Id jika hanya ada satu perangkat.
Format konfigurasi bergantung pada klien. Jika klien hanya dapat menjalankan server stdio, gunakan perantara seperti mcp-remote.
Tool
GOWA menyediakan tujuh tool. Masing-masing menerima argumentype (untuk pengiriman) atau action (untuk semua tool lainnya) untuk memilih operasi.
Catatan tentang argumen:
whatsapp_sendselalu memerlukantypedanphone. Media dikirim hanya melalui URL (image_url,video_url,audio_url,file_url,sticker_url); MCP tidak dapat mengunggah file lokal.linkmemerlukanlinkdancaption;forwardmemerlukanmessage_id.whatsapp_sendmenerima field jadwal (scheduled_at,timezone,recurrence,weekdays,day_of_month,end_at,occurrence_limit). Kelola hasilnya denganwhatsapp_schedule(get,pause,resume, dancancelmemerlukanschedule_id).whatsapp_messagememerlukanphone(chat) danmessage_id;editjuga memerlukanmessage.- Pada GOWA
mainsetelah v9.9.0,whatsapp_messagedenganaction: "edit"menerimamedia_type: "image"ataumedia_type: "document"untuk mengganti caption. Sesuaikan dengan jenis media asli dan hilangkanlink. Lihat Edit caption. whatsapp_chat:get_messagesmemerlukanchat_jid;archivememerlukanchat_jiddanarchived.whatsapp_app:login_codememerlukanphone.
HTTP_PROXY atau HTTPS_PROXY. Pengunggahan file lokal memerlukan REST API.
Klien MCP menampilkan skema input lengkap setiap tool. Endpoint HTTP menerima POST dan DELETE. Streaming GET SSE dinonaktifkan.
Pemilihan perangkat
Setiap pemanggilan menentukan perangkatnya dengan urutan berikut:- Argumen
device_idpada pemanggilan tool. - Header
X-Device-Idpada koneksi MCP. - Satu-satunya perangkat terdaftar, jika hanya ada satu perangkat.
device identification required: set the X-Device-Id header or pass device_id. Lihat Multi-perangkat.
Klien jarak jauh dengan OAuth
Klien yang dihosting, seperti konektor kustom Claude, tidak dapat menyertakan header Basic Auth. Untuk klien tersebut, GOWA dapat menjalankan server otorisasi OAuth 2.1 untuk/mcp. Fitur ini tidak aktif secara default.
APP_BASIC_AUTHharus diatur: halaman otorisasi menggunakan akun yang sama untuk login pengguna. Proses startup gagal tanpa pengaturan ini.- Issuer dan resource harus berupa URL HTTPS publik yang diakses klien, bukan alamat internal seperti
http://gowa:3000. - Saat OAuth aktif,
/mcpmenerima token Bearer atau Basic Auth. Token tidak diterima pada rute REST atau UI. - Klien mendaftarkan dirinya sendiri (pendaftaran klien dinamis RFC 7591). Body pendaftaran dibatasi hingga 16 KiB dan setiap URI pengalihan hingga 2 KiB. Pendaftaran dibatasi hingga 40 per jam dan 1,000 klien tersimpan; klien yang tidak digunakan dihapus setelah 24 jam.
- PKCE
S256wajib digunakan. Kode kedaluwarsa setelah 5 menit, token akses setelah 1 jam; refresh token dirotasi, dan penggunaan ulang token lama mencabut seluruh keluarga token. Hanya hash SHA-256 token yang disimpan, diMCP_OAUTH_DB_URI(defaultfile:storages/oauth.db).
localhost memerlukan port eksplisit dan kecocokan persis. Pengalihan lainnya memerlukan HTTPS. OAuth resource terikat pada URL MCP kanonis; permintaan token boleh menghilangkannya, tetapi nilai yang disertakan harus cocok. Respons otorisasi yang berhasil menyertakan iss.
Kode dan token yang kedaluwarsa dihapus selama penulisan OAuth. Hash refresh token yang telah dirotasi dipertahankan selama diperlukan untuk mendeteksi penggunaan ulang pada keluarga token aktif, paling lama satu masa berlaku refresh token tambahan selama 30 hari. Menghapus atau mengganti database OAuth membatalkan klien dan pemberian akses yang ada.
Endpoint, relatif terhadap issuer: /oauth/authorize, /oauth/token, /oauth/register. Metadata discovery menggunakan URL well-known dengan penyisipan path pada root domain, sehingga dengan APP_BASE_PATH=/gowa, proxy Anda harus merutekan:
https://gowa.example.com/mcp sebagai konektor kustom dan login dengan akun APP_BASIC_AUTH.
