Claude Code WhatsApp bisa dipasang dengan satu perintah, claude mcp add --transport http kirimi https://api.kirimi.id/mcp, lalu login lewat /mcp. Ada juga jalur kedua lewat paket npm kirimi-mcp yang berjalan lokal. Dua jalur ini berbeda soal kemampuan dan keamanan, jadi pilih dulu sebelum memasang.
Ringkasnya: Jalur remote (HTTP + OAuth) bisa membaca inbox dan setiap kirim butuh persetujuanmu. Paket npm hanya bisa mengirim dan mengelola, tanpa konfirmasi. Langkah di artikel ini mengikuti dokumentasi resmi Claude Code dan Codex per Oktober 2026, belum diuji Kirimi di kedua tool itu (Kirimi hanya menguji lewat Claude web dan desktop).
Jalur mana yang cocok: remote atau npm?
MCP (Model Context Protocol) adalah standar terbuka yang memungkinkan aplikasi AI memanggil tool di layanan lain. Kirimi menyediakan WhatsApp sebagai tool MCP lewat dua cara. Perbedaannya menentukan seberapa aman setup-mu.
| Aspek | Remote (HTTP + OAuth) | Paket npm kirimi-mcp |
|---|---|---|
| Autentikasi | OAuth: login di browser, tanpa menyalin secret | KIRIMI_USER_CODE dan KIRIMI_SECRET sebagai env var |
| Baca inbox | Bisa | Tidak bisa |
| Kirim pesan | Dua langkah: ringkasan dulu, terkirim setelah kamu setuju | Langsung terkirim tanpa konfirmasi |
Pegangan singkat: kalau kamu ingin AI membantu membaca dan merangkum chat, pakai remote. Pakai npm hanya kalau kamu butuh otomasi kirim yang kamu kendalikan penuh. Gambaran lengkap kedua jalur ada di pengantar MCP WhatsApp Kirimi; artikel ini membahas jalur npm secara rinci di bawah.
Bagaimana memasang Kirimi di Claude Code lewat jalur remote?
Jalur remote memakai OAuth, yaitu mekanisme login di mana kamu memberi izin lewat browser tanpa membagikan password atau secret ke aplikasi AI. Kamu butuh akun Kirimi dengan paket Basic atau Pro per Oktober 2026.
1. Tambahkan server
claude mcp add --transport http kirimi https://api.kirimi.id/mcpTanpa opsi tambahan, Claude Code menyimpan konfigurasi pada scope local, yaitu hanya untukmu di proyek saat ini. Tambahkan --scope user agar tersedia di semua proyekmu:
claude mcp add --transport http --scope user kirimi https://api.kirimi.id/mcpScope project menulis ke .mcp.json yang dibagikan ke seluruh tim lewat repositori. Untuk akses ke inbox WhatsApp pribadi atau bisnis, scope user atau local lebih masuk akal.
2. Login lewat /mcp
- Buka sesi Claude Code, lalu ketik
/mcp. - Pilih
kirimidan ikuti alur login di browser. - Di halaman persetujuan Kirimi, pilih nomor WhatsApp yang boleh diakses dan izin yang kamu berikan. Izin baca percakapan dan kontak aktif secara default, sedangkan izin kirim pesan dan kirim OTP harus kamu centang sendiri.
- Klik Izinkan.
Kalau kamu bekerja lewat SSH tanpa browser, dokumentasi Claude Code menyediakan claude mcp login kirimi di shell. Perintah itu menampilkan URL otorisasi untuk dibuka di mesin lokal, lalu kamu menempelkan URL redirect penuh kembali ke prompt. Gunakan ssh -t karena langkah tempel butuh terminal interaktif.
Bagaimana memastikan koneksinya berhasil?
Dokumentasi Claude Code menyebut claude mcp add tidak memvalidasi koneksi, jadi periksa sendiri. Jalankan claude mcp list, yang menampilkan status tiap server seperti Connected atau Needs authentication, atau buka /mcp di dalam sesi. Lalu coba prompt yang hanya membaca (ada contoh lain di 10 prompt asisten AI untuk rangkum chat belum dibalas):
Tampilkan 5 chat WhatsApp terakhir yang belum dibalas.Kalau tool terpanggil dan daftar percakapan muncul, jalurnya sudah jalan. Jangan uji dengan perintah kirim dulu. Saat kamu meminta AI mengirim, Kirimi menyiapkan ringkasan (pengirim, penerima, isi pesan) dan baru mengirim setelah kamu menyetujuinya. Token konfirmasinya sekali pakai dan berlaku 10 menit. Batas per koneksi: kirim 10 per menit dan 200 per jam.
Satu catatan untuk otomasi: mode non-interaktif claude -p tidak bisa menjalankan alur OAuth. Login dulu di sesi interaktif, baru pakai server itu di skrip. Untuk server Kirimi remote, jangan menambahkan header Authorization sendiri: menurut dokumentasi, kalau server menolak header itu, Claude Code menandai koneksi gagal dan tidak beralih ke OAuth.
Bagaimana memakai paket npm kirimi-mcp di Claude Code?
Paket kirimi-mcp (v1.1.0, lisensi MIT, kode di GitHub) adalah server stdio: Claude Code menjalankannya sebagai proses lokal di komputermu. Paket ini cocok untuk developer yang ingin otomasi, misalnya mengirim ringkasan hasil kerja ke nomor sendiri.
Peringatan: paket ini mengirim pesan langsung tanpa langkah konfirmasi, dan tidak bisa membaca inbox. Kalau AI salah memahami prompt, pesan sudah terkirim. Batasi pemakaiannya ke nomor yang kamu kontrol.
Apa saja yang bisa dilakukan paket npm?
Paket ini punya 19 tool yang fokus ke pengiriman dan pengelolaan: kirim pesan (send_message, send_message_fast, broadcast_message), OTP (send_otp, verify_otp), perangkat (list_devices, device_status, device_status_enhanced, create_device, renew_device), kontak (save_contact, save_contacts_bulk), info akun (get_user_info, list_packages), serta template dan balasan WABA (send_waba_template, waba_list_conversations, waba_reply, waba_sync_templates). Perangkat WhatsApp Kirimi terhubung lewat QR, jadi hubungkan perangkat di dashboard, bukan lewat tool. Paket ini tidak punya tool untuk membaca isi inbox.
Siapkan kredensial
Ambil user_code dan secret dari halaman API/Credentials di dashboard Kirimi. KIRIMI_DEVICE_ID opsional, tetapi dibutuhkan kalau kamu tidak menyebut device di setiap panggilan. Format perintah stdio di dokumentasi Claude Code memakai pemisah -- antara opsi Claude dan perintah server:
claude mcp add --transport stdio --scope user \
--env KIRIMI_USER_CODE=ISI_USER_CODE \
--env KIRIMI_SECRET=ISI_SECRET \
kirimi-npm -- npx -y kirimi-mcpContoh di README paket memakai bentuk yang sedikit berbeda, tetapi pola di atas mengikuti dokumentasi Claude Code. Beri nama kirimi-npm agar tidak bentrok dengan server remote bernama kirimi. Tambahkan --env KIRIMI_DEVICE_ID=D-XXXXX bila perlu. Sisipkan opsi lain, seperti --transport stdio, di antara --env dan nama server, sebab dokumentasi menyebut nama server tepat setelah --env akan dibaca sebagai pasangan variabel.
Simpan secret dengan aman
- Jangan taruh secret di
.mcp.jsonyang masuk repositori. Scopeusermenyimpannya di~/.claude.json, di luar proyek. - Jangan tempel secret di chat atau issue tracker.
- Kalau secret terlanjur bocor, ganti segera lewat dashboard.
Bedanya dengan server MCP tidak resmi dibahas di WhatsApp MCP resmi vs tidak resmi. Untuk gambaran API dasarnya, baca panduan WhatsApp unofficial API untuk developer.
Bagaimana memasang Kirimi di Codex?
Codex (CLI dari OpenAI) mendukung server HTTP dengan OAuth. Menurut dokumentasi Codex, tambahkan server lalu login:
codex mcp add kirimi --url https://api.kirimi.id/mcp
codex mcp login kirimiDokumentasi mencatat bahwa koneksi tanpa kredensial bisa tersambung tanpa autentikasi, jadi jalankan codex mcp login secara terpisah. Bentuk --url muncul di dokumentasi Codex bersama opsi OAuth tambahan, sedangkan bentuk polos di atas belum diuji. Alternatifnya, edit ~/.codex/config.toml, yang dokumentasinya memakai kunci url untuk server HTTP:
[mcp_servers.kirimi]
url = "https://api.kirimi.id/mcp"Di TUI Codex, /mcp menampilkan server yang aktif, dan codex mcp list menampilkan server yang terkonfigurasi. File konfigurasi yang sama dipakai CLI, aplikasi desktop, dan ekstensi IDE. Langkah Codex ini mengikuti dokumentasi resmi dan belum diuji Kirimi.
Bagaimana menghapus atau mencabut akses?
- Hapus server dari Claude Code:
claude mcp remove kirimi. Menurut dokumentasi, ini juga menghapus token OAuth dan registrasi klien yang tersimpan. Untuk hanya mengeluarkan login, pakaiclaude mcp logout kirimiatau "Clear authentication" di/mcp. - Cabut izin di sisi Kirimi: buka Pengaturan, tab Aplikasi Terhubung, lalu klik Cabut akses pada aplikasinya. Hanya akun pemilik yang bisa melakukannya.
- Untuk jalur npm: hapus server dengan
claude mcp remove kirimi-npmdan ganti secret akunmu kalau pernah terekspos.
Di sisi Kirimi, token akses remote berlaku 1 jam dan token refresh 60 hari, serta setiap panggilan tool dicatat di server. Baca juga risiko dan cara menjaga keamanan saat AI membaca chat WhatsApp.
Mulai dari mana?
Daftar akun di dash.kirimi.id/register, lalu ikuti panduan per aplikasi di dash.kirimi.id/integrations/mcp. Jalur remote butuh paket Basic atau Pro. Kenalan dulu dengan konsepnya di pengantar MCP WhatsApp Kirimi. Pengguna aplikasi lain bisa lanjut ke Claude web dan desktop, Cursor, atau Gemini CLI.
Pertanyaan yang sering diajukan
Apa perintah untuk memasang Kirimi di Claude Code?
Jalankan claude mcp add --transport http kirimi https://api.kirimi.id/mcp, lalu buka sesi Claude Code, ketik /mcp, pilih kirimi dan selesaikan login di browser. Tambahkan --scope user kalau kamu ingin server ini tersedia di semua proyek. Jalur remote butuh paket Kirimi Basic atau Pro per Oktober 2026.
Apa bedanya jalur remote dan paket npm kirimi-mcp?
Jalur remote memakai login OAuth, bisa membaca inbox, dan setiap pengiriman butuh persetujuan lewat dua langkah. Paket npm kirimi-mcp memakai user_code dan secret dari dashboard, hanya bisa mengirim dan mengelola, tidak bisa membaca inbox, dan mengirim langsung tanpa langkah konfirmasi.
Bisakah claude -p menjalankan login OAuth Kirimi?
Tidak. Menurut dokumentasi Claude Code, mode non-interaktif claude -p tidak bisa menjalankan alur OAuth. Selesaikan login lebih dulu di sesi interaktif lewat /mcp atau di shell lewat claude mcp login kirimi, baru jalankan mode non-interaktif.
Apakah paket npm kirimi-mcp aman dipakai?
Paketnya open source berlisensi MIT, tetapi berisi secret akunmu dan mengirim pesan langsung tanpa konfirmasi. Simpan secret di tempat aman, jangan masukkan ke repositori, dan pakai hanya untuk otomasi yang kamu kendalikan sendiri, misalnya pesan ke nomormu.
Bagaimana memasang Kirimi di Codex?
Jalankan codex mcp add kirimi --url https://api.kirimi.id/mcp lalu codex mcp login kirimi. Alternatifnya, tambahkan blok [mcp_servers.kirimi] dengan url di ~/.codex/config.toml. Langkah ini mengikuti dokumentasi Codex dan belum diuji Kirimi.
Bagaimana mencabut akses Kirimi dari Claude Code?
Hapus servernya dengan claude mcp remove kirimi, lalu cabut izinnya di dashboard Kirimi pada Pengaturan, tab Aplikasi Terhubung, dengan tombol Cabut akses. Untuk paket npm, ganti secret akunmu kalau sempat bocor.