本页由英文自动翻译。

阅读英文版
Proxy Mail QA

MCP server 和插件

一个 MCP server,适用于所有编程智能体。

Proxy Mail QA 的 MCP server 为 Claude Code、Cursor、GitHub Copilot、Codex、ChatGPT 等智能体提供工具,用于创建测试用户并获取其验证码和链接。一条提示即可连接,通过浏览器登录。

免费套餐 · https://api.proxymail.qa/mcp · Streamable HTTP

连接

最快的方式:一条提示。

把设置提示粘贴到你的智能体中。它会为当前所用的工具添加服务器,你只需在浏览器中登录一次。也可以自己添加:

Claude Code

添加服务器,然后输入 /mcp,选择 proxymail-qa 并点击 Authenticate。

终端
claude mcp add --transport http proxymail-qa https://api.proxymail.qa/mcp

Cursor

在 Cursor Directory 上点击 Add to Cursor,或在 ~/.cursor/mcp.json 的 mcpServers 下添加。然后在 Cursor 设置的 MCP 部分登录。Cursor Directory 上的 Proxy Mail QA →

~/.cursor/mcp.json
"proxymail-qa": { "url": "https://api.proxymail.qa/mcp" }

VS Code 中的 GitHub Copilot

在 .vscode/mcp.json 的 servers 下添加,然后点击上方的 Start。

.vscode/mcp.json
"proxymail-qa": { "type": "http", "url": "https://api.proxymail.qa/mcp" }

OpenAI Codex

Codex 从你的环境变量读取 API 密钥。

终端
codex mcp add proxymail-qa --url https://api.proxymail.qa/mcp --bearer-token-env-var PROXYMAIL_QA_API_KEY

Antigravity、Copilot 云端智能体、Android Studio 等

工具

你的智能体可以调用的功能。

工具作用
get_project它所在的项目:默认邮件域名和其他域名、邮箱前缀、限额
create_address一个新的测试地址,附带虚构的姓名和用户名、符合某个年龄的出生日期、国家,以及按需提供的密码
form_values注册表单每个字段该填写或选择什么:符合规则的用户名和密码、符合格式的出生日期、表单提供的国家
wait_for_code最多等待 30 秒获取验证码或登录码并返回
wait_for_link同样适用于验证链接、魔法登录链接、邀请链接、密码重置链接,或打开移动应用的链接
list_addresses项目中的地址及其最新的验证码或链接;可按标签、国家、年龄、已保存密码、文本、网站或环境筛选,找到之前创建的账号
check_delivery某个地址收到了什么、我们拒收了什么,以及什么都没收到时的可能原因
update_address姓名、用户名、出生日期或国家,以及备注、标签或名称
set_password在应用更改或重置密码后,保存测试账号当前使用的密码
get_address_variants应被接受的地址特殊写法,以及应被拒绝的无效地址
get_name_variants用于表单姓名字段的刁钻姓名:撇号、重音符号、其他文字、超长姓名,以及应作为文本存储的 HTML 或 SQL
get_password_variants符合字段规则的刁钻密码:最短和最长长度、各类符号、空格、非 ASCII 字符
delete_address删除一个地址及其邮件
get_saved_password读取已保存的密码;仅限获准的 API 密钥
get_sign_in一次调用获取用于登录某网站的已保存测试账号及其密码;仅限获准的 API 密钥
mark_dev_host标记 localhost:3000 等开发主机,使邮件检查放行指向它的链接
update_project更改项目名称、网站、环境、邮件前缀或默认邮件域名,与项目设置相同。归档和删除仍在应用中进行
check_email检查收到的邮件:SPF、DKIM、DMARC、本地或 http 链接、链接指向何处、声明的有效期、大小、是否适配手机、预期文本及其语言;开启 Labs 后,还有营销检查和满分 10 分的垃圾邮件评分。只返回结论
count_emails收到了多少封邮件,用于发现重复邮件
expect_no_email如果没有收到任何邮件则通过,用于“已退订的用户收不到邮件”
record_coupon_result在 Labs 中:结账时如何处理优惠券,按其截止日期和一次性使用规则判断;check_offers 标记同一人两次收到同一优惠
mark_unsubscribed在 Labs 中:记录一次退订,之后该发件人的任何营销邮件都会被标记;配合 check_unsubscribe 和 mark_resubscribed 使用
record_consent在 Labs 中:账号注册时同意了什么,用于按国家适用的营销规则;check_sequence 检查欢迎系列邮件是否按顺序准时到达
check_out_account借用一个状态已知、其他测试未占用的测试账号;return_account 将其归还
start_run将一次会话记录为一次运行;finish_run 以 Markdown 返回报告,并列出与同名的上几次运行相比有何变化

每个工具都会说明它只读取还是会更改内容,方便智能体在操作前先询问。结果只包含验证码或链接,从不包含邮件正文。现成的提示涵盖注册测试、密码重置、验证码登录、准备账号、账号邮件审查以及认证回归测试包。

登录与安全

你的智能体只能访问一个项目,期限由你决定。

  • 浏览器登录

    OAuth 2.1 加 PKCE:智能体打开一个页面,你在页面上登录、选择一个项目并授权。无需复制密钥。

  • 或使用 API 密钥

    对于无法这样登录的工具,从项目设置中获取密钥,作为 Bearer 令牌 发送。不要把它放进你提交的文件中。

  • 短时有效的令牌

    访问令牌有效期 1 小时。刷新令牌有效期 90 天,每次使用都会更换;一旦旧令牌被重复使用,应用就会被断开连接。

  • 一个项目

    已连接的智能体以你的身份在你选择的项目中工作,无法读取之前保存的密码。

  • 随时断开

    已连接的智能体列在 Project settings → API keys 中,与你的密钥放在一起。

  • 合理的限额

    免费套餐每个密钥每分钟 60 次请求,Team 套餐 600 次。

插件和收录

为 Claude Code、Cursor、ChatGPT 和 Qoder 现成可用,智能体常去的地方都能找到。

Claude Code 插件

包含 MCP server 和一个技能,引导 Claude 端到端测试注册流程。然后输入 /mcp 并点击 Authenticate。

Claude Code
/plugin marketplace add aaquib90/proxymail-qa-plugin
/plugin install proxymail-qa@proxymail-qa

智能体技能

适用于 Claude Code、Cursor、Codex 及其他支持技能的智能体的 技能,从端到端测试注册,到审查所有账号邮件、测试营销和优惠邮件:npx skills add https://proxymail.qa。

Cursor Directory

附带 MCP server 和技能 已收录:点击 Add to Cursor 安装,然后在 Cursor 设置中登录。

Qoder Marketplace

作为连接器收录(仅 MCP server),也 作为插件收录(附带八个技能,从端到端测试注册到营销和优惠邮件)。在 Qoder 中连接或安装,然后登录。

官方 MCP Registry

以 qa.proxymail/proxymail-qa 收录,浏览该注册表的 MCP 客户端可以找到它。

ChatGPT 和 Claude

已在 ChatGPT 的插件目录中 收录:在那里、在 ChatGPT 或 Codex 中安装,然后登录。在 Claude 中,用服务器地址将其添加为自定义连接器。

FAQ

常见问题

我可以问它什么?

比如“给我一个用于预发布环境注册的测试邮箱,验证码到了告诉我”、“为什么我的应用收不到验证邮件?”或“检查我的应用发到测试地址的密码重置邮件”。在聊天中,你用它给的地址注册,它告诉你验证码或链接;能使用浏览器的智能体,比如 Claude Code、Cursor 或 Codex,可以自己完成整个注册:“用一个新测试账号在 localhost:3000 注册并确认邮件。”

它是哪种 MCP server?

一个远程服务器,通过 Streamable HTTP 在 https://api.proxymail.qa/mcp 提供服务。无需在你的电脑上安装或运行任何东西。

能和 ChatGPT 或 Claude 一起用吗?

可以。在 ChatGPT 中,从 ChatGPT 的插件目录安装 Proxy Mail QA。在 Claude 中,在 Settings → Connectors 下用服务器地址添加自定义连接器。之后你需要登录并选择一个项目。

它在 Qoder Marketplace 上吗?

在。在 Qoder 的国际站和中国站上作为连接器(仅 MCP server)收录,也作为附带八个技能的插件收录。在 Qoder 中连接或安装,然后登录并选择一个项目。

我的智能体不在列表中,能用吗?

只要它支持远程 MCP 服务器就能用:支持 OAuth 的用浏览器登录,否则在请求头中使用 API 密钥。MCP 页面提供了更多工具的步骤,包括 Windsurf、Zed、Kiro、Amazon Q Developer、OpenCode、Kilo Code、Trae、Mistral Vibe、Qwen Code、Kimi CLI 和 JetBrains IDE。

要收费吗?

不收费。所有套餐都包含 MCP server,包括免费套餐。

更多功能

一条提示连接你的智能体。

创建免费账号,然后把设置提示粘贴到你的智能体中,登录一次即可。

免费创建账号打开应用

对本页有疑问?

可以用任何语言提问。文档可以立即回答,你也可以把问题发给 Proxy Mail QA 团队,他们会用英文回复。