Pakai MCP untuk pekerjaan email lewat asisten dan REST API untuk peristiwa aplikasi. Bandingkan autentikasi, persetujuan, percobaan ulang, dan alur kerja Brew.

Seorang pengembang di tim Anda menghubungkan platform email ke Claude dan membuat draf kampanye minggu depan di jendela chat. Keesokan paginya, seseorang bertanya apakah email sambutan untuk pendaftar baru juga bisa dijalankan dengan cara yang sama, lewat asisten. Dokumentasi platform itu mencantumkan server MCP dan REST API secara berdampingan.
Sebagian besar platform email yang mendukung agen kini menawarkan dua pintu masuk ini. Server MCP memungkinkan asisten AI memanggil alat-alat platform di tengah percakapan. REST API menyediakan operasi yang bisa dipanggil langsung oleh kode Anda. Keduanya sering kali menjangkau endpoint yang sama di baliknya, jadi pilihannya bergantung pada siapa yang mengerjakan tugasnya dan kapan.
Gunakan MCP saat seseorang bekerja lewat asisten, dan gunakan REST API saat produk Anda perlu mengirim email tanpa ada yang mengawasi. Pada akhirnya, sebagian besar tim memakai keduanya.
MCP, atau Model Context Protocol, adalah standar terbuka untuk menyediakan alat bagi klien AI seperti Claude, ChatGPT, dan Cursor. Klien membaca daftar alat beserta deskripsi dan skemanya, lalu memilih alat yang akan dipanggil berdasarkan permintaan Anda. Server Brew berada di https://brew.new/api/mcp dan mendukung OAuth, jadi Anda cukup masuk dan memilih merek, tanpa perlu mengurus kunci.
REST API adalah sekumpulan endpoint HTTP yang dipanggil oleh kode Anda. Untuk API-nya, Brew memublikasikan spesifikasi OpenAPI, SDK TypeScript, dan panduan untuk agen dalam format teks biasa. Setiap panggilan membawa kunci API, dan kode Anda yang menentukan apa yang dipanggil dan kapan.
Vendor lain mengikuti pola yang sama. Server MCP Customer.io membungkus API-nya dalam alat terpisah untuk operasi baca, tulis, dan hapus. Brevo menghasilkan alat-alat MCP dari spesifikasi OpenAPI miliknya.
| MCP | REST API | |
|---|---|---|
| Siapa yang mengendalikan | Seseorang, lewat asisten | Kode Anda |
| Tugas umum | Membuat draf dan merevisi email, membangun audiens, menjadwalkan kampanye, membaca analitik | Menjalankan pemicu peristiwa, membuat atau memperbarui kontak, mengirim email transaksional, memeriksa status pengiriman secara berkala |
| Autentikasi | Masuk dengan OAuth, atau kunci API untuk klien tanpa OAuth | Kunci API, dengan cakupan merek atau organisasi |
| Keamanan | Brew menahan pengiriman nyata untuk dikonfirmasi pada koneksi OAuth dan koneksi organisasi | Kode Anda yang menentukan; gunakan kunci idempotensi dan langkah peninjauan Anda sendiri |
| Penanganan kegagalan | Asisten membaca error, lalu mencoba lagi atau bertanya kepada Anda | Anda membuat percabangan berdasarkan kode error yang stabil dan mencoba ulang dengan backoff |
| Ukuran respons | Dibatasi oleh jendela konteks asisten | Hanya dibatasi oleh paginasi |
| Paling tepat saat | Tugas membutuhkan pertimbangan atau iterasi | Tugas harus berjalan dengan cara yang sama setiap kali |
Gunakan MCP saat pekerjaannya berupa percakapan:
create_email, edit_email, send_email dengan test: true, lalu send_email dengan scheduledAt, dan berhenti untuk menunggu persetujuan Anda.search_contacts, pencarian field, dan create_audience.get_email_analytics dan performa otomatisasi.Di Brew, email yang dibuat lewat MCP memakai dokumen merek yang sama dengan email yang dibuat di aplikasi. Artikel tentang MCP Brew membahas penyiapan kliennya.
Respons MCP harus muat di dalam konteks asisten. Artikel tentang Alur dari Brew mencatat bahwa meminta HTML lengkap lewat MCP hanya mengembalikan satu atau dua langkah pertama dari rangkaian yang panjang, sedangkan rute REST mengembalikan isi setiap email.
Gunakan API saat email menjadi bagian dari produk Anda:
POST /v1/automations/triggers/{triggerEventId}/fire dengan email dan field pengguna tersebut. Otomatisasi yang sudah dipublikasikan menangani sisanya.POST /v1/contacts membuat atau memperbarui hingga 1.000 kontak per permintaan.GET /v1/sends/{sendId} mengembalikan status dan statistik untuk dasbor atau peringatan.Pada endpoint yang mendukungnya, gunakan kembali Idempotency-Key dan isi permintaan yang sama untuk percobaan ulang dalam jendela waktu 24 jam yang terdokumentasi (pemicuan dideduplikasi berdasarkan kunci tersebut selama 90 hari). Gunakan kunci yang berbeda untuk operasi logis yang berbeda; baca kontrak endpoint sebelum berasumsi bahwa sebuah operasi tulis sudah tercakup. Header batas laju memberi tahu Anda kapan harus memperlambat permintaan. Respons error API menyertakan code, seperti CONSENT_REQUIRED, yang bisa Anda jadikan dasar percabangan. Tangani kegagalan jaringan secara terpisah. Panduan API dari Brew menjelaskan semua hal ini.
Agen coding di terminal sering kali bekerja lebih baik dengan CLI dibandingkan kedua opsi tadi. CLI Brew mengembalikan respons API sebagai satu baris JSON saat tidak terhubung ke terminal, dan memakai kode keluar (exit code) yang bisa ditindaklanjuti agen. Kode 4 berarti konfirmasi diperlukan, dan CLI mencetak perintah persis yang perlu dijalankan ulang dengan --yes setelah disetujui. CLI juga membuat kontrak payload bertipe dengan brew-cli types, sehingga panggilan pemicu dari backend Anda tetap selaras dengan skema pemicunya.
Berikut salah satu cara tim SaaS bisa membagi pekerjaannya:
user_signed_up dan otomatisasi sambutan, mengujinya dengan test_automation, lalu memublikasikannya.Pada langkah 1 dan 3, seseorang meninjau hasil kerja asisten. Langkah 2 dan 4 berjalan setiap kali ada pendaftaran atau setiap malam tanpa ada yang mengawasi.
MCP menambahkan asisten di antara Anda dan endpoint, sehingga sebuah permintaan butuh lebih banyak langkah, dan asisten bisa salah memilih alat. Itu tidak masalah untuk pekerjaan interaktif, tetapi keliru untuk peristiwa pendaftaran yang harus dipicu setiap kali.
Brew mewajibkan konfirmasi pengiriman nyata pada koneksi OAuth dan koneksi organisasi. Untuk klien yang memakai kunci API merek, atur kebijakan persetujuan Anda sendiri. Dengan API, lindungi kunci di variabel lingkungan, gunakan kunci dengan cakupan merek jika memungkinkan, dan tambahkan kunci idempotensi ke setiap operasi tulis yang dicoba ulang.
Bisa. Panduan integrasi agen dari Brew menjelaskan cara memasang endpoint API sebagai alat function calling, dengan SDK yang menangani autentikasi dan percobaan ulang.
Untuk mencoba keduanya, hubungkan server MCP di asisten Anda untuk pekerjaan kampanye, dan buat satu kunci API untuk pemicu yang akan dijalankan backend Anda.
