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/mcpCursor
在 Cursor Directory 上点击 Add to Cursor,或在 ~/.cursor/mcp.json 的 mcpServers 下添加。然后在 Cursor 设置的 MCP 部分登录。Cursor Directory 上的 Proxy Mail QA →
"proxymail-qa": { "url": "https://api.proxymail.qa/mcp" }VS Code 中的 GitHub Copilot
在 .vscode/mcp.json 的 servers 下添加,然后点击上方的 Start。
"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工具
你的智能体可以调用的功能。
| 工具 | 作用 |
|---|---|
| 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。
/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 设置中登录。
官方 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,包括免费套餐。