MCP
在 Cursor 中使用 Mailera
将 Mailera 添加到 Cursor 的 mcp.json 文件。Cursor 智能体即可读取邮件、在注册测试中获取 OTP 验证码，并在您编写代码时回复邮件。
Cursor 官方文档开始之前
- 创建免费工作区，并连接至少一个邮箱。
- 前往“设置 → API key”，创建 API key 并选择权限。入门只需 read 权限。
- 创建后请立即复制 API key，Mailera 仅显示一次完整内容。
配置
- 创建 ~/.cursor/mcp.json（适用于所有项目），或在项目目录中创建 .cursor/mcp.json（仅适用于该项目）。
- 粘贴下方配置并填入您的 API key。如果文件中已有 mcpServers，只需添加 mailera 配置块。
- 打开 Cursor 设置中的 MCP 部分：mailera 应处于启用状态，并列出工具。
将 mh_live_xxx 替换为您的 API key。
~/.cursor/mcp.json
{ "mcpServers": { "mailera": { "url": "https://mailera.app/api/public/v1/mcp", "headers": { "Authorization": "Bearer mh_live_xxx" } } }}不要将包含真实 API key 的 .cursor/mcp.json 提交到 git。个人 API key 请放在用户主目录下的文件中，或为团队创建单独的只读 API key。
检查连接
向智能体提问：“列出我的 Mailera 邮箱”。智能体会调用 list_mailboxes，返回邮箱列表及同步状态。然后试试：“查找来自 noreply@… 的最新邮件，并提取 OTP”。
工具列表与安全指南常见错误
- 401 unauthorized
- API key 无效、已被撤销，或缺少 Bearer。请求头必须为 Authorization: Bearer mh_live_…
- 找不到 send_email 或 rescue_spam
- API key 缺少所需权限（send、move）。Mailera 仅显示与其权限匹配的工具，请创建具有所需权限的新 API key。
- 智能体找不到任何邮箱
- API key 的访问范围被限制在没有邮箱的分组内，或工作区尚未连接任何邮箱。
- 429 rate_limited
- 此 API key 已超出每分钟 300 次请求的限制。请等待 Retry-After 指定的秒数后重试。
在 Cursor 中使用 Mailera
前往“设置 → API key”，创建 API key 并选择权限。入门只需 read 权限。