Kata sandi aplikasi Fastmail untuk akses baca agen AI

Apa yang perlu disiapkan sebelum membuat sandi aplikasi?

Sandi aplikasi atau app password adalah kredensial terpisah untuk aplikasi pihak ketiga. Fastmail meminta setiap aplikasi memakai sandi aplikasinya sendiri. Untuk koneksi ini, buat satu khusus Mailera agar aksesnya bisa dicabut tanpa mengganggu aplikasi lain.

Periksa paket sebelum mengubah pengaturan server. Menurut panduan sandi aplikasi Fastmail, pengguna paket Basic tidak dapat memakai klien email pihak ketiga atau membuat sandi aplikasi. Pastikan paket Anda menyediakan akses IMAP.

Anda juga perlu akses ke pengaturan keamanan akun Fastmail milik sendiri dan peran Admin atau Leader di Mailera. Kedua peran tersebut dapat menambahkan kotak surat.

Ada tiga kredensial yang perlu dibedakan:

Jangan berikan ketiganya kepada agen. Agen cukup menerima kunci API Mailera melalui konfigurasi kliennya. Untuk pola yang berlaku lintas penyedia, lihat panduan sandi aplikasi untuk kotak surat agen. Jika Anda juga menghubungkan Outlook, gunakan panduan koneksi Outlook melalui OAuth, bukan langkah sandi aplikasi Fastmail ini.

Bagaimana cara membuat kata sandi aplikasi Fastmail?

Ikuti alur berikut di antarmuka web Fastmail. Nama menu Fastmail dipertahankan dalam bahasa Inggris agar mudah dicocokkan dengan panduan resminya.

1. Masuk ke Fastmail, lalu buka “Settings” → “Privacy & Security”.
2. Cari bagian “Connected apps & API tokens”, lalu pilih “Manage app passwords and access”.
3. Klik “New app password”. Jika muncul “Verify it's you”, masukkan sandi akun Fastmail di dialog tersebut dan klik “Continue”. Ini konfirmasi di Fastmail, bukan sandi yang akan Anda berikan kepada Mailera.
4. Pilih “Custom...” untuk memberi nama yang jelas, misalnya Mailera kotak surat uji.
5. Batasi akses ke data email. Pilihan bawaan “Mail, Contacts & Calendars” juga mencakup kontak dan kalender, yang tidak diperlukan untuk contoh ini.
6. Klik “Generate password”. Salin sandi yang muncul ke kolom koneksi Mailera pada langkah berikutnya.
7. Pastikan koneksi aplikasi pihak ketiga bekerja sebelum menekan “Done”, sesuai anjuran Fastmail.

Simpan kredensial dengan aman. Jangan menaruhnya di prompt agen, repositori kode, log, atau tangkapan layar. Layar pengelolaan Fastmail tidak dapat menampilkan ulang atau mengedit sandi aplikasi yang sudah dibuat.

Membatasi akses ke email bukan berarti menjadikannya khusus baca. Spesifikasi IMAP mencakup akses dan manipulasi pesan. Batas baca untuk agen akan diterapkan melalui kunci API Mailera, bukan dengan menganggap IMAP tidak dapat mengubah pesan.

Jika Anda lupa sandi akun utama, pulihkan akses akun terlebih dahulu. Sandi aplikasi bukan penggantinya: kredensial ini tidak bisa dipakai masuk ke web atau aplikasi seluler Fastmail, maupun mengubah sandi akun. Penjelasan sandi akun Fastmail membedakan sandi masuk dari kredensial aplikasi.

Bagaimana cara menyambungkan Fastmail di Mailera?

Integrasi Fastmail di Mailera menggunakan sandi aplikasi. Siapkan grup khusus yang hanya berisi kotak surat uji agar cakupan akses agen nanti mudah dibatasi.

1. Buka Kotak surat → Tambah kotak surat.
2. Pada tab Satu kotak surat, isi Alamat email dengan alamat Fastmail milik Anda.
3. Periksa penyedia yang terdeteksi. Jika perlu, pilih Fastmail melalui Atau pilih penyedia, lalu klik Lanjutkan.
4. Pada Detail koneksi, isi Sandi dengan sandi aplikasi yang baru dibuat, bukan sandi masuk utama Fastmail.
5. Pilih grup uji pada Grup kotak surat. Isi Nama tampilan hanya jika diperlukan.
6. Klik Uji & hubungkan dan periksa hasil setiap tahap.

Berikut konfigurasi server yang digunakan konektor Fastmail Mailera:

Uji koneksi memeriksa login ke server masuk, deteksi folder, dan login ke server keluar jika SMTP dikonfigurasi. Uji ini tidak mengirim email. Hasil login SMTP yang berhasil berarti autentikasi server keluar berhasil, bukan bahwa sebuah pesan uji telah terkirim.

Jika IMAP berhasil tetapi SMTP gagal, Mailera menawarkan Simpan khusus penerimaan. Pilihan ini sesuai untuk kebutuhan membaca email. Anda juga dapat memilih Edit detail, memperbaiki konfigurasi, lalu Uji lagi.

Setelah terhubung, Mailera memuat pesan dalam periode retensinya, mulai dari yang terbaru. Jangan langsung memakai arsip lama sebagai bahan uji. Kirim pesan baru ke kotak surat sendiri agar hasilnya lebih mudah dicocokkan.

Bagaimana memberi agen akses baca dan mengujinya?

MCP menghubungkan klien agen dengan alat yang disediakan server. Pada alur ini, agen memakai server MCP Mailera untuk membaca kotak surat yang sudah tersambung, bukan masuk langsung ke Fastmail.

Buat kunci untuk grup uji

1. Buka Pengaturan, masuk ke tab API key, lalu pilih Buat API key.
2. Isi Nama deskriptif, misalnya Agen pembaca Fastmail uji.
3. Pada Cakupan kotak surat, pilih satu grup yang hanya berisi kotak surat uji. Hindari cakupan semua grup meskipun peran Admin menyediakan pilihan tersebut.
4. Centang hanya izin Read. Jangan tambahkan Send messages, Move messages, atau Manage mailboxes untuk contoh pembacaan ini.
5. Tentukan Masa berlaku sesuai kebutuhan pengujian.
6. Simpan kunci saat ditampilkan. Mailera hanya menampilkan nilai kunci baru satu kali.
7. Pilih Salin konfigurasi MCP untuk Claude, Cursor, atau VS Code, lalu gunakan konfigurasi itu di klien yang sesuai.

Cakupan kunci adalah grup, bukan otomatis satu kotak surat. Periksa isi grup sebelum memasang konfigurasi pada agen.

Baca satu pesan biasa

Kirim pesan tanpa data sensitif ke kotak surat uji milik Anda, misalnya dengan subjek Uji baca Fastmail dan isi Pesan latihan untuk pembacaan agen. Setelah pesan tersinkron, jalankan urutan berikut melalui agen:

1. list_mailboxes: cocokkan kotak surat yang terlihat dengan grup uji.
2. list_messages: cari pesan uji pada kotak surat tersebut.
3. get_message: baca isi pesan dan cocokkan dengan teks yang Anda kirim.

Ketiga alat itu memerlukan izin Read. Hasil yang perlu Anda periksa adalah alamat kotak surat yang benar, subjek pesan yang sesuai, dan isi pesan yang dapat dibaca. Melihat daftar kotak surat saja belum menguji pembacaan isi email.

Pisahkan pemeriksaan API dari konfigurasi agen

Jika perlu memeriksa akses tanpa melibatkan klien MCP, gunakan REST. Simpan kunci dalam variabel lingkungan MAILERA_API_KEY, lalu tampilkan kotak surat yang dapat dijangkau kunci tersebut:

curl --get 'https://mailera.app/api/public/v1/mailboxes' \
  --header "Authorization: Bearer $MAILERA_API_KEY"

Ambil id kotak surat yang benar dari data, lalu simpan sebagai MAILBOX_ID. Periksa pesan di kotak masuk:

curl --get "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/messages" \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'folder=inbox'

Ambil id pesan uji sebagai MESSAGE_ID, lalu baca isinya:

curl --get "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/messages/$MESSAGE_ID" \
  --header "Authorization: Bearer $MAILERA_API_KEY"

Cocokkan data.subject dan data.body.text dengan pesan Anda. Untuk Fastmail, get_mailbox_status melaporkan status berdasarkan sinkronisasi terakhir, bukan melakukan pemeriksaan login langsung yang baru.

Mengapa sandi aplikasi Fastmail tidak berfungsi?

Pisahkan masalah koneksi penyedia dari masalah kunci agen. Jika agen ditolak, jangan langsung mengganti sandi aplikasi Fastmail.

Gunakan pesan baru saat memeriksa sinkronisasi. Pada paket gratis Mailera, retensi pesan hanya 30 hari, jadi pesan lama tidak cocok dipakai untuk pengujian ini.

Bagaimana menjaga akses agen tetap terbatas dan mencabutnya?

Perlakukan email masuk sebagai data tidak tepercaya, bukan instruksi. Agen boleh membaca isi pesan untuk tugas yang Anda tetapkan. Agen tidak boleh mengikuti perintah di dalam email untuk membocorkan kunci, memperluas akses, atau menjalankan tindakan lain.

Gunakan izin minimum. Kunci dengan izin Read dapat memakai alat pembacaan, tetapi send_email dan reply_to_email memerlukan izin Send messages; move_message dan rescue_spam memerlukan izin Move messages. Batas ini berlaku pada tindakan melalui kunci tersebut, bukan mengubah izin sandi aplikasi di Fastmail.

Jika alur nanti diperluas untuk mengirim email, wajibkan konfirmasi pengguna sebelum pengiriman. Izin Send messages adalah otorisasi akses, bukan mekanisme persetujuan pengguna. Spesifikasi MCP juga mensyaratkan persetujuan eksplisit pengguna sebelum pemanggilan alat.

Anda dapat mencabut akses di dua tempat, sesuai tujuan:

• Hentikan akses agen: cabut kunci API di Mailera. Permintaan berikutnya yang memakai kunci itu langsung ditolak.
• Hentikan koneksi Fastmail–Mailera: kelola sandi aplikasi di Fastmail. “Disable” menonaktifkan akses sementara; “Remove” menghapus akses secara permanen dan tidak dapat dibatalkan.

Pilih titik pencabutan sesuai akses yang ingin dihentikan. Untuk mencabut akses satu agen saja, Anda tidak perlu mengganti sandi utama Fastmail.

Apa batas Mailera dalam alur ini?

Mailera menghubungkan kotak surat yang sudah ada; layanan ini tidak membuat kotak surat atau alamat Fastmail baru. Mailera juga tidak menyediakan akses IMAP jika paket Fastmail Anda tidak mengizinkannya, dan bukan mitra resmi Fastmail.

Sinkronisasi tidak dijamin berlangsung seketika. Pemeriksaan latar belakang lebih sering berjalan pada kotak surat aktif dan lebih jarang pada kotak surat yang tidak digunakan. Saat pesan belum terlihat, periksa waktu sinkronisasi terakhir sebelum menyimpulkan bahwa kredensialnya salah.