Lewati ke konten utama
Mailera

MCP

Gunakan Mailera di Claude

Tambahkan server MCP Mailera ke Claude Code dengan satu perintah, atau ke Claude Desktop melalui penghubung mcp-remote. Claude dapat membaca, mencari, dan membalas pesan di seluruh kotak surat yang terhubung.

Dokumentasi resmi Claude

Sebelum memulai

  1. Buat workspace gratis dan hubungkan setidaknya satu kotak surat.
  2. Buka Pengaturan → API key, buat API key, lalu pilih izin. Izin read sudah cukup untuk memulai.
  3. Salin API key segera setelah dibuat — Mailera hanya menampilkan API key lengkap sekali.

Penyiapan

Claude Code

  1. Buka terminal di direktori proyek Anda dan jalankan perintah di bawah ini, dengan mengganti API key-nya dengan milik Anda.
  2. Di Claude Code, ketik /mcp: mailera seharusnya menampilkan status terhubung dan daftar alatnya.

Ganti mh_live_xxx dengan API key Anda.

Terminal
claude mcp add --transport http mailera https://mailera.app/api/public/v1/mcp \  --header "Authorization: Bearer mh_live_xxx"

Claude Desktop

  1. Instal Node.js 18 atau lebih baru — penghubung mcp-remote berjalan melalui npx.
  2. Di Claude Desktop, buka Settings → Developer → Edit Config, tempel blok mailera ke mcpServers, lalu simpan.
  3. Tutup Claude Desktop sepenuhnya, lalu buka kembali. Alat Mailera muncul di bawah tombol alat pada panel chat.

Ganti mh_live_xxx dengan API key Anda.

claude_desktop_config.json
{  "mcpServers": {    "mailera": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://mailera.app/api/public/v1/mcp",        "--header",        "Authorization:${AUTH_HEADER}"      ],      "env": {        "AUTH_HEADER": "Bearer mh_live_xxx"      }    }  }}

Connectors (custom connector) di claude.ai dan Claude Desktop belum dapat digunakan dengan Mailera: fitur ini hanya mendukung server yang menggunakan OAuth atau tanpa autentikasi, sedangkan Mailera menggunakan API key.

Periksa koneksi

Minta agen: “Tampilkan daftar kotak surat Mailera saya”. Agen memanggil list_mailboxes dan menampilkan kotak surat beserta status sinkronisasinya. Lalu coba: “Cari email terbaru dari noreply@… dan ambil OTP-nya”.

Daftar alat dan panduan keamanan

Kesalahan umum

401 unauthorized
API key tidak valid, telah dicabut, atau tidak menyertakan Bearer. Header harus berupa Authorization: Bearer mh_live_…
Tidak dapat menemukan send_email atau rescue_spam
API key tidak memiliki izin yang diperlukan (send, move). Mailera hanya menampilkan alat yang sesuai dengan izinnya — buat API key baru dengan izin yang Anda perlukan.
Agen tidak dapat menemukan kotak surat
API key dibatasi ke grup tanpa kotak surat, atau workspace belum memiliki kotak surat yang terhubung.
429 rate_limited
API key ini telah melampaui 300 permintaan per menit. Tunggu selama jumlah detik yang ditentukan dalam Retry-After, lalu coba lagi.

Aplikasi lain

Gunakan Mailera di Claude

Buka Pengaturan → API key, buat API key, lalu pilih izin. Izin read sudah cukup untuk memulai.

Buat workspace gratis