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 承载令牌 | `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 客户端的工具选择器，查看该连接可用的工具。托管连接仅显示所选产品界面、权限和邮箱授权允许的工具。本地服务器显示您在启动时提供的界面和密钥对应的工具。