Sendmux Email MCP Server
官方Sendmux 是一個專為 AI 代理設計的電子郵件收件匣 API 和電子郵件 API。
文件
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 套件 |
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 金鑰分發給代理程式，並僅顯示授權所允許的工具。
| 設定 | 值 |
|---|---|
| 伺服器 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_TRANSPORT` | `stdio` | | HTTP 主機 | `SENDMUX_MCP_HOST` | `127.0.0.1` | | HTTP 連接埠 | `SENDMUX_MCP_PORT` | `8765` | | HTTP 路徑 | `SENDMUX_MCP_PATH` | `/mcp` | | HTTP 承載權杖 | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | HTTP 為必要 | | 允許的瀏覽器來源 | `SENDMUX_MCP_ALLOWED_ORIGINS` | 無瀏覽器來源 | ```bash theme={null} sendmux-mcp \ --surfaces mailbox,management,sending \ --mailbox-api-key smx_mbx_... \ --management-api-key smx_root_... \ --sending-api-key smx_mbx_... ```工具探索
工具名稱是根據目前的公開 API 介面產生。授權後，請開啟 MCP 客戶端的工具選擇器，以查看該連線可用的工具。託管連線僅顯示所選產品介面、權限與信箱授權所允許的工具。本機伺服器則顯示您在啟動時提供的介面與金鑰所對應的工具。