Sendmux Email MCP
官方Sendmux 是一個專為 AI 代理設計的電子郵件收件匣 API 和電子郵件 API。
你可以用 Sendmux Email MCP 做什麼？
- 搜尋 Sendmux 文件 — 請您的 AI 助理透過
search_sendmux查閱 Sendmux 指南與 API 參考資料。 - 管理信箱 — 請您的 AI 助理使用 Mailbox 介面，搜尋、閱讀、整理及寄送已授權信箱中的電子郵件。
- 監督團隊資源 — 指示您的 AI 助理透過 Management 介面管理網域、信箱、寄件帳戶、日誌、指標、帳單與 Webhook。
- 寄送電子郵件 — 指示您的 AI 助理使用 Sending 介面的工具，寄送單封或批次電子郵件。
文件
MCP
將 AI 工具連接到 Sendmux 文件和產品工具。
Sendmux 有兩個 MCP 連線。當您希望 AI 工具搜尋 Sendmux 文件時，請使用 Doc Search MCP。當您希望代理程式使用您授權的 Sendmux 工具時，請使用 MCP。
| 連線 | 用途 | 伺服器 |
|---|---|---|
| Doc Search MCP | 搜尋 Sendmux 指南和 API 參考資料。 | https://sendmux.ai/docs/mcp |
| MCP | 使用管理、信箱和寄送工具。 | https://mcp.sendmux.ai/mcp 或本機 sendmux-mcp 套件 |
資訊
MCP 提供精選的代理工具集，而非每個 API 端點。當您需要完整的端點涵蓋範圍時，請使用 SDK、CLI 或 API 參考資料。
Doc Search MCP
Doc Search MCP 提供 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 提供您授予的產品介面。
| 介面 | 用途 | 存取方式 |
|---|---|---|
| 信箱 | 搜尋、讀取、整理以及從已授予的信箱寄送。 | 具信箱存取權的託管授權、smx_mbx_ 金鑰，或本機的限定範圍 smx_agent_ 權杖 |
| 管理 | 管理團隊資源，例如網域、信箱、寄送帳戶、日誌、指標、帳單和 Webhook。 | 具管理存取權的託管授權，或本機的 smx_root_ 金鑰 |
| 寄送 | 寄送單封或批次電子郵件。 | 具寄送存取權的託管授權、smx_mbx_ 金鑰，或本機經擁有者核准的寄送資源 smx_agent_ 權杖 |
當您的用戶端支援具瀏覽器 OAuth 的遠端 MCP 時，託管 MCP 是預設選項。它讓 Sendmux 保持在授權流程中，避免將手動 API 金鑰分發給代理程式，並僅顯示授權允許的工具。
資訊
套件身分：
sendmux-mcp套件版本：
2.1.2託管資源：
https://mcp.sendmux.ai/mcp託管傳輸：Streamable HTTP
精選工具數量：54
認證協定版本：
2025-11-25、2026-07-28執行階段接受的協定版本：
2024-11-05、2025-03-26、2025-06-18、2025-11-25、2026-07-28。執行階段接受提供相容性；它不認證每個版本。
| 設定 | 值 |
|---|---|
| 伺服器 URL | https://mcp.sendmux.ai/mcp |
| 授權伺服器 | https://app.sendmux.ai |
| 健康檢查 | https://mcp.sendmux.ai/health |
當您想從 Postman 測試 MCP 請求時，請使用 Postman 集合：
當您連線時，Sendmux 會要求您選擇團隊、產品介面和相關的信箱存取權。存取權杖為短期有效。重新整理權杖在使用時輪換，最長可持續 30 天，除非連線中斷或過期。
注意
如果您授予多個信箱，請以
mailbox_list_granted_mailboxes開始信箱工作流程，並將傳回的mailbox_id傳遞給作用於單一信箱的工具。
連線模式
當您的用戶端可以開啟瀏覽器型 MCP OAuth 流程時使用。 當您的編碼代理可以在您的機器上啟動本機指令時使用。 當用戶端需要 URL 但您自行執行 MCP 套件時使用。本機套件
從 PyPI 安裝本機套件：
pip install sendmux-mcp
執行單一介面：
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending
執行所有產品介面：
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
伺服器會在啟動前驗證金鑰前綴。管理需要 smx_root_。寄送接受具寄送能力的 smx_mbx_ 金鑰或經擁有者核准的寄送資源 smx_agent_ 權杖。信箱接受 smx_mbx_ 金鑰或限定範圍的 smx_agent_ 權杖。
私人 HTTP
當您的 MCP 用戶端連線到伺服器 URL 但您仍想自行執行套件時，HTTP 模式很有用。
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
端點預設為 /mcp。/health 傳回選取的介面。HTTP 模式需要 SENDMUX_MCP_HTTP_BEARER_TOKEN，除非您以 --allow-unauthenticated-http 明確啟動它。
設定參考
| 設定 | 環境 | 預設值 | | - | - | - | | 工具介面 | `SENDMUX_MCP_SURFACES` | `sendmux-mcp` 必填 | | API 金鑰備援 | `SENDMUX_API_KEY` | 無 | | 信箱 API 金鑰 | `SENDMUX_MAILBOX_API_KEY` | 無 | | 管理 API 金鑰 | `SENDMUX_MANAGEMENT_API_KEY` | 無 | | 寄送 API 金鑰 | `SENDMUX_SENDING_API_KEY` | 無 | | 管理和信箱 API 基礎 URL | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | 寄送 API 基礎 URL | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | 重試時間預算（秒） | `SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS` | 未設定 | | 傳輸 | `SENDMUX_MCP_TRANSPORT` | `stdio` | | HTTP 主機 | `SENDMUX_MCP_HOST` | `127.0.0.1` | | HTTP 連接埠 | `SENDMUX_MCP_PORT` | `8765` | | HTTP 路徑 | `SENDMUX_MCP_PATH` | `/mcp` | | HTTP Bearer 權杖 | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | HTTP 必填 | | 允許的瀏覽器來源 | `SENDMUX_MCP_ALLOWED_ORIGINS` | 無瀏覽器來源 | ```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 ```工具探索
工具名稱從目前公開 API 介面產生。授權後開啟您的 MCP 用戶端工具選擇器，以查看該連線可用的工具。託管連線僅顯示所選產品介面、權限和信箱授權允許的工具。本機伺服器顯示您在啟動時提供的介面和金鑰對應的工具。