VS Code + GitHub Copilot: Hubungkan WhatsApp via MCP

Untuk memakai VS Code MCP WhatsApp, tambahkan server HTTP https://api.kirimi.id/mcp lewat Command Palette (MCP: Add Server) atau tulis manual di file mcp.json dengan kunci root servers. Setelah login di browser, agent mode GitHub Copilot bisa membaca inbox WhatsApp yang terhubung ke Kirimi. Kamu perlu paket Kirimi Basic atau Pro.

Ringkasnya: Di format VS Code, kunci rootnya servers dan server HTTP wajib punya type serta url. Menyalin potongan berkunci mcpServers dari editor lain adalah jebakan paling umum. Langkah di artikel ini mengikuti dokumentasi resmi VS Code per Oktober 2026; Kirimi belum menguji alur ini langsung di VS Code.

Apa yang kamu butuhkan sebelum mulai?

MCP (Model Context Protocol) adalah standar terbuka yang memungkinkan aplikasi AI memanggil alat di layanan lain. Server MCP Kirimi membuka inbox, kontak, dan pengiriman WhatsApp sebagai alat yang bisa dipanggil AI. Penjelasan dasarnya ada di panduan MCP WhatsApp Kirimi.

Akun Kirimi dengan paket Basic (Rp49.000/bulan) atau Pro (Rp99.000/bulan) per Oktober 2026, karena konektor membutuhkan fitur chat (inbox).
VS Code versi terbaru dengan GitHub Copilot dan agent mode aktif. Dokumentasi VS Code tidak menyebut versi minimum untuk fitur ini, jadi kami tidak menyebut angka.
Kebijakan organisasi yang mengizinkan server MCP. Dokumentasi VS Code menyatakan organisasi bisa membatasi server yang tersedia; kalau akun Copilot kamu dari kantor, tanyakan ke admin.

Cara 1: Bagaimana menambah server lewat Command Palette?

Buka Command Palette (Cmd+Shift+P di macOS, Ctrl+Shift+P di Windows/Linux) dan jalankan MCP: Add Server.
Pilih HTTP (HTTP or Server-Sent Events).
Masukkan URL https://api.kirimi.id/mcp.
Beri ID server, misalnya kirimi. ID tidak boleh sama dengan yang sudah ada di tujuan konfigurasi.
Pilih tujuan penyimpanan. Untuk server pribadi lintas proyek, dokumentasi VS Code menyarankan Global, lalu Copilot Global.

Perhatikan di mana file tersimpan

Pilihan Copilot Global menyimpan server di ~/.copilot/mcp-config.json (atau $COPILOT_HOME/mcp-config.json), dan file itu memakai format portabel dengan kunci mcpServers, bukan servers. Opsi workspace .vscode/mcp.json di alur terpandu diberi label deprecated oleh dokumentasi, tetapi file itu tetap didokumentasikan sebagai lokasi konfigurasi. Untuk mengedit file profil pengguna langsung, jalankan MCP: Open User Configuration.

Cara 2: Bagaimana menulis .vscode/mcp.json secara manual?

Buat file .vscode/mcp.json di folder proyek lalu isi dengan:

{
  "servers": {
    "kirimi": {
      "type": "http",
      "url": "https://api.kirimi.id/mcp"
    }
  }
}

Dokumentasi VS Code menandai type dan url sebagai field wajib untuk server HTTP. VS Code mencoba transport HTTP lebih dulu dan jatuh ke SSE bila HTTP tidak didukung.

Perangkap utama: servers vs mcpServers

Format	Kunci root	Dipakai di
VS Code	`servers`	`.vscode/mcp.json` dan `mcp.json` profil pengguna
Portabel	`mcpServers`	file Copilot global, `.mcp.json` di root workspace, dan contoh konfigurasi Cursor

Menyalin potongan dari artikel lain, misalnya setup Cursor, tanpa mengganti kunci ini membuat server tidak terbaca.

Bagaimana login ke Kirimi dari VS Code?

Pada koneksi pertama, VS Code membuka browser untuk login OAuth dan memilih izin; alurnya sama untuk semua klien dan dijelaskan di panduan MCP WhatsApp Kirimi. Kalau VS Code meminta Client ID, ikuti field oauth.clientId di dokumentasi VS Code; kami tidak menjanjikan VS Code mendaftarkan client sendiri.

Bagaimana memakainya di agent mode Copilot?

Buka chat Copilot dan pilih agent mode.
Tulis prompt yang menyebut server, misalnya: "Pakai server kirimi, tampilkan 5 percakapan WhatsApp terakhir yang belum dibalas."
Baca setiap prompt kepercayaan atau login yang muncul sebelum menyetujuinya.
Periksa ringkasan pengiriman dari Kirimi dengan teliti sebelum kamu setuju mengirim.

Untuk mengatur alat yang aktif, gunakan Chat: Open Customizations lalu Tools. Kalau daftar alat di server berubah, jalankan MCP: Reset Cached Tools dari Command Palette. MCP: List Servers menampilkan server yang terpasang.

Alat yang tersedia dan batas pengiriman

Server Kirimi menyediakan 16 alat. Alat baca meliputi list_conversations, get_conversation_messages (maksimal 50 pesan per panggilan), search_contacts, dan list_templates. Pengiriman berjalan dua langkah: prepare_message hanya menyiapkan ringkasan dan token konfirmasi, lalu confirm_send mengirim setelah kamu setuju. Token berlaku 10 menit dan sekali pakai. Batas per koneksi: baca 60 per menit, kirim 10 per menit dan 200 per jam. Konektor remote tidak punya alat broadcast.

Karena AI membaca isi pesan pelanggan, pahami juga risikonya di artikel keamanan AI membaca chat WhatsApp. Alat Kirimi menginstruksikan AI untuk tidak mengikuti perintah yang tertulis di dalam pesan pelanggan.

Bagaimana dengan deeplink satu klik?

Panduan di dashboard Kirimi (menu Integrasi, "MCP untuk AI") menyediakan deeplink untuk VS Code. Dokumentasi VS Code yang kami baca tidak mendokumentasikan format deeplink tersebut, jadi anggap itu pintasan dari Kirimi dan bukan fitur terdokumentasi VS Code. Jalur Command Palette atau JSON manual di atas yang terdokumentasi.

Apa yang dilakukan kalau server tidak jalan?

Server tidak muncul: periksa kunci root. Di .vscode/mcp.json harus servers.
Alat tidak terpakai: server bisa berjalan tanpa alatnya dipanggil. Sebut nama server di prompt.
Alat lama masih tampil: jalankan MCP: Reset Cached Tools.
Terlanjur menolak prompt kepercayaan: jalankan MCP: Reset Trust dari Command Palette.
Server dibatasi: kebijakan organisasi bisa membatasi server MCP; minta admin memeriksa allowlist.
Login gagal atau minta Client ID: ikuti dokumentasi VS Code, lalu coba lagi dari MCP: List Servers.
Kirimi menolak akses: konektor ini butuh paket Basic atau Pro, jadi periksa paket akunmu.

Pemakai Claude Code bisa membandingkan alurnya di setup MCP dari terminal.

Apa yang bisa dicek setelah server tersambung?

Kalau MCP: List Servers menampilkan kirimi dan login sudah selesai, coba satu prompt baca saja dulu sebelum mengaktifkan scope kirim. Panduan untuk aplikasi lain ada di dash.kirimi.id/integrations/mcp, dan akun baru bisa dibuat di dash.kirimi.id/register.

Pertanyaan yang sering diajukan

Kenapa server Kirimi tidak muncul di VS Code padahal mcp.json sudah diisi?

Penyebab paling umum adalah kunci root yang salah. Di format VS Code, daftar server harus berada di bawah "servers", bukan "mcpServers". Cek juga bahwa JSON valid, lalu jalankan MCP: List Servers dari Command Palette untuk melihat server yang terpasang.

Apakah VS Code mendaftarkan OAuth client untuk server Kirimi secara otomatis?

Dokumentasi VS Code hanya menyebut browser terbuka untuk otorisasi pada koneksi pertama dan menyediakan field oauth.clientId untuk server yang butuh client ID. Server Kirimi mendukung pendaftaran client otomatis (Dynamic Client Registration), tetapi kami tidak menguji alur ini di VS Code. Jika VS Code meminta Client ID, ikuti dokumentasi VS Code.

Apa bedanya "servers" dan "mcpServers" di file konfigurasi MCP?

"servers" adalah kunci root untuk format mcp.json milik VS Code. "mcpServers" dipakai format portabel, misalnya file Copilot global dan contoh konfigurasi Cursor. Menyalin potongan JSON antar-editor tanpa mengganti kunci ini adalah sumber error yang sering.

Apakah AI bisa mengirim pesan WhatsApp tanpa persetujuan saya?

Tidak. Pengiriman selalu dua langkah (prepare_message lalu confirm_send) dan butuh persetujuanmu; detailnya ada di artikel keamanan AI membaca chat WhatsApp.

Paket Kirimi apa yang dibutuhkan?

Per Oktober 2026, konektor MCP remote Kirimi butuh paket dengan fitur chat (inbox): Basic (Rp49.000/bulan) atau Pro (Rp99.000/bulan). Paket Free dan Lite tidak termasuk.

Bagaimana mencabut akses VS Code ke akun Kirimi?

Buka dash.kirimi.id/settings?tab=apps (Aplikasi Terhubung) lalu klik Cabut akses pada aplikasi VS Code.