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