Lewati ke konten utama
Mailera

MCP

Gunakan Mailera di VS Code

Tambahkan Mailera ke .vscode/mcp.json agar Copilot Chat dalam mode Agent dapat mengakses kotak surat Anda. VS Code meminta API key saat pertama digunakan dan menyimpannya sebagai rahasia, sehingga API key tidak ada di file konfigurasi Anda.

Dokumentasi resmi VS Code

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

  1. Buat .vscode/mcp.json di workspace Anda, atau jalankan MCP: Open User Configuration untuk menggunakannya di semua workspace.
  2. Tempel konfigurasi di bawah ini. Saat pertama dijalankan, VS Code meminta API key Mailera Anda dan menyimpannya sebagai rahasia.
  3. Buka Chat dalam mode Agent dan klik ikon alat: alat mailera seharusnya muncul dalam daftar.
.vscode/mcp.json
{  "inputs": [    {      "type": "promptString",      "id": "mailera-api-key",      "description": "Mailera API key",      "password": true    }  ],  "servers": {    "mailera": {      "type": "http",      "url": "https://mailera.app/api/public/v1/mcp",      "headers": {        "Authorization": "Bearer ${input:mailera-api-key}"      }    }  }}

File ini tidak berisi API key, jadi Anda dapat melakukan commit agar seluruh tim bisa menggunakannya; setiap orang memasukkan API key sendiri.

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 VS Code

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

Buat workspace gratis