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搜索、读取、整理授权邮箱中的邮件并发送邮件。授予 Mailbox 访问权限的托管授权、smx_mbx_ 密钥，或本地使用受限的 smx_agent_ 令牌
Management管理团队资源，例如域名、邮箱、发送账户、日志、指标、账单和 Webhook。授予 Management 访问权限的托管授权，或本地使用 smx_root_ 密钥
Sending发送单封或批量邮件。授予 Sending 访问权限的托管授权、smx_mbx_ 密钥，或本地使用经所有者批准的 Sending 资源 smx_agent_ 令牌

当客户端支持通过浏览器 OAuth 使用远程 MCP 时，托管 MCP 是默认选项。它会让 Sendmux 保持在授权流程中，避免向代理分发手动 API 密钥，并且只显示授权允许使用的工具。

[!NOTE]

PyPI 包：sendmux-mcp

PyPI 版本：2.1.3

npm 包：sendmux-mcp

npm 版本：1.0.0

注册表元数据版本：2.1.4

托管资源：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。运行时接受某个版本表示兼容该版本，并不代表该版本已通过认证。

设置值
服务器 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] 托管 OAuth

适用于能够打开基于浏览器的 MCP OAuth 流程的客户端。

[card] 本地 stdio

适用于能够在你的计算机上启动本地命令的编程代理。

[card] 私有 HTTP

适用于需要 URL、但由你自行运行 MCP 包的客户端。

npm bridge

需要 Node.js 22 或更高版本。运行 npm bridge：

npx -y sendmux-mcp

bridge 通过浏览器 OAuth 将 stdio 客户端连接到托管服务器。工具遵循你的托管授权。

{
  "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_ 令牌。

私有 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 客户端的工具选择器，即可查看该连接可用的工具。

托管连接只显示所选产品功能、权限和邮箱授权允许使用的工具。本地服务器则显示你在启动时提供的功能和密钥对应的工具。

故障排除

[accordion] 未显示任何工具

确认所选的产品功能和授予的权限。托管连接只显示授权允许使用的工具。

[accordion] 本地服务器启动前失败

检查 API 密钥前缀。Management 需要 smx_root_；Sending 接受 smx_mbx_ 或经所有者批准的 Sending 资源 smx_agent_；Mailbox 接受 smx_mbx_ 或受限的 smx_agent_。

[accordion] HTTP 服务器返回 401

向私有 HTTP 发送 Authorization: Bearer <SENDMUX_MCP_HTTP_BEARER_TOKEN>，或完成托管 MCP 的 OAuth 流程。

[accordion] HTTP 服务器返回 403 origin_forbidden

将浏览器客户端的来源添加到私有 HTTP 的 SENDMUX_MCP_ALLOWED_ORIGINS。

[accordion] 单个客户端中的工具过多

只连接所需的功能，或在客户端中禁用未使用的工具。

后续步骤

[card] A2A

通过使用托管 OAuth 的 A2A 1.0 代理端点使用 Sendmux。

[card] MCP 客户端

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

[card] SDK

在应用程序代码中使用由包管理器管理的客户端。

[card] CLI

需要通过终端访问时，可使用 Snap、Homebrew 或 npm 安装 CLI。

[card] API 密钥

为本地 MCP 配置创建受限凭据。

本文档使用 Mintlify 构建和托管。Mintlify 是一个开发者文档平台。