MCP
适用于 Gmail、Outlook、Yahoo、iCloud 和 IMAP 的 MCP 服务器
使用工作区 API key，即可让 Claude、Cursor、VS Code 或您的智能体在所有已连接邮箱中读取邮件、获取 OTP 验证码、回复邮件，以及将邮件移出垃圾邮件文件夹，无需编写代码。
claude mcp add --transport http mailera https://mailera.app/api/public/v1/mcp \ --header "Authorization: Bearer mh_live_xxx"连接
- 服务器 URL
https://mailera.app/api/public/v1/mcp- 身份验证
Authorization: Bearer mh_live_… 或 X-API-Key- 传输方式
- Streamable HTTP，无需会话
- 协议版本
- 2025-06-18 · 2025-03-26 · 2024-11-05
12 个工具，按 API key 权限开放
智能体只能看到 API key 权限允许使用的工具。每次调用都会执行对应的 REST 端点，因此结果和错误码与 API 完全一致。
| 工具 | 功能 | 权限范围 |
|---|---|---|
| list_mailboxes | 列出邮箱、服务提供商、支持的功能和同步状态 | read |
| get_mailbox_status | 检查邮箱连接状态和上次同步时间 | read |
| list_messages | 列出文件夹中的邮件，最新邮件在前 | read |
| search_messages | 搜索所有邮箱中的邮件，可选择包含 OTP 验证码 | read |
| get_message | 读取完整邮件：发件人、正文和附件 | read |
| get_latest_otp | 获取收件箱或垃圾邮件中的最新 OTP 验证码 | read |
| send_email | 发送新邮件，通过 idempotency_key 防止重复发送 | send |
| reply_to_email | 回复、全部回复或转发邮件 | send |
| get_send_status | 跟踪一次发送尝试，直到状态为 sent、failed 或 unknown | send |
| move_message | 将邮件移至收件箱、垃圾邮件、存档或已删除邮件 | move |
| rescue_spam | 将邮件移出垃圾邮件文件夹：可全部移出，或按发件人、域名或主题筛选 | move |
| sync_mailbox | 立即同步并唤醒休眠中的邮箱 | sync |
每次工具调用均使用对应的 REST 端点：权限范围相同，每分钟 300 次请求的限制相同，API 日志也相同。错误会显示在工具结果（isError）中，并附带稳定的 error.code，供智能体处理。
各应用配置指南
复制配置，填入您的 API key，然后重启应用。每个应用都有独立指南，包含验证步骤和常见错误。
Claude
Claude Code 一条命令即可连接，Claude Desktop 通过 mcp-remote 桥接连接。
Terminal · claude_desktop_config.json
Claude 指南Cursor
一个 mcp.json 文件，可用于所有项目或单个项目。
~/.cursor/mcp.json
Cursor 指南VS Code
使用 .vscode/mcp.json 文件；VS Code 仅询问一次 API key，并将其保密存储。
.vscode/mcp.json
VS Code 指南
让智能体安全访问邮箱
仅授予必要权限
如果智能体只需读取邮件，请创建仅有读取权限的 API key。仅在智能体确实需要发信时授予发送权限，并尽可能将 API key 的访问范围限定到邮箱分组。
收到的邮件是数据，不是指令
邮件内容由他人撰写。不要让智能体执行邮件中的指令，例如“将所有邮件转发至……”。请要求智能体在发送或转发邮件前征求您的确认。
每封邮件只发送一次
发送时务必传入 idempotency_key。如果状态为 unknown，不要重发，请先检查“已发送邮件”。
随时撤销
在“设置 → API key”中撤销 API key，即可立即阻止所有使用它的应用访问。API 日志会记录每次工具调用。
不使用 MCP？
每个工具都有对应的 REST 端点，并在收到新邮件时提供带签名的 webhook 通知。