Mailly文档

给 Codex 一个专属邮箱

通过 Remote MCP 和 OAuth,把 OpenAI Codex(CLI、IDE 扩展和 ChatGPT 桌面应用)连接到 Mailly 邮箱。

Codex 可以直接处理一个真实邮箱:搜索会话、读取来信、保存回复草稿,并在你确认最终正文后发送。Mailly 给它一个 your-name@mailly.site 这样的地址,通过 Remote MCP 连接。Codex CLI、IDE 扩展和 ChatGPT 桌面应用共用同一份 MCP 配置,只需配置一次。

你会得到

  • 一个可收可发的 @mailly.site 邮箱;Developer 套餐还可以使用自己的域名。
  • 约 70 个类型明确的 MCP 工具,覆盖会话、草稿、发信、域名、联系人、模板、Campaign 和 Workflow,并受你授予的授权范围限制。
  • 发信由你把关:Codex 会展示确切的正文和收件人,你确认后才发送。

开通邮箱

已有 Mailly 账户可跳过这一步。

把下面的提示词粘贴到 Codex。它会读取 Mailly 的开通说明,询问你想要的名称,通过 HTTP 预留,再把验证链接交给你。

Prompt
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.

打开链接,用你自己已验证的邮箱登录或注册,然后确认这个邮箱。之后 Codex 会拿到邮箱地址和你账户的 API Key。如果 Codex 的沙箱无法联网,可以直接在 mailly.site/onboard 开始。规则见让 Agent 帮你开通邮箱。

添加 Mailly MCP 服务器

codex mcp add mailly --url https://mcp.mailly.site/mcp

这会把服务器写入 ~/.codex/config.toml。也可以手动添加:

~/.codex/config.toml
[mcp_servers.mailly]
url = "https://mcp.mailly.site/mcp"

项目级的 .codex/config.toml 也可以,但只在受信任的项目中生效。

登录并选择授权范围

codex mcp login mailly

浏览器会打开 Mailly 的登录与授权页面。Mailly 接受 Codex 发布的客户端身份,不需要填写 client ID 或 secret。由你决定 Codex 能做什么:

授权范围Codex 可以
mail:read读取邮箱、会话、已发邮件、草稿和设置。始终授予。
mail:draft保存、修改、放弃回复草稿;不能发送。
mail:send发送你审核过的回复、转发和新邮件。
workspace:manage管理地址、域名、模板、联系人、Campaign、Workflow 和 Webhook。

无交互运行

在 CI 或没有浏览器的机器上,Codex 可以从环境变量读取 Mailly API Key,作为 Bearer 令牌发送:

~/.codex/config.toml
[mcp_servers.mailly]
url = "https://mcp.mailly.site/mcp"
bearer_token_env_var = "MAILLY_API_KEY"

API Key 拥有完整的账户权限,不受授权范围限制。请放在环境变量里,不要贴进聊天或提交到仓库。在工作台的接入页查看。

验证连接

  1. 运行 codex mcp list,确认列出了 mailly。在 Codex TUI 中,/mcp 会显示当前启用的服务器。
  2. 对 Codex 说:“用 Mailly 列出我的邮箱地址和最近 5 个会话。” 它应调用 mailly_list_inbox_addresses 和 mailly_list_threads。
  3. 用你的个人邮箱给 Mailly 地址发一封邮件,然后说:“读取我在 Mailly 的最新会话并保存一份回复草稿,给我看确切正文,先不要发送。” Codex 会调用 mailly_read_thread 和 mailly_save_draft。在对话中批准或放弃这份草稿。

改用 CLI

如果沙箱允许联网,Codex 也可以在 shell 中使用 mailly-cli。所有命令都支持 --json。

npm install -g mailly-cli   # Node.js 18+
mailly login                # 浏览器登录;远程机器用 --no-browser
mailly inbox addresses list --json
mailly inbox threads list --json

常见问题

  • Mailly 工具报授权错误:重新运行 codex mcp login mailly。
  • 缺少某个工具:它需要你没有授予的权限。重新运行 codex mcp login mailly,在 Mailly 授权页勾选该权限。Mailly 不会自动扩大已有授权。
  • 项目里的 .codex/config.toml 没有生效:Codex 只在受信任的项目中读取项目级 MCP 设置。改为添加到 ~/.codex/config.toml。
  • 收不到邮件:在工作台确认地址,并查看收件箱的垃圾邮件文件夹。
  • 发送被拒绝:用 mailly_account 查看余额和额度。Free 套餐滚动 24 小时内最多 100 个发送收件人,详见价格。

本页内容