Sambungkan pembantu AI anda ke Unbox

Gambaran Keseluruhan

Unbox MCP adalah untuk pemilik akaun peribadi yang mahukan pembantu AI — dalam Cursor, Workbuddy, OpenClaw, atau mana-mana hos yang serasi dengan MCP — untuk bekerja dengan mel yang dihoskan mereka. Ia bukan API pembangun untuk membina aplikasi di atas Unbox; untuk penghantaran transaksi dari domain anda, lihat dokumentasi HTTP API kami.

Apa yang boleh dilakukan oleh ejen

Selepas anda log masuk, ejen anda boleh memanggil alat Unbox bagi pihak anda:

• Baca peti mel & utas — Senaraikan perbualan, buka utas, dan ambil mesej individu.
• Cari mel — Cari mesej di seluruh peti mel anda dengan pertanyaan bahasa semula jadi.
• Hantar & balas — Tulis mel baru atau balas kepada utas dari alamat Unbox anda, tertakluk kepada had penghantaran pelan anda.
• Urus — Tandai sebagai spam, pulihkan dari spam, pindahkan ke tong kitar semula, atau pulihkan — satu mesej pada satu masa.

Kosongkan spam atau tong secara pukal, penjanaan kunci API, dan tindakan ruang kerja pasukan tidak tersedia melalui MCP dalam v1.

Cara ia berfungsi

Pelanggan AI anda menyambung ke pelayan Unbox MCP. Pelayan memanggil API akaun Unbox menggunakan sesi web biasa — jenis yang sama yang anda perolehi apabila anda log masuk di unbox.im.

1. Tambahkan Unbox ke konfigurasi pelanggan MCP anda (lihat Persediaan di bawah).
2. Minta ejen anda untuk log masuk — ia akan membuka pautan pelayar di mana anda meluluskan akses dengan akaun Unbox anda.
3. Setelah disambungkan, minta ejen anda untuk membaca mel, menyediakan balasan, atau menyusun mesej.

Log Masuk

Unbox menggunakan log masuk penyemak imbas supaya anda sentiasa meluluskan akses. Ejen anda memulakan aliran dengan alat log masuk, kemudian anda selesaikan log masuk dalam penyemak imbas:

1. Ejen anda memanggil unbox_login_start dan menunjukkan URL penyemak imbas kepada anda.
2. Buka pautan, log masuk ke Unbox jika perlu, dan salin kod pautan sekali guna yang dipaparkan pada halaman.
3. Tampal kod itu kembali kepada ejen anda (unbox_login_complete).
4. Sesi anda kekal aktif untuk tempoh sesi web Unbox biasa — log masuk semula apabila ia tamat.

URL Log Masuk (untuk rujukan)

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

Perlukan akaun dahulu? Buat Unbox ID anda, kemudian kembali untuk menyambungkan ejen anda.

Persediaan

Tambahkan Unbox sebagai pelayan MCP dalam klien AI anda. Pengangkutan HTTP jauh adalah cara paling mudah untuk menyambung ke awan Unbox:

HTTP Jauh (disyorkan)

Arahkan klien MCP anda ke titik akhir MCP Unbox. Selepas menambah pelayan, gunakan alat log masuk untuk mengesahkan:

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

HTTP MCP mungkin dilumpuhkan pada sesetengah pelaksanaan sehingga diaktifkan oleh pengendali. Jika sambungan gagal, cuba lagi kemudian atau hubungi sokongan.

Alat biasa

Setelah log masuk, ejen anda boleh menggunakan alat seperti:

• unbox_login_start — buka log masuk penyemak imbas
• unbox_login_complete — tukar kod pautan untuk sesi
• unbox_list_threads — suapan peti masuk
• unbox_search_inbox — cari mesej
• unbox_reply_to_email — balas mesej
• unbox_send_email — hantar mel baharu

Klien yang disokong

Mana-mana hos ejen yang serasi dengan MCP boleh menyambung ke Unbox. Kami menguji dan mendokumentasikan:

• Cursor — Tambahkan Unbox di bawah pelayan MCP dalam tetapan Cursor, kemudian log masuk melalui aliran penyemak imbas.
• Workbuddy — Konfigurasikan URL pelayan MCP jauh yang menghala ke Unbox, kemudian sahkan dengan akaun anda.
• OpenClaw — Sambungkan OpenClaw ke titik akhir HTTP MCP Unbox dan selesaikan log masuk penyemak imbas.

Keselamatan

• Log Masuk Pelayar — Anda log masuk melalui Unbox dalam pelayar anda — ejen tidak akan melihat kata laluan anda.
• Pemilik Akaun Sahaja — Akses MCP terhad kepada pemilik akaun peribadi, bukan ahli pasukan atau ruang kerja dikongsi.
• Had yang Sama Seperti Aplikasi Web — Kuota hantar, peraturan spam, dan dasar transaksional dikenakan pada tindakan ejen dengan cara yang sama seperti dalam UI peti masuk.
• Tiada Padam Pukal — Ejen tidak boleh mengosongkan spam, mengosongkan tong sampah, atau memutar kunci API melalui MCP dalam v1.