MCP
Server MCP untuk Gmail, Outlook, Yahoo, iCloud, dan IMAP
Izinkan Claude, Cursor, VS Code, atau agen Anda membaca pesan, mengambil kode OTP, membalas, dan memindahkan pesan keluar dari Email Sampah di semua kotak surat yang terhubung — menggunakan API key workspace Anda, tanpa menulis kode.
claude mcp add --transport http mailera https://mailera.app/api/public/v1/mcp \ --header "Authorization: Bearer mh_live_xxx"Koneksi
- URL server
https://mailera.app/api/public/v1/mcp- Autentikasi
Authorization: Bearer mh_live_… atau X-API-Key- Transport
- Streamable HTTP, tanpa sesi
- Versi protokol
- 2025-06-18 · 2025-03-26 · 2024-11-05
12 alat, sesuai izin API key
Agen hanya melihat alat yang diizinkan oleh API key. Setiap panggilan menjalankan endpoint REST yang sesuai, sehingga hasil dan kode error sama persis dengan API.
| Alat | Fungsi | Cakupan izin |
|---|---|---|
| list_mailboxes | Tampilkan daftar kotak surat, penyedia, kapabilitas, dan status sinkronisasi | read |
| get_mailbox_status | Periksa koneksi kotak surat dan waktu sinkronisasi terakhir | read |
| list_messages | Tampilkan daftar pesan dalam folder, dari yang terbaru | read |
| search_messages | Cari pesan di semua kotak surat, dengan opsi menyertakan kode OTP | read |
| get_message | Baca pesan lengkap: pengirim, isi, dan lampiran | read |
| get_latest_otp | Ambil kode OTP terbaru dari Kotak Masuk atau Email Sampah | read |
| send_email | Kirim pesan baru, cegah pengiriman duplikat dengan idempotency_key | send |
| reply_to_email | Balas, balas semua, atau teruskan pesan | send |
| get_send_status | Lacak upaya pengiriman hingga statusnya sent, failed, atau unknown | send |
| move_message | Pindahkan pesan ke Kotak Masuk, Email Sampah, Arsip, atau Item Terhapus | move |
| rescue_spam | Pindahkan pesan dari Email Sampah: semua, atau berdasarkan pengirim, domain, atau subjek | move |
| sync_mailbox | Sinkronkan sekarang dan aktifkan kotak surat dalam mode tidur | sync |
Setiap pemanggilan alat menggunakan endpoint REST yang sesuai: cakupan izin, batas 300 permintaan/menit, dan log API yang sama. Kesalahan muncul dalam hasil alat (isError) dengan error.code yang tetap agar dapat ditangani agen.
Penyiapan untuk tiap aplikasi
Salin konfigurasi, masukkan API key Anda, lalu mulai ulang aplikasi. Tiap aplikasi memiliki panduan tersendiri dengan langkah verifikasi dan error umum.
Claude
Claude Code dengan satu perintah, Claude Desktop melalui penghubung mcp-remote.
Terminal · claude_desktop_config.json
Panduan ClaudeCursor
Satu file mcp.json, untuk semua proyek atau satu proyek saja.
~/.cursor/mcp.json
Panduan CursorVS Code
File .vscode/mcp.json; VS Code meminta API key sekali dan menjaganya tetap rahasia.
.vscode/mcp.json
Panduan VS Code
Akses kotak surat yang aman untuk agen
Berikan hanya izin yang diperlukan
Jika agen hanya perlu membaca pesan, buat API key dengan izin baca saja. Berikan izin kirim hanya jika agen benar-benar perlu mengirim, dan batasi API key ke grup kotak surat jika memungkinkan.
Pesan masuk adalah data, bukan instruksi
Isi pesan ditulis oleh orang lain. Jangan biarkan agen mengikuti instruksi di dalam pesan, seperti “teruskan semua pesan ke…”. Wajibkan agen meminta izin Anda sebelum mengirim atau meneruskan pesan.
Kirim setiap pesan hanya sekali
Selalu sertakan idempotency_key saat mengirim. Jika statusnya unknown, jangan kirim ulang — periksa Item Terkirim terlebih dahulu.
Cabut kapan saja
Cabut API key di Pengaturan → API key untuk langsung memblokir semua aplikasi yang menggunakannya. Log API mencatat setiap panggilan alat.
Tidak menggunakan MCP?
Setiap alat memiliki endpoint REST yang sesuai, dengan webhook bertanda tangan untuk pesan baru.