Sendmux Email MCP

resmi

Sendmux adalah API kotak masuk email dan API email untuk agen AI.

Apa yang bisa Anda lakukan dengan Sendmux Email MCP?

  • Cari dokumentasi Sendmux — Minta asisten AI Anda untuk mencari panduan Sendmux dan referensi API melalui search_sendmux.
  • Kelola kotak surat — Minta asisten AI Anda untuk mencari, membaca, mengatur, dan mengirim email dari kotak surat yang diberikan menggunakan permukaan Mailbox.
  • Awasi sumber daya tim — Arahkan asisten AI Anda untuk mengelola domain, kotak surat, akun pengiriman, log, metrik, penagihan, dan webhook melalui permukaan Management.
  • Kirim email — Instruksikan asisten AI Anda untuk mengirim email tunggal atau massal menggunakan alat permukaan Sending.

Dokumentasi

MCP

Hubungkan alat AI ke dokumentasi dan alat produk Sendmux.

Sendmux memiliki dua koneksi MCP. Gunakan Doc Search MCP ketika Anda ingin alat AI mencari dokumentasi Sendmux. Gunakan MCP ketika Anda ingin agen bekerja dengan alat Sendmux yang Anda otorisasi.

KoneksiGunakan untukServer
Doc Search MCPMencari panduan dan referensi API Sendmux.https://sendmux.ai/docs/mcp
MCPMenggunakan alat Management, Mailbox, dan Sending.https://mcp.sendmux.ai/mcp atau paket lokal sendmux-mcp

Info

MCP mengekspos kumpulan alat agen yang dikurasi, bukan setiap endpoint API. Gunakan SDK, CLI, atau referensi API ketika Anda membutuhkan cakupan endpoint penuh.

Doc Search MCP

Doc Search MCP mengekspos search_sendmux.

```bash theme={null} claude mcp add sendmux-docs --transport http https://sendmux.ai/docs/mcp ``` Tambahkan server ini ke `.cursor/mcp.json` untuk satu proyek atau `~/.cursor/mcp.json` untuk semua proyek.
```json theme={null}
{
  "mcpServers": {
    "sendmux-docs": {
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}
```
Tambahkan server ini ke `mcp.json` pengguna atau workspace Anda.
```json theme={null}
{
  "servers": {
    "sendmux-docs": {
      "type": "http",
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}
```
Tambahkan server ini ke `~/.codex/config.toml` atau proyek tepercaya `.codex/config.toml`.
```toml theme={null}
[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"
```

MCP

MCP mengekspos permukaan produk yang Anda berikan.

PermukaanGunakan untukAkses
MailboxMencari, membaca, mengatur, dan mengirim dari kotak surat yang diberikan.Hibah terhosting dengan akses Mailbox, kunci smx_mbx_, atau token smx_agent_ terlingkup secara lokal
ManagementMengelola sumber daya tim seperti domain, kotak surat, akun pengiriman, log, metrik, penagihan, dan webhook.Hibah terhosting dengan akses Management, atau kunci smx_root_ secara lokal
SendingMengirim email tunggal atau massal.Hibah terhosting dengan akses Sending, kunci smx_mbx_, atau token smx_agent_ sumber daya Sending yang disetujui pemilik secara lokal

MCP terhosting adalah default ketika klien Anda mendukung MCP jarak jauh dengan OAuth browser. Ini menjaga Sendmux dalam alur otorisasi, menghindari distribusi kunci API manual ke agen, dan hanya menampilkan alat yang diizinkan oleh hibah.

Info

Identitas paket: sendmux-mcp

Versi paket: 2.1.2

Sumber daya terhosting: https://mcp.sendmux.ai/mcp

Transport terhosting: Streamable HTTP

Jumlah alat terkurasi: 54

Versi protokol tersertifikasi: 2025-11-25, 2026-07-28

Versi protokol yang diterima runtime: 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25, 2026-07-28. Penerimaan runtime menyediakan kompatibilitas; ini tidak mensertifikasi setiap versi.

PengaturanNilai
URL Serverhttps://mcp.sendmux.ai/mcp
Server otorisasihttps://app.sendmux.ai
Pemeriksaan kesehatanhttps://mcp.sendmux.ai/health

Gunakan koleksi Postman ketika Anda ingin menguji permintaan MCP dari Postman:

Run in Postman

Ketika Anda terhubung, Sendmux meminta Anda untuk memilih tim, permukaan produk, dan akses kotak surat yang relevan. Token akses berumur pendek. Token penyegaran berputar saat digunakan dan dapat bertahan hingga 30 hari kecuali koneksi diputus atau kedaluwarsa.

Catatan

Jika Anda memberikan lebih dari satu kotak surat, mulailah alur kerja kotak surat dengan mailbox_list_granted_mailboxes dan teruskan mailbox_id yang dikembalikan ke alat yang bertindak pada satu kotak surat.

Mode koneksi

Gunakan ketika klien Anda dapat membuka alur OAuth MCP berbasis browser. Gunakan ketika agen pengkodean Anda dapat meluncurkan perintah lokal di mesin Anda. Gunakan ketika klien membutuhkan URL tetapi Anda menjalankan paket MCP sendiri.

Paket lokal

Instal paket lokal dari PyPI:

pip install sendmux-mcp

Jalankan satu permukaan:

SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending

Jalankan semua permukaan produk:

SENDMUX_MCP_SURFACES=mailbox,management,sending \
SENDMUX_MAILBOX_API_KEY=smx_mbx_... \
SENDMUX_MANAGEMENT_API_KEY=smx_root_... \
SENDMUX_SENDING_API_KEY=smx_mbx_... \
sendmux-mcp

Server memvalidasi prefiks kunci sebelum memulai. Management membutuhkan smx_root_. Sending menerima kunci smx_mbx_ yang mampu mengirim atau token smx_agent_ sumber daya Sending yang disetujui pemilik. Mailbox menerima kunci smx_mbx_ atau token smx_agent_ terlingkup.

HTTP Pribadi

Mode HTTP berguna ketika klien MCP Anda terhubung ke URL server tetapi Anda masih ingin menjalankan paket sendiri.

SENDMUX_API_KEY=smx_mbx_... \
SENDMUX_MCP_HTTP_BEARER_TOKEN=local-mcp-token \
sendmux-mcp-mailbox --transport http --host 127.0.0.1 --port 8765

Endpoint default ke /mcp. /health mengembalikan permukaan yang dipilih. Mode HTTP membutuhkan SENDMUX_MCP_HTTP_BEARER_TOKEN kecuali Anda secara eksplisit memulainya dengan --allow-unauthenticated-http.

Referensi konfigurasi

| Pengaturan | Lingkungan | Default | | - | - | - | | Permukaan alat | `SENDMUX_MCP_SURFACES` | Diperlukan untuk `sendmux-mcp` | | Cadangan kunci API | `SENDMUX_API_KEY` | Tidak ada | | Kunci API Mailbox | `SENDMUX_MAILBOX_API_KEY` | Tidak ada | | Kunci API Management | `SENDMUX_MANAGEMENT_API_KEY` | Tidak ada | | Kunci API Sending | `SENDMUX_SENDING_API_KEY` | Tidak ada | | URL dasar API Management dan Mailbox | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | URL dasar API Sending | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | Anggaran waktu percobaan ulang, dalam detik | `SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS` | Tidak diatur | | Transport | `SENDMUX_MCP_TRANSPORT` | `stdio` | | Host HTTP | `SENDMUX_MCP_HOST` | `127.0.0.1` | | Port HTTP | `SENDMUX_MCP_PORT` | `8765` | | Jalur HTTP | `SENDMUX_MCP_PATH` | `/mcp` | | Token pembawa HTTP | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | Diperlukan untuk HTTP | | Asal browser yang diizinkan | `SENDMUX_MCP_ALLOWED_ORIGINS` | Tidak ada asal browser | ```bash theme={null} SENDMUX_MCP_SURFACES=mailbox,management,sending \ SENDMUX_MAILBOX_API_KEY="$SENDMUX_MAILBOX_KEY" \ SENDMUX_MANAGEMENT_API_KEY="$SENDMUX_ROOT_KEY" \ SENDMUX_SENDING_API_KEY="$SENDMUX_SENDING_KEY" \ sendmux-mcp ```

Penemuan alat

Nama alat dihasilkan dari permukaan API publik saat ini. Buka pemilih alat klien MCP Anda setelah otorisasi untuk melihat alat yang tersedia untuk koneksi tersebut.

Koneksi terhosting hanya menampilkan alat yang diizinkan oleh permukaan produk, izin, dan hibah kotak surat yang dipilih. Server lokal menampilkan alat untuk permukaan dan kunci yang Anda berikan saat startup.

Pemecahan masalah

Konfirmasi permukaan produk yang dipilih dan izin yang diberikan. Koneksi terhosting hanya menampilkan alat yang diizinkan oleh hibah. Periksa prefiks kunci API. Management membutuhkan `smx_root_`; Sending menerima `smx_mbx_` atau `smx_agent_` sumber daya Sending yang disetujui pemilik; Mailbox menerima `smx_mbx_` atau `smx_agent_` terlingkup. Kirim `Authorization: Bearer ` ke HTTP pribadi, atau selesaikan OAuth untuk MCP terhosting. Tambahkan asal klien browser ke `SENDMUX_MCP_ALLOWED_ORIGINS` untuk HTTP pribadi. Hubungkan hanya permukaan yang Anda butuhkan, atau nonaktifkan alat yang tidak digunakan di klien.

Langkah berikutnya

Gunakan Sendmux melalui endpoint agen A2A 1.0 dengan OAuth terhosting. Konfigurasikan Sendmux MCP di Claude Code, Cursor, Codex, Gemini CLI, Qwen Code, Zed, dan lainnya. Gunakan klien yang dikelola paket dari kode aplikasi. Instal CLI dengan Snap, Homebrew, atau npm ketika Anda membutuhkan akses terminal. Buat kredensial terlingkup untuk pengaturan MCP lokal.