Sendmux Email MCP

官方

Sendmux 是一個專為 AI 代理設計的電子郵件收件匣 API 和電子郵件 API。

造訪 sendmux.ai

你可以用 Sendmux Email MCP 做什麼？

  • 搜尋 Sendmux 文件 — 請 AI 助理透過 search_sendmux 查找 Sendmux 指南和 API 參考資料。
  • 使用已授權的信箱 — 搜尋、閱讀、整理並從您授權的信箱寄送郵件；若授權了多個信箱，請先使用 mailbox_list_granted_mailboxes。
  • 管理團隊資源 — 使用 Management 存取權管理網域、信箱、寄送帳戶、記錄、指標、帳單和 Webhook。
  • 寄送單封或批次郵件 — 使用具備寄送權限的金鑰或已核准的代理程式權杖，透過 Sending 介面寄送單封郵件或批次郵件。
  • 選擇託管或本機設定 — 透過託管 OAuth 連線至 https://mcp.sendmux.ai/mcp，或使用各介面專用金鑰執行本機 sendmux-mcp 套件。

文件

MCP

將 AI 工具連接至 Sendmux 文件與產品工具。

Sendmux 有兩種 MCP 連線。若要讓 AI 工具搜尋 Sendmux 文件，請使用 Doc Search MCP。若要讓代理程式使用您授權的 Sendmux 工具，請使用 MCP。

連線用途伺服器
Doc Search MCP搜尋 Sendmux 指南與 API 參考資料。https://sendmux.ai/docs/mcp
MCP使用 Management、Mailbox 和 Sending 工具。https://mcp.sendmux.ai/mcp 或本機的 sendmux-mcp 套件

[!NOTE]

MCP 提供的是精選的代理程式工具集，而非所有 API 端點。若需要完整的端點涵蓋範圍，請使用 SDK、CLI 或 API 參考資料。

Doc Search MCP

Doc Search MCP 提供 search_sendmux。

[accordion] Claude Code

claude mcp add sendmux-docs --transport http https://sendmux.ai/docs/mcp

[accordion] Cursor

將此伺服器新增至 .cursor/mcp.json，供單一專案使用；或新增至 ~/.cursor/mcp.json，供所有專案使用。

{
  "mcpServers": {
    "sendmux-docs": {
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}

[accordion] VS Code

將此伺服器新增至您的使用者或工作區 mcp.json。

{
  "servers": {
    "sendmux-docs": {
      "type": "http",
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}

[accordion] Codex

將此伺服器新增至 ~/.codex/config.toml 或受信任的專案 .codex/config.toml。

[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"

MCP

MCP 提供您授權的產品功能。

功能用途存取方式
Mailbox搜尋、讀取、整理授權的信箱，並從中寄送郵件。透過 Hosted grant 授予 Mailbox 存取權、本機使用 smx_mbx_ 金鑰，或使用範圍受限的 smx_agent_ 權杖
Management管理團隊資源，例如網域、信箱、寄送帳戶、記錄、指標、帳單和 Webhook。透過 Hosted grant 授予 Management 存取權，或本機使用 smx_root_ 金鑰
Sending寄送單封或批次電子郵件。透過 Hosted grant 授予 Sending 存取權、本機使用 smx_mbx_ 金鑰，或使用擁有者核准的 Sending 資源 smx_agent_ 權杖

當您的用戶端支援透過瀏覽器 OAuth 使用遠端 MCP 時，Hosted MCP 是預設選項。它會讓 Sendmux 保持在授權流程中，避免將手動 API 金鑰散發給代理程式，並且只顯示授權所允許的工具。

[!NOTE]

PyPI 套件：sendmux-mcp

PyPI 版本：2.1.3

npm 套件：sendmux-mcp

npm 版本：1.0.0

Registry 中繼資料版本：2.1.4

Hosted 資源：https://mcp.sendmux.ai/mcp

Hosted 傳輸方式：Streamable HTTP

精選工具數量：54

認證的通訊協定版本：2025-11-25、2026-07-28

執行階段接受的通訊協定版本：2024-11-05、2025-03-26、2025-06-18、2025-11-25、2026-07-28。執行階段接受這些版本代表具備相容性；不代表每個版本都已通過認證。

設定值
伺服器 URLhttps://mcp.sendmux.ai/mcp
授權伺服器https://app.sendmux.ai
健康檢查https://mcp.sendmux.ai/health

若要使用 Postman 測試 MCP 請求，請使用 Postman 集合：

Run in Postman

連線時，Sendmux 會要求您選擇團隊、產品功能，以及適用時的信箱存取權。存取權杖的有效期限很短。重新整理權杖會在每次使用時輪替，最長可使用 30 天，除非連線中斷或到期。

[!NOTE]

若您授權多個信箱，請使用 mailbox_list_granted_mailboxes 啟動信箱工作流程，並將傳回的 mailbox_id 傳給 針對單一信箱執行操作的工具。

連線模式

[card] Hosted OAuth

適用於可開啟瀏覽器式 MCP OAuth 流程的用戶端。

[card] Local stdio

適用於可在您的電腦上啟動本機命令的程式碼代理程式。

[card] Private HTTP

適用於需要 URL、但由您自行執行 MCP 套件的用戶端。

npm bridge

需要 Node.js 22 或更新版本。執行 npm bridge：

npx -y sendmux-mcp

此 bridge 會透過瀏覽器 OAuth，將 stdio 用戶端連接至 Hosted 伺服器。工具會依照您的 Hosted grant 提供。

{
  "mcpServers": {
    "sendmux": {
      "command": "npx",
      "args": ["-y", "sendmux-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

伺服器會在啟動前驗證金鑰前綴。Management 需要 smx_root_。Sending 接受具備寄送權限的 smx_mbx_ 金鑰，或擁有者核准的 Sending 資源 smx_agent_ 權杖。Mailbox 接受 smx_mbx_ 金鑰或範圍受限的 smx_agent_ 權杖。

Private 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 會傳回所選的功能。除非您明確使用 --allow-unauthenticated-http 啟動，否則 HTTP 模式需要 SENDMUX_MCP_HTTP_BEARER_TOKEN。

設定參考

[accordion] 環境變數

設定環境變數預設值
工具功能SENDMUX_MCP_SURFACESsendmux-mcp 必填
API 金鑰備援SENDMUX_API_KEY無
Mailbox API 金鑰SENDMUX_MAILBOX_API_KEY無
Management API 金鑰SENDMUX_MANAGEMENT_API_KEY無
Sending API 金鑰SENDMUX_SENDING_API_KEY無
Management 和 Mailbox API 基底 URLSENDMUX_APP_BASE_URLhttps://app.sendmux.ai/api/v1
Sending API 基底 URLSENDMUX_SENDING_BASE_URLhttps://smtp.sendmux.ai/api/v1
重試時間上限（秒）SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS未設定
傳輸方式SENDMUX_MCP_TRANSPORTstdio
HTTP 主機SENDMUX_MCP_HOST127.0.0.1
HTTP 連接埠SENDMUX_MCP_PORT8765
HTTP 路徑SENDMUX_MCP_PATH/mcp
HTTP bearer 權杖SENDMUX_MCP_HTTP_BEARER_TOKENHTTP 必填
允許的瀏覽器來源SENDMUX_MCP_ALLOWED_ORIGINS無瀏覽器來源

[accordion] 受保護的環境輸入

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

工具探索

[accordion] 工具探索的運作方式

工具名稱會根據目前公開的 API 功能產生。完成授權後，請開啟 MCP 用戶端的工具選擇器，查看該連線可用的工具。

Hosted 連線只會顯示所選產品功能、權限和信箱授權所允許的工具。本機伺服器則會顯示您在啟動時提供的功能和金鑰所對應的工具。

疑難排解

[accordion] 沒有顯示任何工具

請確認所選的產品功能和授予的權限。Hosted 連線只會顯示授權所允許的工具。

[accordion] 本機伺服器在啟動前失敗

請檢查 API 金鑰前綴。Management 需要 smx_root_；Sending 接受 smx_mbx_ 或擁有者核准的 Sending 資源 smx_agent_；Mailbox 接受 smx_mbx_ 或範圍受限的 smx_agent_。

[accordion] HTTP 伺服器傳回 401

將 Authorization: Bearer <SENDMUX_MCP_HTTP_BEARER_TOKEN> 傳送至 Private HTTP，或完成 Hosted MCP 的 OAuth 流程。

[accordion] HTTP 伺服器傳回 403 origin_forbidden

將瀏覽器用戶端的來源新增至 Private HTTP 的 SENDMUX_MCP_ALLOWED_ORIGINS。

[accordion] 單一用戶端中的工具過多

只連接您需要的功能，或在用戶端中停用未使用的工具。

後續步驟

[card] A2A

透過使用 Hosted OAuth 的 A2A 1.0 代理程式端點使用 Sendmux。

[card] MCP clients

在 Claude Code、Cursor、Codex、Gemini CLI、Qwen Code、Zed 等工具中設定 Sendmux MCP。

[card] SDKs

在應用程式程式碼中使用由套件管理的用戶端。

[card] CLI

若需要終端機存取，請使用 Snap、Homebrew 或 npm 安裝 CLI。

[card] API keys

為本機 MCP 設定建立範圍受限的憑證。

此文件使用開發者文件平台 Mintlify 建置並託管。