Menghubungkan AI coding agent ke API email lewat MCP: setup aman untuk Claude, Cursor, dan Windsurf

Cara memasang MCP server CapiMail agar AI coding agent bisa membaca dokumentasi, mengirim email uji, dan mengecek status, dengan batas dan persetujuan.

Tim CapiMailTerbit Diperbarui 2 menit baca
Daftar isi
  1. Apa yang bisa dilakukan agent lewat MCP CapiMail
  2. Pasang dengan key test lebih dulu
  3. Pengaman bawaan
  4. Tanpa MCP: dokumentasi untuk agent
  5. Contoh prompt untuk agent

AI coding agent seperti Claude Code, Cursor, dan Windsurf semakin sering menulis kode integrasi API. Masalahnya, agent sering menebak: nama field yang salah, endpoint lama, atau cara verifikasi webhook yang keliru. Model Context Protocol (MCP) menyelesaikan ini dengan memberi agent alat untuk membaca dokumentasi asli dan mencoba API secara langsung, dengan batas yang Anda tentukan.

Apa yang bisa dilakukan agent lewat MCP CapiMail

Server @capimail/mcp berjalan lokal di komputer Anda (lewat stdio) dan memanggil API publik CapiMail dengan key Anda. Alat yang tersedia dikelompokkan menurut tingkat akses (CAPIMAIL_MCP_ACCESS: read, draft, atau write):

JenisContoh alat
Bacasearch_docs, get_integration_guide, get_credits, get_email_status, check_suppression, get_validation_results, list_domain_monitors
Baca inbox (key live dengan inbound:read)list_inbound_addresses, list_inbound_messages, get_inbound_message, get_thread
Draf (akses draft)draft_reply: menyiapkan balasan yang Anda setujui dan kirim dari dasbor
Tulissend_email, send_otp, verify_otp, validate_emails, start_validation_job, check_domain, monitor_domain, add_suppression, reply_to_message, create_inbound_address

Pasang dengan key test lebih dulu

Mulailah dengan key test (cm_test_) dari Dashboard > API Keys. Dengan key test, semua alat tersedia tetapi tidak ada email yang benar-benar dikirim dan tidak ada kredit yang dipotong. Selalu pin versi server agar perubahan baru tidak masuk diam-diam.

Claude Code· bash
claude mcp add capimail --env CAPIMAIL_API_KEY=cm_test_your_key -- npx -y @capimail/mcp@0.4
Cursor (~/.cursor/mcp.json) atau Windsurf (~/.codeium/windsurf/mcp_config.json)· json
{
  "mcpServers": {
    "capimail": {
      "command": "npx",
      "args": ["-y", "@capimail/mcp@0.4"],
      "env": { "CAPIMAIL_API_KEY": "cm_test_your_key" }
    }
  }
}

Pengaman bawaan

  • Live key hanya baca secara default. Dengan cm_live_, alat tulis baru aktif jika Anda sengaja mengatur CAPIMAIL_MCP_ACCESS=write. Pilih draft kalau agent cukup menyiapkan balasan untuk Anda setujui.
  • Batas per panggilan. send_email maksimal 5 penerima per panggilan (CAPIMAIL_MCP_MAX_RECIPIENTS) dan validasi maksimal 100 alamat per panggilan (CAPIMAIL_MCP_MAX_VALIDATION).
  • Alat berisiko ditandai. add_suppression dan monitor_domain (biaya harian berulang) ditandai destructive, sehingga client meminta persetujuan Anda dulu.
  • Teks pihak ketiga ditandai tidak tepercaya. Hasil yang berisi pesan bounce, alamat, atau metadata diberi label agar agent memperlakukannya sebagai data, bukan instruksi. Ini mengurangi risiko prompt injection.
  • Base URL wajib HTTPS. Key hanya dikirim ke origin HTTPS, dan server memberi peringatan jika host-nya bukan capimail.com.

Alat tulis tetap bisa memakai kredit bila dipanggil berulang kali dengan live key, jadi biarkan persetujuan per panggilan tetap aktif di client Anda.

Tanpa MCP: dokumentasi untuk agent

Jika Anda tidak ingin memberi agent akses ke API, cukup arahkan agent ke sumber teks yang dibuat khusus untuk mesin: llms.txt untuk ringkasan, AGENTS.md untuk aturan integrasi yang bisa ditaruh di repository, dan spesifikasi OpenAPI di /openapi.yaml. Panduan lengkapnya ada di dokumentasi AI agent.

Contoh prompt untuk agent

Prompt yang memanfaatkan alat MCP· text
Tambahkan pengiriman email verifikasi ke endpoint /signup memakai @capimail/sdk.
Baca dokumentasi CapiMail lewat MCP dulu, pakai idempotency key per user,
lalu kirim satu email uji ke qa+signup@contoh.co.id dengan key test
dan tunjukkan status pengirimannya.

Pertanyaan yang sering diajukan

Apakah MCP server mengirim data saya ke pihak lain?

Tidak. Server berjalan lokal di komputer Anda dan hanya memanggil API CapiMail dengan key yang Anda berikan.

Apakah aman memakai live key dengan MCP?

Live key hanya mendapat alat baca secara default. Alat tulis perlu diaktifkan sengaja dengan CAPIMAIL_MCP_ACCESS=write, dan sebaiknya persetujuan per panggilan tetap aktif di client.

Semua artikel