MachineMail：面向 AI 智能体的邮箱 API

通俗解释：MachineMail 是做什么用的？

MachineMail 是给 AI 智能体使用的邮箱服务。假设你让智能体完成一个经过授权的网站注册任务：它填完表单后，网站把验证码发到邮箱，任务就容易卡在“等你去收邮件”这一步。MachineMail 为智能体提供独立的真实邮箱地址，让它通过 MCP 或 API 等待邮件、读取验证码，或者收到别人的回复后继续处理任务。

你可以把它理解成“给软件助手配一个工作邮箱”。人通过网页控制台查看邮件、管理权限，智能体通过接口收发和回复。它主要适合开发 AI 助手的程序员、搭建邮件自动化流程的团队，以及需要把智能体通信与私人邮箱分开的用户。具体如何理解邮件、完成业务任务，仍由接入的 AI 客户端和你设置的规则决定。

从首次接入到收取验证码，实际怎么用？

按照官方快速入门，可以先跑通一次可检查的收发闭环：

1. 使用你自己的外部邮箱注册并打开登录链接，保存首次展示的 API Key。完整密钥只展示一次；给智能体使用时，优先创建限定邮箱或 Pod 范围、限定权限的密钥。
2. 在支持的 MCP 客户端中添加 https://mcp.machinemail.dev/mcp。交互式客户端可通过 OAuth 登录；服务器和无界面任务可使用 API Key。REST API 的入口为 https://api.machinemail.dev/v0。
3. 创建一个智能体邮箱，向自己能查看的地址发送测试邮件，再从该地址回复。检查消息、对话线程和信任报告是否符合预期。
4. 需要验证码时，先发起你授权的注册或登录请求，再调用 wait_for_message 等待邮件，单次最多等待 60 秒。确认发件域名确实属于目标服务，并且邮件为 known 或 verified，再从清理后的正文提取预期验证码。

也可以让智能体读取自注册协议 auth.md，先获得沙盒邮箱，再由人前往官网认领页面输入六位认领码。未认领邮箱有效期为 24 小时，且有独立的发信限制；认领后应切换到新凭证，不能把沙盒当成长期生产邮箱。

匿名沙盒只提供一个邮箱，每个滚动 24 小时最多发送 10 封给 10 位不同收件人，每封最多 5 位收件人。

邮件信任等级能解决什么问题？

任何知道地址的人都可能给智能体发邮件，因此邮件正文不能自动变成任务指令。MachineMail 为每封入站邮件提供 verified、known、unknown、suspicious、quarantined 五种信任等级，并结合 SPF、DKIM、DMARC、既往通信、链接、附件和分类结果解释判定原因。

接入时应让模型读取 trust.content.text：这个字段会剔除隐藏文本、不可见字符、签名和引用历史。它并不保证删除所有可见的恶意指令，某些内容会保留并标记风险。可疑邮件交给人工处理；需要人审核的回复应保存为不带预约发送时间的草稿。

官方智能体信任指南 特别说明，MCP 工具描述只是给模型的建议，不能代替应用程序中的权限检查。付款、转发敏感内容等重要动作，应由实际的工具权限和人工审批控制。

自定义域名、临时邮箱和 Webhook 的使用场景

如果希望按任务分配地址，可以在已验证的自定义域名上开启 catch-all：某个新地址首次收到邮件时，系统自动建立对应收件箱。共享的 machinemail.dev 域名不提供这种 catch-all 行为。临时邮箱则适合有明确结束时间的流程；新来信会延长到期时间，到期后邮箱、邮件、原始 MIME 和附件会被删除，需要保留的内容应提前导出。

生产系统可用带签名的 Webhook 接收邮件事件，失败投递会重试五天，并可在控制台重放；SSE 和 WebSocket 也是官方提供的事件接入方式。这样可以在来信后触发后续流程，而无需一直反复查询邮箱。

所有套餐都不按单个邮箱收费，但共享域名每个组织最多持有 1,000 个邮箱。自有已验证域名没有邮箱数量上限，仍受邮件流量、存储和套餐规则约束。

免费版够不够用？付费版怎样计费？

以下为 2026 年 11 月 5 日核实的官网美元月付标价，未含适用税费；实际支付条件以结账页为准：

• Free：每月收发合计 3,000 封，每天最多 100 封；1 GB 存储、1 个自定义域名、1 个席位。
• Pro：9 美元/月，包含 7,500 封入站、2,500 封出站邮件，10 GB 存储和 10 个域名。
• Team：49 美元/月，包含 45,000 封入站、15,000 封出站邮件，30 GB 存储和 50 个域名。
• Scale：199 美元/月，包含 200,000 封入站、65,000 封出站邮件，150 GB 存储和 250 个域名，并提供专属 Slack 支持。

付费套餐超额部分按量结算：入站每 1,000 封 1 美元；出站每 1,000 个收件人 0.50 美元；额外存储每 GB 每月 0.25 美元；额外域名每个每月 1 美元。出站按收件人数计量，群发一封不等于只消耗一封额度；垃圾邮件和隔离邮件不计费。

免费版超出额度后，入站邮件会暂存等待额度重置或升级，发信暂停。付费订阅按月自动续订，取消在当前账期结束后生效。选择前查看官网最新套餐与超额规则。

邮件会存在哪里，会用于训练 AI 吗？

MachineMail 的隐私政策声明，不会使用邮件训练机器学习模型。不过邮件内容仍会进入信任层分析，包括托管模型分类；“不用于训练”不能理解为“没有 AI 处理”。核心服务器、数据库和邮件处理基础设施位于美国，对象存储与分类处理可能涉及其他地区，不能据此承诺数据只在某一个国家处理。

永久邮箱的邮件通常保留至用户删除；临时邮箱到期后删除对应数据，备份中的副本可能继续保留到备份轮换结束。收件箱可导出为 mbox 或 JSON Lines。接入的 AI 客户端收到邮件后，还适用该客户端自己的隐私政策。处理敏感业务邮件前，应阅读官方数据处理与保留说明，并为每个智能体限定最小访问范围。

常见问题

MachineMail 只能收验证码，还是也能发邮件？

它支持收件、发件和在线程内回复，也支持草稿。是否允许智能体直接发送，应由你授予的权限和应用侧审批决定。

一直没有收到预期验证码，应该检查什么？

先检查收件地址、目标服务是否真正发信，以及免费版是否已到日/月额度。隔离邮件不会唤醒 wait_for_message；单次等待最多 60 秒也不代表目标服务保证在一分钟内投递。可查看控制台、信任报告和官方状态页。

临时邮箱过期后，邮件还能取回来吗？

官网说明到期会删除邮箱及邮件、原始 MIME 和附件，不应把它作为归档方式。需要长期使用的沙盒地址应在认领期限内认领；有保留需求的邮件应提前导出。

信任报告能保证没有提示注入吗？

不能。检测可能漏判攻击，也可能误判正常邮件。清理后的正文仍属于外部输入，重要操作需要实际权限约束与人工审核；不用于训练也不等于不经过云端处理。

官方资源与开发者社区

• 接入文档与 API 快速入门
• 智能体 Skills 与插件源码 · 智能体插件
• 账号、域名和接入支持
• 服务故障与维护状态
• X 官方更新