MCP
在 VS Code 中使用 Mailera
将 Mailera 添加到 .vscode/mcp.json，让 Agent 模式下的 Copilot Chat 访问您的邮箱。VS Code 会在首次使用时询问 API key，并将其作为机密存储，不会写入配置文件。
VS Code 官方文档开始之前
- 创建免费工作区，并连接至少一个邮箱。
- 前往“设置 → API key”，创建 API key 并选择权限。入门只需 read 权限。
- 创建后请立即复制 API key，Mailera 仅显示一次完整内容。
配置
- 在工作区中创建 .vscode/mcp.json，或运行 MCP: Open User Configuration 命令，以在所有工作区中使用。
- 粘贴下方配置。首次运行时，VS Code 会询问您的 Mailera API key，并将其作为机密存储。
- 打开 Agent 模式下的 Chat 并点击工具图标：列表中应出现 mailera 的工具。
.vscode/mcp.json
{ "inputs": [ { "type": "promptString", "id": "mailera-api-key", "description": "Mailera API key", "password": true } ], "servers": { "mailera": { "type": "http", "url": "https://mailera.app/api/public/v1/mcp", "headers": { "Authorization": "Bearer ${input:mailera-api-key}" } } }}文件不含 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 指定的秒数后重试。
在 VS Code 中使用 Mailera
前往“设置 → API key”，创建 API key 并选择权限。入门只需 read 权限。