Mailketing MCP Server

Ringkasan

1 · Buat Token

1. Login ke dashboard Mailketing, buka Pengaturan → Integrasi Claude (MCP).
2. Pada kartu Token akses Claude, lihat bagian Buat token baru di sebelah kanan.
3. Isi nama token (mis. Claude laptop kantor) dan pilih tingkat akses (wajib):

   Tingkat akses	Yang bisa dilakukan
   Baca saja	Melihat kredit, list, subscriber, campaign, autoresponder, statistik, laporan bounce/unsubscribe, template, web form, gambar.
   Baca dan buat data	Ditambah membuat list, menambah/mengubah subscriber, membuat template, campaign, autoresponder, pause autoresponder, menambah dan memverifikasi sender domain sendiri, serta mengunggah gambar.
   Baca, buat data, dan kirim	Ditambah email transaksional, jadwal campaign, aktivasi autoresponder, pause/hapus jadwal yang belum berjalan. Setiap pengiriman tetap menunggu konfirmasi.

4. Klik Buat token dan salin token yang tampil. Token hanya ditampilkan sekali.

Daftar token aktif (nama, 4 karakter akhir, izin, terakhir dipakai) tampil di kartu yang sama. Untuk menaikkan atau menurunkan izin, pilih tingkat akses baru pada token lalu klik Simpan. Izin baru langsung berlaku tanpa mengganti token atau pengaturan konektor. Klik Cabut untuk menghentikan akses sebuah token seketika. Maksimal 10 token aktif per akun.

2 · Hubungkan Claude.ai

1. Di Claude.ai buka Settings → Connectors → Add custom connector.
2. Nama: Mailketing. URL server: https://api.mailketing.co.id/mcp
3. Tambahkan request header Authorization dengan nilai Bearer mkm_… (atau cukup mkm_…).
4. Simpan, aktifkan connector di percakapan, lalu coba: "Berapa sisa kredit Mailketing saya?"

Claude.ai meminta persetujuan Anda sebelum menjalankan tool yang mengubah data atau mengirim email. Untuk pengiriman, server juga mewajibkan konfirmasi dua langkah.

Klien MCP Lain

Klien apa pun yang mendukung MCP lewat HTTP dengan header kustom bisa dipakai. Contoh konfigurasi (format bisa berbeda antarversi klien):

Cursor / Windsurf (mcp.json)

{
  "mcpServers": {
    "mailketing": {
      "url": "https://api.mailketing.co.id/mcp",
      "headers": { "Authorization": "Bearer mkm_TOKEN_ANDA" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "mailketing": {
      "type": "http",
      "url": "https://api.mailketing.co.id/mcp",
      "headers": { "Authorization": "Bearer mkm_TOKEN_ANDA" }
    }
  }
}

Claude Desktop (lewat mcp-remote)

{
  "mcpServers": {
    "mailketing": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.mailketing.co.id/mcp",
               "--header", "Authorization: Bearer mkm_TOKEN_ANDA"]
    }
  }
}

Tools · Baca izin: baca

Daftar dipaginasi maksimal 50 baris per panggilan. Waktu ditampilkan dalam zona waktu akun.

Tools · Buat Data izin: buat data

Field subscriber

fields berupa objek: first_name, last_name, city, country, company, post_code, state, mobile (dinormalisasi ke format 62…), phone, title, birth_date (YYYY-MM-DD), serta custom field list memakai nama variabelnya, mis. "kota": "Bandung".

Tools · Kirim izin: kirim

• Email transaksional: sama dengan API /send; from_email boleh alamat apa pun di domain sender yang aktif.
• Jadwal campaign: satu campaign hanya bisa dijadwalkan sekali ke list yang sama, termasuk jadwal yang di-pause atau sudah dihapus. Buat campaign baru untuk mengirim ulang ke list yang sama.
• Jadwal yang sudah berjalan atau selesai tidak bisa diubah lewat MCP; kelola dari menu Schedule Campaign di dashboard.

Tools · Gambar

Semua cara mengembalikan URL https://cdn.mailketing.co.id/uploaded_images/<id akun>/… dan potongan <img> siap pakai. Detail di Gambar & Link Unggah.

Konfirmasi Dua Langkah

Semua aksi yang mengirim email atau mengaktifkan pengiriman berjalan dalam dua langkah:

1. Prepare. Tool prepare_* memvalidasi permintaan dan mengembalikan ringkasan (penerima, perkiraan jumlah penerima dan kredit, pengirim, waktu kirim, peringatan) serta confirmation_code. Belum ada yang dikirim.
2. Confirm. Setelah Anda menyetujui ringkasan, Claude memanggil confirm_send. Server memvalidasi ulang semuanya lalu menjalankan aksi.

// prepare_schedule_campaign → ringkasan
{
  "status": "menunggu konfirmasi",
  "summary": {
    "action": "Jadwalkan campaign",
    "schedule_name": "Promo Harbolnas",
    "lists": [{ "list_id": 12776, "name": "Growth Hack" }],
    "send_at": "2026-11-11 09:00 (+07:00)",
    "estimated_recipients": 3355,
    "credits_now": 120000,
    "warnings": []
  },
  "confirmation_code": "MK-7XPPRQS5",
  "expires_in_minutes": 10
}

// confirm_send { "confirmation_code": "MK-7XPPRQS5" }
{ "done": true, "action": "schedule_campaign", "schedule_campaign_id": 132422, ... }

• Kode berlaku 10 menit, sekali pakai, dan hanya bisa dipakai oleh token yang membuatnya.
• Perkiraan penerima menghitung alamat unik aktif di list terpilih, sebelum dikurangi suppression.

Aturan Konten Email

Variabel personalisasi

Format selalu %%nama%% dengan huruf kecil. Custom field memakai nama field dengan spasi diganti garis bawah (mis. Nama Toko → %%nama_toko%%). Custom field yang kosong pada subscriber diganti teks kosong.

Format lain seperti {{first_name}}, *|FNAME|*, %nama%, atau [first_name] ditolak dengan saran variabel yang benar.

Tautan berhenti berlangganan

Wajib untuk campaign dan autoresponder, dan harus berupa atribut href:

<a href="%%unsubscribelink%%">Berhenti berlangganan</a>

Teks %%unsubscribelink%% di luar href tidak diganti saat kirim, sehingga ditolak. Tidak boleh di subject. Untuk email transaksional tidak wajib.

Bentuk isi

Isi berupa HTML (maks 500 KB). Teks polos otomatis dibungkus HTML sederhana.

Gambar & Link Unggah

Aturan gambar

• Setiap gambar wajib berupa <img src="…"> dengan URL CDN Mailketing: https://cdn.mailketing.co.id/uploaded_images/…, dan berkasnya harus ada.
• Format: PNG, JPG, GIF. Maks 5 MB per gambar.
• Ditolak: URL dari situs lain, http://, gambar base64 (data:), srcset, gambar latar CSS (background-image/url(…)), atribut background, SVG, <picture>.
• URL gambar Mailketing lama (mis. appmailketing.b-cdn.net) yang berkasnya masih ada otomatis diubah ke cdn.mailketing.co.id.
• Gambar disimpan di folder akun Anda. Folder ini dihapus bila akun tidak lagi aktif sebagai member Mailketing.

<img src="https://cdn.mailketing.co.id/uploaded_images/12345/FILE-20261027-1510ABCDEFGH.png"
     width="600" alt="Banner promo" style="display:block;max-width:100%;height:auto;border:0;">

Link unggah sekali pakai

1. Minta Claude membuat link unggah (tool create_image_upload_link).
2. Buka link https://api.mailketing.co.id/mcp_upload?t=… di browser, pilih gambar, klik Unggah gambar. Halaman menampilkan URL CDN.
3. Beri tahu Claude bahwa gambar sudah diunggah. Claude mengambil URL lewat get_image_upload_status.

Link berlaku 60 menit dan hanya untuk satu gambar. Bila file ditolak (bukan gambar atau terlalu besar), link tetap bisa dipakai lagi. Unggahan otomatis juga bisa lewat:

curl -sS -F "file=@banner.png" "https://api.mailketing.co.id/mcp_upload?t=TOKEN_LINK&format=json"

{"ok":true,"url":"https://cdn.mailketing.co.id/uploaded_images/12345/FILE-…png","width":600,"height":300,"bytes":48211,"type":"png"}

Step Link

Setiap list punya step link https://be.mailketing.co.id/step/<list_id> (lihat get_list). Pasang sebagai tautan di campaign atau autoresponder, tanpa ID subscriber; Mailketing menambahkannya otomatis saat mengirim.

• Subscriber yang mengklik disalin ke list tersebut, sehingga autoresponder, rules, dan webhook list itu ikut berjalan. Cocok untuk "klik untuk ikut webinar" atau tahap funnel berikutnya.
• Setelah klik, subscriber diarahkan ke step_url list (atur dengan set_list_step_url atau saat create_list); bila kosong, tampil halaman konfirmasi bawaan.
• Step link ke list akun lain atau list yang tidak ada ditolak.
• Tidak berfungsi di email transaksional.

Lampiran

• Lampiran file hanya untuk email transaksional (prepare_send_email, parameter attachments): maks 3 URL publik http(s), maks 25 MB per berkas.
• Berkas diunduh saat prepare, sehingga URL yang salah langsung ketahuan. Ringkasan menampilkan nama dan ukuran berkas.
• Campaign, autoresponder, dan template tidak bisa membawa lampiran. Cantumkan tautan unduhan di isi email sebagai gantinya.

Contoh Permintaan

Protokol & Uji Manual

Server menerima JSON-RPC 2.0 lewat POST (juga batch). initialize, tools/list, dan ping bisa dipanggil tanpa token; tools/call wajib token. Versi protokol yang didukung: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05.

# Daftar tools
curl -s https://api.mailketing.co.id/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Panggil tool
curl -s https://api.mailketing.co.id/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mkm_TOKEN_ANDA" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_account_overview","arguments":{}}}'

Hasil tool berupa teks JSON di result.content[0].text. Bila tool menolak permintaan (input salah, data tidak ditemukan, izin kurang), result.isError bernilai true dan teksnya berisi penjelasan dalam Bahasa Indonesia agar asisten AI bisa memperbaiki permintaannya.

{
  "jsonrpc": "2.0", "id": 2,
  "result": {
    "content": [{ "type": "text", "text": "{\"account\":{...},\"credits\":120000,...}" }],
    "isError": false
  }
}

Batas & Error

Pesan yang sering muncul

FAQ

Apakah Claude bisa mengirim email tanpa sepengetahuan saya?

Ada beberapa lapis pengaman, tetapi persetujuan akhirnya ada di percakapan Anda dengan Claude:

• Token harus diberi izin kirim secara eksplisit. Token dengan izin baca atau buat data bahkan tidak melihat tool kirim.
• Setiap pengiriman dua langkah: prepare_* membuat ringkasan dan kode konfirmasi, lalu confirm_send menjalankannya. Claude diinstruksikan menampilkan ringkasan dan menunggu persetujuan Anda sebelum memanggil confirm_send.
• Claude.ai menanyakan izin sebelum menjalankan tool, kecuali Anda memilih "selalu izinkan". Untuk token berizin kirim, sebaiknya biarkan confirm_send tetap meminta izin.
• Email transaksional dibatasi 100 per akun per 24 jam lewat MCP.
• Semua permintaan kirim dan hasilnya tercatat di Aktivitas Claude pada kartu MCP di dashboard.

Kode konfirmasi diberikan ke Claude, jadi server tidak bisa memastikan manusia benar-benar sudah menyetujui. Berikan izin kirim hanya pada token yang benar-benar perlu, dan cabut token yang tidak lagi dipakai.

Apakah MCP bisa menghapus list, subscriber, atau campaign?

Tidak secara langsung. Yang bisa dihapus: jadwal campaign yang belum mengirim apa pun dan rule list. Rule remove yang dibuat lewat prepare_create_rule akan menghapus subscriber dari list tujuan, karena itu wajib dikonfirmasi lebih dulu. Jadwal yang belum mulai dan autoresponder yang sedang running bisa di-pause.

Data apa yang bisa dilihat asisten AI?

Hanya data akun pemilik token, sesuai izin token. Data subscriber dibaca per alamat atau per list, tanpa ekspor massal.

Bagaimana menghentikan akses?

Klik Cabut pada token di kartu MCP. Koneksi yang memakai token itu langsung berhenti bekerja.

Apakah memakai kredit?

Membaca dan membuat data tidak memakai kredit. Pengiriman (email transaksional, campaign, autoresponder) memakai kredit seperti biasa.

Changelog