给 Claude Code 一个专属邮箱
通过 Remote MCP 把 Claude Code 连接到 Mailly 邮箱,让它读信、保存回复草稿,并在你确认确切正文后发送。
Claude Code 可以直接处理一个真实邮箱:搜索会话、读取来信、保存回复草稿,并在你确认最终正文后发送。Mailly 给它一个 your-name@mailly.site 这样的地址(也可以用你自己的域名),通过 Remote MCP 连接,本机不用运行任何服务。
你会得到
- 一个可收可发的
@mailly.site邮箱;Developer 套餐还可以使用自己的域名。 - 约 70 个类型明确的 MCP 工具,覆盖会话、草稿、发信、域名、联系人、模板、Campaign 和 Workflow,并受你授予的授权范围限制。
- 发信由你把关:Claude Code 会展示确切的正文和收件人,你确认后才发送。
- 同一个邮箱也能在 Mailly 工作台、CLI 和 HTTP API 中使用。
开通邮箱
已有 Mailly 账户可跳过这一步。
把下面的提示词粘贴到 Claude Code。它会读取 Mailly 的开通说明,询问你想要的名称,通过 HTTP 预留,再把验证链接交给你。
Read https://mailly.site/auth.md
and set up a Mailly inbox for me over HTTP.
Ask me for the name if unknown; if taken, ask for another,
with no blind retries.
Send me the verification link.
After I confirm the inbox in my browser,
store the API key securely, tell me the address,
and ask me before sending any email.打开链接,用你自己已验证的邮箱登录或注册,然后确认这个邮箱。之后 Claude Code 会拿到邮箱地址和你账户的 API Key。也可以不经 Agent,直接在 mailly.site/onboard 开始。规则见让 Agent 帮你开通邮箱。
添加 Mailly MCP 服务器
claude mcp add --transport http --scope user mailly https://mcp.mailly.site/mcp--scope user 让 Mailly 在你的所有项目中可用。去掉它则只加到当前项目;用 --scope project 会写入 .mcp.json,与团队共享。
登录并选择授权范围
在 Claude Code 中运行 /mcp,选择 mailly 并完成认证。浏览器会打开 Mailly 的登录与授权页面,由你决定 Claude Code 能做什么:
| 授权范围 | Claude Code 可以 |
|---|---|
mail:read | 读取邮箱、会话、已发邮件、草稿和设置。始终授予。 |
mail:draft | 保存、修改、放弃回复草稿;不能发送。 |
mail:send | 发送你审核过的回复、转发和新邮件。 |
workspace:manage | 管理地址、域名、模板、联系人、Campaign、Workflow 和 Webhook。 |
只需要总结和起草时,先授予 mail:read 和 mail:draft;希望 Claude Code 在你确认后发信时,再加上 mail:send。也可以在终端里运行 claude mcp login mailly 登录。
与项目共享
claude mcp add --scope project 会写入下面的 .mcp.json,你也可以手动提交它。每位成员通过 /mcp 用自己的 Mailly 账户登录。
{
"mcpServers": {
"mailly": {
"type": "http",
"url": "https://mcp.mailly.site/mcp"
}
}
}无交互运行
claude -p 和 Agent SDK 运行时无法完成 OAuth。先在交互会话里用 /mcp 或 claude mcp login mailly 登录一次,Claude Code 会保存并自动刷新令牌。CI 中也可以改用请求头发送 Mailly API Key,Claude Code 会展开 .mcp.json 请求头里的 ${VAR}:
{
"mcpServers": {
"mailly": {
"type": "http",
"url": "https://mcp.mailly.site/mcp",
"headers": { "Authorization": "Bearer ${MAILLY_API_KEY}" }
}
}
}API Key 拥有完整的账户权限,不受授权范围限制。请放在环境变量里,不要贴进聊天或提交到仓库。在工作台的接入页查看。
验证连接
- 运行
claude mcp list,mailly应显示✔ Connected。 - 对 Claude Code 说:“用 Mailly 列出我的邮箱地址和最近 5 个会话。” 它应调用
mailly_list_inbox_addresses和mailly_list_threads。 - 用你的个人邮箱给 Mailly 地址发一封邮件,然后说:“读取我在 Mailly 的最新会话并保存一份回复草稿,给我看确切正文,先不要发送。” Claude Code 会调用
mailly_read_thread和mailly_save_draft。在对话中批准或放弃这份草稿。
改用 CLI
Claude Code 也可以在 shell 中使用 mailly-cli。所有命令都支持 --json,便于 Agent 处理。
npm install -g mailly-cli # Node.js 18+
mailly login # 浏览器登录;远程机器用 --no-browser
mailly inbox addresses list --json
mailly inbox threads list --json常见问题
- 显示
! Needs authentication:运行/mcp完成认证,或运行claude mcp login mailly。 - 配置了
Authorization请求头后显示✘ Failed to connect:Claude Code 会把被拒绝的密钥报告为连接失败。检查密钥,或删掉请求头改用 OAuth。claude mcp get mailly的Issue:一行会显示 HTTP 状态。 - 缺少某个工具:它需要你没有授予的权限。在
/mcp中选择 Clear authentication,重新认证并勾选该权限。Mailly 不会自动扩大已有授权。 - 登录后浏览器回跳失败:把地址栏里完整的回调 URL 粘贴到 Claude Code 的提示中。
- 收不到邮件:在工作台确认地址,并查看收件箱的垃圾邮件文件夹。
- 发送被拒绝:用
mailly_account查看余额和额度。Free 套餐滚动 24 小时内最多 100 个发送收件人,详见价格。
运行 claude mcp remove mailly 可移除 Mailly,Claude Code 会同时删除保存的令牌。