Sendmux Email MCP Server
resmiSendmux adalah API kotak masuk email dan API email untuk agen AI.
Dokumentasi
MCP
Hubungkan alat AI ke dokumentasi Sendmux dan alat produk.
Sendmux memiliki dua koneksi MCP. Gunakan Doc Search MCP saat Anda ingin alat AI mencari dokumen Sendmux. Gunakan MCP saat Anda ingin agen bekerja dengan alat Sendmux yang Anda otorisasi.
| Koneksi | Digunakan untuk | Server |
|---|---|---|
| Doc Search MCP | Mencari panduan dan referensi API Sendmux. | https://sendmux.ai/docs/mcp |
| MCP | Menggunakan alat Manajemen, Kotak Surat, dan Pengiriman. | https://mcp.sendmux.ai/mcp atau paket lokal sendmux-mcp |
Doc Search MCP
Doc Search MCP mengekspos search_sendmux.
```json theme={null}
{
"mcpServers": {
"sendmux-docs": {
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```json theme={null}
{
"servers": {
"sendmux-docs": {
"type": "http",
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```toml theme={null}
[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"
```
MCP
MCP mengekspos permukaan produk yang Anda berikan.
| Permukaan | Digunakan untuk | Akses |
|---|---|---|
| Kotak Surat | Mencari, membaca, mengatur, dan mengirim dari kotak surat yang diberikan. | Pemberian terhosting dengan akses Kotak Surat, kunci smx_mbx_, atau token smx_agent_ terlingkup secara lokal |
| Manajemen | Mengelola sumber daya tim seperti domain, kotak surat, akun pengiriman, log, metrik, penagihan, dan webhook. | Pemberian terhosting dengan akses Manajemen, atau kunci smx_root_ secara lokal |
| Pengiriman | Mengirim email tunggal atau massal. | Pemberian terhosting dengan akses Pengiriman, kunci smx_mbx_, atau token smx_agent_ sumber daya Pengiriman 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 pemberian.
| Pengaturan | Nilai |
|---|---|
| URL Server | https://mcp.sendmux.ai/mcp |
| Server otorisasi | https://app.sendmux.ai |
| Pemeriksaan kesehatan | https://mcp.sendmux.ai/health |
Gunakan koleksi Postman saat Anda ingin menguji permintaan MCP dari Postman:
Saat Anda terhubung, Sendmux meminta Anda untuk memilih tim, permukaan produk, dan akses kotak surat jika relevan. Token akses berumur pendek. Token refresh berputar saat digunakan dan dapat bertahan hingga 30 hari kecuali koneksi diputus atau kedaluwarsa.
Jika Anda memberikan lebih dari satu kotak surat, mulai 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 saat klien Anda dapat membuka alur OAuth MCP berbasis browser. Gunakan saat agen pengkodean Anda dapat meluncurkan perintah lokal di mesin Anda. Gunakan saat 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. Manajemen memerlukan smx_root_. Pengiriman menerima kunci smx_mbx_ yang mampu mengirim atau token smx_agent_ sumber daya Pengiriman yang disetujui pemilik. Kotak Surat 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 memerlukan 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` | | Fallback kunci API | `SENDMUX_API_KEY` | Tidak ada | | Kunci API Kotak Surat | `SENDMUX_MAILBOX_API_KEY` | Tidak ada | | Kunci API Manajemen | `SENDMUX_MANAGEMENT_API_KEY` | Tidak ada | | Kunci API Pengiriman | `SENDMUX_SENDING_API_KEY` | Tidak ada | | URL basis API Manajemen dan Kotak Surat | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | URL basis API Pengiriman | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | Transport | `SENDMUX_MCP_TRANSPORT` | `stdio` | | Host HTTP | `SENDMUX_MCP_HOST` | `127.0.0.1` | | Port HTTP | `SENDMUX_MCP_PORT` | `8765` | | Path HTTP | `SENDMUX_MCP_PATH` | `/mcp` | | Token bearer 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 \ --mailbox-api-key smx_mbx_... \ --management-api-key smx_root_... \ --sending-api-key smx_mbx_... ```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 pemberian kotak surat yang dipilih. Server lokal menampilkan alat untuk permukaan dan kunci yang Anda berikan saat startup.