Hubungkan asisten AI Anda ke Unbox

Ikhtisar

Unbox MCP diperuntukkan bagi pemilik akun pribadi yang menginginkan asisten AI — di Cursor, Workbuddy, OpenClaw, atau host mana pun yang kompatibel dengan MCP — untuk bekerja dengan email yang dihosting mereka. Ini bukan API pengembang untuk membangun aplikasi di Unbox; untuk pengiriman transaksional dari domain Anda, lihat dokumentasi HTTP API kami.

Yang dapat dilakukan agen

Setelah Anda masuk, agen Anda dapat memanggil alat Unbox atas nama Anda:

• Baca kotak masuk & utas — Daftar percakapan, buka utas, dan ambil pesan individual.
• Cari email — Temukan pesan di seluruh kotak masuk Anda dengan kueri bahasa alami.
• Kirim & balas — Tulis email baru atau balas utas dari alamat Unbox Anda, sesuai dengan batas kirim paket Anda.
• Atur — Tandai spam, pulihkan dari spam, pindahkan ke tempat sampah, atau pulihkan — satu pesan dalam satu waktu.

Pengosongan massal spam atau tempat sampah, pembuatan kunci API, dan tindakan ruang kerja tim tidak tersedia melalui MCP di v1.

Cara kerjanya

Klien AI Anda terhubung ke server Unbox MCP. Server memanggil API akun Unbox menggunakan sesi web normal — jenis yang sama seperti saat Anda masuk di unbox.im.

1. Tambahkan Unbox ke konfigurasi klien MCP Anda (lihat Pengaturan di bawah).
2. Minta agen Anda untuk masuk — agen akan membuka tautan browser tempat Anda menyetujui akses dengan akun Unbox Anda.
3. Setelah terhubung, minta agen Anda untuk membaca email, menulis draf balasan, atau mengatur pesan.

Masuk

Unbox menggunakan login browser sehingga Anda selalu menyetujui akses. Agen Anda memulai alur dengan alat login, lalu Anda menyelesaikan masuk di browser:

1. Agen Anda memanggil unbox_login_start dan menampilkan URL browser kepada Anda.
2. Buka tautan, masuk ke Unbox jika perlu, dan salin kode tautan satu kali yang ditampilkan di halaman.
3. Tempelkan kode kembali ke agen Anda (unbox_login_complete).
4. Sesi Anda tetap aktif selama periode sesi web Unbox normal — masuk lagi saat sesi kedaluwarsa.

URL Login (untuk referensi)

https://unbox.im/id/auth/desktop/link?source=mcp

Butuh akun dulu? Buat Unbox ID Anda, lalu kembali untuk menghubungkan agen Anda.

Pengaturan

Tambahkan Unbox sebagai server MCP di klien AI Anda. Transport HTTP jarak jauh adalah cara termudah untuk terhubung ke cloud Unbox:

HTTP Jarak Jauh (disarankan)

Arahkan klien MCP Anda ke endpoint MCP Unbox. Setelah menambahkan server, gunakan alat login untuk mengautentikasi:

{
  "mcpServers": {
    "unbox": {
      "url": "https://unbox.im/api/mcp"
    }
  }
}

HTTP MCP mungkin dinonaktifkan pada beberapa deployment hingga diaktifkan oleh operator. Jika koneksi gagal, coba lagi nanti atau hubungi dukungan.

Alat umum

Setelah masuk, agen Anda dapat menggunakan alat seperti:

• unbox_login_start — buka login browser
• unbox_login_complete — tukar kode tautan dengan sesi
• unbox_list_threads — feed kotak masuk
• unbox_search_inbox — cari pesan
• unbox_reply_to_email — balas pesan
• unbox_send_email — kirim email baru

Klien yang didukung

Setiap host agen yang kompatibel dengan MCP dapat terhubung ke Unbox. Kami menguji dan mendokumentasikan:

• Cursor — Tambahkan Unbox di bawah server MCP di pengaturan Cursor, lalu masuk melalui alur browser.
• Workbuddy — Konfigurasikan URL server MCP jarak jauh yang mengarah ke Unbox, lalu autentikasi dengan akun Anda.
• OpenClaw — Hubungkan OpenClaw ke endpoint HTTP MCP Unbox dan selesaikan login browser.

Keamanan

• Login browser — Anda masuk melalui Unbox di browser Anda — agen tidak pernah melihat kata sandi Anda.
• Hanya pemilik akun — Akses MCP terbatas hanya untuk pemilik akun pribadi, bukan anggota tim atau ruang kerja bersama.
• Batas yang sama dengan aplikasi web — Kuota pengiriman, aturan spam, dan kebijakan transaksional berlaku untuk tindakan agen dengan cara yang sama seperti di antarmuka kotak masuk.
• Tidak ada penghapusan massal — Agen tidak dapat mengosongkan spam, mengosongkan tempat sampah, atau memutar kunci API melalui MCP di v1.