MCP server

最快的方法是一条提示完成设置：你的智能体会自己完成连接，你只需在浏览器中登录一次。如果你还没有账号，可以在同一页面创建，然后直接回来授权。如果要自己设置，或使用 API 密钥，请按下面对应工具的步骤操作。

MCP server 的地址是 https://api.proxymail.qa/mcp（Streamable HTTP）。以 Bearer 令牌 的形式发送密钥。

Claude Code

claude mcp add --transport http proxymail-qa https://api.proxymail.qa/mcp --header "Authorization: Bearer $PROXYMAIL_QA_API_KEY"

Cursor

最快的方法是在 Proxy Mail QA 的 Cursor Directory 页面 上点击 Add to Cursor，它会安装服务器和一个技能；然后在 Cursor 设置的 MCP 部分登录。如果要改用 API 密钥，在 .cursor/mcp.json 中：

{
  "mcpServers": {
    "proxymail-qa": {
      "url": "https://api.proxymail.qa/mcp",
      "headers": { "Authorization": "Bearer qa_…" }
    }
  }
}

VS Code 中的 GitHub Copilot

在 .vscode/mcp.json 中，或你的用户 mcp.json 中。VS Code 会在第一次使用时询问密钥并安全保存，所以密钥不会出现在文件中：

{
  "inputs": [{ "id": "proxymail-qa-key", "type": "promptString", "description": "Proxy Mail QA API key", "password": true }],
  "servers": {
    "proxymail-qa": {
      "type": "http",
      "url": "https://api.proxymail.qa/mcp",
      "headers": { "Authorization": "Bearer ${input:proxymail-qa-key}" }
    }
  }
}

Copilot 云端智能体

在 GitHub.com 上，把密钥保存为名为 COPILOT_MCP_PROXYMAIL_QA_KEY 的 Agents secret，然后在仓库的 Settings → Copilot → MCP servers 中：

{
  "mcpServers": {
    "proxymail-qa": {
      "type": "http",
      "url": "https://api.proxymail.qa/mcp",
      "headers": { "Authorization": "Bearer $COPILOT_MCP_PROXYMAIL_QA_KEY" },
      "tools": ["create_address", "wait_for_code", "wait_for_link", "check_delivery", "list_addresses", "update_address"]
    }
  }
}

云端智能体运行列出的工具时不会询问，所以这个列表不包含 delete_address。

Google Antigravity

在智能体面板中打开 … → MCP Servers → Manage MCP Servers → View raw config，添加服务器，然后重启 Antigravity。Antigravity 对远程服务器使用 serverUrl。没有 headers 时，它首次连接会通过浏览器登录；有了它们，就会使用密钥：

{
  "mcpServers": {
    "proxymail-qa": {
      "serverUrl": "https://api.proxymail.qa/mcp",
      "headers": { "Authorization": "Bearer qa_…" }
    }
  }
}

OpenAI Codex

要通过浏览器登录（不用密钥），运行 codex mcp add proxymail-qa --url https://api.proxymail.qa/mcp：Codex 会打开登录页面（或者运行 codex mcp login proxymail-qa）。要使用密钥，Codex 会从你的环境变量中读取：

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

Android Studio 和 Xcode

Android Studio 中的 Gemini（智能体模式）支持远程 MCP 服务器。把服务器作为 httpUrl 添加到它的 MCP 配置中，然后在它要求时登录：

{
  "mcpServers": {
    "proxymail-qa": { "httpUrl": "https://api.proxymail.qa/mcp" }
  }
}

Xcode： Claude Code 和 Codex 可以在使用 Proxy Mail QA 的同时使用 Xcode 自己的工具（xcrun mcpbridge），Claude Code Desktop 可以在它的 iOS Simulator 窗格中运行你的应用并在其中注册。Xcode 的内置智能体也可以添加 MCP 服务器和插件。这些内容都在 用编程智能体iOS应用 中；UI 测试请参阅 移动应用。

Windsurf

在 Cascade 面板中打开 … → MCPs → Open MCP config file 并添加服务器。Windsurf 对远程服务器使用 serverUrl，首次连接时会通过浏览器登录：

{
  "mcpServers": {
    "proxymail-qa": { "serverUrl": "https://api.proxymail.qa/mcp" }
  }
}

如果要改用 API 密钥，添加 "headers": { "Authorization": "Bearer ${env:PROXYMAIL_QA_API_KEY}" }，它会从你的环境变量中读取密钥。

Zed

打开 Settings → AI → MCP Servers → Add Server → Add Remote Server，或者把它添加到你的设置文件中。没有 Authorization 请求头时，Zed 会让你通过浏览器登录：

{
  "context_servers": {
    "proxymail-qa": { "url": "https://api.proxymail.qa/mcp" }
  }
}

Kiro

把服务器添加到项目中的 .kiro/settings/mcp.json，或者添加到 ~/.kiro/settings/mcp.json 以用于所有项目。Kiro 在第一次连接时通过浏览器登录：

{
  "mcpServers": {
    "proxymail-qa": { "url": "https://api.proxymail.qa/mcp" }
  }
}

如果要改用 API 密钥，添加 "headers": { "Authorization": "Bearer ${PROXYMAIL_QA_API_KEY}" }。

Amazon Q Developer

在 VS Code 和 JetBrains IDE 中： 打开 Amazon Q 聊天面板，选择工具图标，然后选择 +。选择范围：全局（保存在 ~/.aws/amazonq/default.json 中）或本地（保存在工作区的 .amazonq/default.json 中）。把服务器命名为 proxymail-qa，选择 http 传输方式，填写 URL https://api.proxymail.qa/mcp，然后选择 Save。Amazon Q 在第一次连接时会打开浏览器让你登录。如果要改用 API 密钥，添加名为 Authorization、值为 Bearer qa_… 的请求头，并使用全局范围，这样密钥不会进入你的代码仓库。

AWS 将于 2027 年 4 月 30 日停止支持 Amazon Q Developer IDE 插件，并建议用户改用 Kiro。

在命令行中： Amazon Q Developer CLI 现在是 Kiro CLI，它会读取 ~/.kiro/settings/mcp.json，所以请按照上面的 Kiro 步骤操作。

OpenCode

把服务器添加到项目中的 opencode.json，或者添加到 ~/.config/opencode/opencode.json 以用于所有项目。服务器第一次要求时，OpenCode 会通过浏览器登录，你也可以运行 opencode mcp auth proxymail-qa：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "proxymail-qa": { "type": "remote", "url": "https://api.proxymail.qa/mcp" }
  }
}

如果要改用 API 密钥，添加 "oauth": false 和 "headers": { "Authorization": "Bearer {env:PROXYMAIL_QA_API_KEY}" }，后者会从你的环境变量中读取密钥。

Kilo Code

把服务器添加到项目中的 kilo.jsonc，或者添加到 ~/.config/kilo/kilo.jsonc 以用于所有项目。Kilo Code 在连接时通过浏览器登录：

{
  "mcp": {
    "proxymail-qa": { "type": "remote", "url": "https://api.proxymail.qa/mcp" }
  }
}

如果要改用 API 密钥，在用于所有项目的文件中添加 "oauth": false 和 "headers": { "Authorization": "Bearer qa_…" }，这样密钥不会进入你的代码仓库。

Roo Code

在 Roo Code 窗格中，点击 MCP 图标，然后点击列表底部的 Edit Global MCP。Roo Code 会在请求头中发送 API 密钥。Edit Project MCP 则会在项目中写入 .roo/mcp.json，所以如果你要提交这个文件，不要把密钥放进去：

{
  "mcpServers": {
    "proxymail-qa": {
      "type": "streamable-http",
      "url": "https://api.proxymail.qa/mcp",
      "headers": { "Authorization": "Bearer qa_…" }
    }
  }
}

Augment Code

在 Augment 面板中，打开选项菜单 → Settings，然后在 MCP 下点击 + Add remote MCP。选择 HTTP 连接类型，命名为 proxymail-qa，填写地址 https://api.proxymail.qa/mcp，并在它要求时通过浏览器登录。

Trae

打开 Settings → MCP，然后打开 Add → Create Manually，粘贴服务器配置。Trae 会在请求头中发送 API 密钥。开启 Enable Project MCP 后，项目自己的服务器放在 .trae/mcp.json 中，所以如果你要提交这个文件，不要把密钥放进去：

{
  "mcpServers": {
    "proxymail-qa": {
      "url": "https://api.proxymail.qa/mcp",
      "headers": { "Authorization": "Bearer qa_…" }
    }
  }
}

Qoder

从 Qoder Marketplace 连接：在 Connectors 标签页中打开 Proxy Mail QA（在 国际站 或 中国站），连接它，然后在浏览器中登录 Proxy Mail QA 并选择智能体可以使用的项目。Qoder 插件 还额外提供八个技能。如果要手动添加服务器，打开 Qoder IDE Settings → MCP，在 My Servers 标签页中选择 + Add，在 mcpServers 下用 "type": "http" 和地址 https://api.proxymail.qa/mcp 添加。给智能体用的提示词和规则在 Qoder 指南 中。

Mistral Vibe

Vibe 会把服务器添加到你的 config.toml，并打开浏览器让你登录：

vibe mcp add proxymail-qa --url https://api.proxymail.qa/mcp

如果要改用 API 密钥，添加 --api-key-env PROXYMAIL_QA_API_KEY，它会从你的环境变量中读取密钥，并作为 Bearer 令牌 发送。

Qwen Code

为所有项目添加服务器，然后在 Qwen Code 中打开 /mcp 并通过浏览器登录：

qwen mcp add --transport http --scope user proxymail-qa https://api.proxymail.qa/mcp

如果要改用 API 密钥，添加 --header "Authorization: Bearer $PROXYMAIL_QA_API_KEY"。

Kimi CLI

用浏览器登录方式添加服务器，然后登录一次：

kimi mcp add --transport http --auth oauth proxymail-qa https://api.proxymail.qa/mcp
kimi mcp auth proxymail-qa

如果要改用 API 密钥，去掉 --auth oauth 并添加 --header "Authorization: Bearer $PROXYMAIL_QA_API_KEY"。

其他客户端

任何通过 Streamable HTTP 连接远程 MCP 服务器的客户端都一样：填写 https://api.proxymail.qa/mcp，然后在它要求时通过浏览器登录；如果它无法登录，就以 Authorization: Bearer qa_… 发送 API 密钥。在 JetBrains IDE 中，AI Assistant 在 Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add 下添加服务器，类型为 HTTP 服务器，填写这个地址。

Claude 和 ChatGPT

Claude（claude.ai 和 Claude 应用）以及 ChatGPT 通过浏览器登录，无需复制密钥。在 ChatGPT 和 Codex 中，从 ChatGPT 插件目录中的 Proxy Mail QA 页面 安装。在 Claude 中，在 Settings → Connectors → Add custom connector 下添加一个自定义连接器，地址为 https://api.proxymail.qa/mcp。无论哪种方式，你都会被引导到 Proxy Mail QA 登录（或在那里创建账号），选择它可以使用的项目（或为第一个项目命名），然后授权。

在聊天中，由你来注册：先要一个测试地址（“给我一个用于预发布环境注册的测试邮箱，验证码到了告诉我”），用它注册，邮件到达后助手会把验证码或链接告诉你。它还能告诉你邮件为什么没到，或者检查已经到达的邮件。

新的测试地址会在对话中附带一张收件箱卡片：地址和它的角色信息，都带复制按钮（密码只显示为 Copy password），验证码或链接一到达就会显示，并附上邮件的检查结果。卡片会自己等待邮件 10 分钟，并把收到的内容告诉助手，所以你不用再问一次。如果你在卡片功能上线前就已连接，请在 Claude 中重新连接连接器，或在 ChatGPT 中刷新它，才能看到卡片。不显示卡片的工具会以文本形式得到相同的回答。

已连接的应用会获得只针对该项目的令牌：它可以创建和删除测试地址，为新地址生成用于注册表单的密码，并读取验证码和链接，但不能读取之前保存的密码。它会作为已连接应用列在 Project settings → API keys 下；你可以随时在那里断开它。其他支持 OAuth 登录的 MCP 客户端也一样。

无需账号即可搜索文档

任何智能体都可以在 https://search.proxymail.qa/mcp 搜索这些文档和指南，无需登录。它只有一个工具 search，会返回与问题匹配的段落及其页面地址。已登录的连接也能使用同样的搜索，对应的工具是 search_docs。

claude mcp add --transport http proxymail-qa-docs https://search.proxymail.qa/mcp

你可以在 proxymail.qa/ask 向文档提问。

工具

工具	作用
get_project	它所在的项目：默认邮件域名和其他域名、邮箱前缀、限额
create_address	一个新的测试地址，附带用于注册表单的虚构姓名和用户名、用于 age 的出生日期（例如 under13）、country（例如 GB），以及按需生成的密码（password: true）。site 和 environment 记录它用在哪里（与 Chrome 扩展相同），并显示在应用中的账号上
form_values	用于不只有邮箱字段的表单：把页面上每个字段的说明给它，它会基于为此新建的地址告诉你每个字段该填什么或选什么（符合规则的用户名和密码、按字段格式填写的出生日期、下拉框中提供的国家）。由智能体填写表单
wait_for_code	最多等待 30 秒，获取验证码或登录码并返回。unused: true 会跳过已用过的验证码；kind: coupon 会等待优惠券或促销码，并附带折扣和有效期，after_seconds 会说明它在 since 之后多久到达
wait_for_link	对验证、魔法登录、邀请或重置密码链接做同样的事。邮件中同时有网页链接时，app: true 会要求返回打开移动应用的链接（myapp://…）；kind: unsubscribe（或 list_unsubscribe）会给出退订链接供智能体使用，Proxy Mail QA 从不打开它
get_address_variants	用于测试注册表单的特殊地址变体：仍能收到邮件的（大写字母、带特殊字符的加号标签）、有效但邮件服务器会拒收的，以及无效的（更多）
search_docs	在这些文档和指南中搜索操作方法（query、limit），例如如何搭建测试框架或邮件为什么没到，并返回最匹配的段落及其页面地址
get_name_variants	用于表单姓名字段的刁钻姓名（field、max_length）：应接受的（撇号、重音符号、其他文字、单个字母、正好达到最大长度）、应拒绝的、应作为文本保存的 HTML 或 SQL，以及各应用处理不一的（更多）
get_password_variants	符合字段规则的刁钻密码（min_length、max_length、symbols）：最短和最长、每类符号、空格、非 ASCII 字符，以及各应用处理不一的；每次调用都重新生成（更多）
check_delivery	无需等待即可说明一个地址的邮件情况：收到了什么，我们拒收了什么或 Cloudflare 的邮件服务器拒绝了什么（例如未通过 DMARC），以及什么都没收到时的可能原因
list_addresses	项目的地址，每个都附带其角色信息、标签和最新的验证码或链接。可用筛选条件找到之前创建的测试账号：tags、country、min_age 和 max_age、has_password、search、site 和 environment
update_address	如果应用修改过，更新它的名字、姓氏、用户名、出生日期或国家，以及备注、标签或标记：说明这个测试账号的用途
set_password	在应用修改或重置密码后，保存测试账号当前使用的密码；不填则自动生成一个
delete_address	删除一个地址及其邮件
get_saved_password	仅限有权读取已保存密码的密钥
get_sign_in	一次调用即可重新登录已保存的测试账号：返回此 site 对应的账号（按给定的 tags 和 environment）及其密码，选择方式与扩展的登录列表相同。仅限有权读取已保存密码的密钥
mark_dev_host	把 localhost:3000 这样的主机标记为项目的开发环境，这样 check_email 会让指向它的链接通过检查，而不是判定失败
update_project	修改项目的名称、网站、环境、邮箱前缀或默认邮件域名，与项目设置中相同。需要项目负责人，或组织的所有者或管理员，每次修改都会记入活动日志。归档和删除仍需在应用中操作
check_email	检查已到达的邮件：SPF、DKIM 和 DMARC，指向 localhost 或纯 http 的链接，链接的去向（expect_host），声明的过期时间，优惠券何时到期，纯文本部分，大小，指定的短语（expect_text），语言（expect_language），在 since 之后多快到达（expect_within）以及附件（expect_attachment）；对于营销邮件，检查 List-Unsubscribe 请求头、退订链接和预览文本；对于所有邮件，检查会被收件箱拦截或不信任的附件（harmful_attachment），并估计是否会进入垃圾邮件（spam_risk）。营销检查、harmful_attachment 和 spam_risk 属于 Labs。只返回判定结果，从不返回邮件内容
count_emails	收到了多少封邮件（since、type、subtype、category：认证、事务或营销邮件），每封都只给摘要，不含内容：用于检查“恰好一封验证邮件”
expect_no_email	最多观察 30 秒，没有邮件到达则通过：用于检查“已退订的用户收不到任何邮件”，配合 category: marketing 时收据仍可到达。until 可在多次调用之间保持一个最长 1 小时的观察窗口
mark_unsubscribed	Labs。 在智能体用自己的浏览器完成退订后，记录该地址已退订某个发件人：之后该发件人发来的任何营销邮件，无论隔多久，都会使 after_unsubscribe 失败。grace（2h、1d）允许已在途中的邮件通过
mark_resubscribed	Labs。 记录该地址已重新订阅，结束观察
record_consent	Labs。 记录账号在注册时同意了什么（营销邮件、预先勾选的复选框、双重确认），以便 check_email 按角色所在地的规则评判它收到的营销邮件
record_coupon_result	Labs。 记录结账流程如何处理智能体使用的优惠券（在使用测试支付的预发布环境中）：接受、拒绝或出错，附带应用的提示信息，并给出 coupon_result 判定结果
check_sequence	Labs。 注册后的欢迎系列或滴灌营销邮件是否按顺序、按时到达：每封邮件的结果为通过、过早、过晚、缺失或等待中
check_offers	Labs。 每个发件人的优惠券，以及每张发给了地址的哪个变体（原样、大写、+tag）；同一个人两次收到同一优惠时，本次运行判定失败
check_unsubscribe	Labs。 每次退订及其之后收到的营销邮件，按 ID 和间隔时间列出；只要有一封，本次运行就判定失败
check_out_account, extend_checkout, return_account	借用一个处于已知状态（按 tags、country、年龄或已保存密码）且没有被其他测试占用的测试账号，用完后归还，并记录变更（更多）
start_run, add_run_note, finish_run	把一次会话记录为一次运行：向工具传入 run_id（以及它所属步骤的 test），finish_run 会以 Markdown 返回报告，供人查看或用于拉取请求，其中包括有多少封已检查的邮件可能进入垃圾邮件（需在 Labs 中开启垃圾邮件评分和附件检查）（更多）

标有 Labs 的工具属于营销和优惠邮件，这是一项 Labs 功能：由连接该智能体的人在应用的 Account settings → Labs 中开启。开启前，这些工具不会列给智能体（如果被调用，会返回说明此情况的错误），且 check_email 不包含已关闭的 Labs 功能的检查。

列表按项目调整。 智能体只能看到它在该项目中可以使用的工具和提示词，所以需要选择的更少：

• 项目测试 Offers 时，会列出优惠券工具（record_coupon_result、check_offers）及其提示词；
• 项目测试 Marketing 时，会列出退订、同意和序列工具（mark_unsubscribed、mark_resubscribed、check_unsubscribe、record_consent、check_sequence）及其提示词；
• 在对所有人开放之前，两者都需要在 Labs 中开启 Marketing and offer emails；之后，所有测试这些方面的项目都会列出它们。

在 Project settings → What you test 中选择项目要测试的内容。智能体的说明会写明哪些内容被隐藏以及如何显示，get_project 会返回项目的 areas。客户端在下次连接时会看到更改。

提示词

现成的检查清单，智能体用这些工具和它自己的浏览器工具按清单执行。测试结束后会生成一次运行的报告。在客户端列出 MCP 提示词的地方选一个（在 Claude Code 中，输入 / 并查找 proxymail-qa）：

提示词	作用
test_signup_flow	用新地址在你给的页面注册，完成验证，检查邮件并统计重复邮件
test_password_reset	借用一个已验证的账号，通过应用重置密码，检查重置邮件，保存新密码并归还账号
test_sign_in_code	借用一个已验证的账号，用应用发送的验证码或魔法链接登录
prepare_account	借用带有你给的标签的账号，在应用中确认它处于测试所需的状态（“在高级套餐上，没有订单”），没有空闲账号时在你给的注册页面新建一个，测试后归还
auth_regression_pack	注册、密码重置和邀请每次都执行相同步骤，包括链接重复使用和被替换的链接，每一步都在运行中命名；报告会说明与该测试包上几次运行相比有什么变化。也提供 智能体技能
audit_auth_emails	触发应用发送的每封账号邮件（验证、重置、登录、更改邮箱），逐封检查，并列出需要修复的问题
audit_marketing_consent	Labs。 对给出的每个国家，注册拒绝、选择加入和保留预先勾选框的账号，逐一记录，触发营销邮件，并报告哪些邮件违反规则，附带来源
test_coupon_checkout	Labs。 注册一个优惠，在 staging 环境中用测试支付在结账时使用优惠券，记录结果，再试一次，并报告每次尝试
test_offer_reuse	Labs。 用一个地址及其能送达同一收件箱的变体注册欢迎优惠或一次性优惠，并报告应用是否多次给出该优惠
test_unsubscribe	Labs。 用新地址订阅，用邮件自带的链接退订，记录下来，再触发更多营销邮件，检查不再收到营销邮件而收据仍正常送达
audit_marketing_emails	Labs。 选择接收应用的优惠和新闻通讯，触发它能触及的每封营销邮件，检查每封邮件的退订方式、预览文本和优惠券，并列出需要修复的问题。营销邮件测试技能 一次涵盖这项和上面四个提示词

使用方法

然后用平常的话提问：“在 localhost:3000 上用一个新的 Proxy Mail QA 地址注册，并确认邮件。”

有些 AI 智能体（包括 Claude）只会在你电脑上运行的应用（localhost）上注册。对于 staging 或生产站点，请让智能体编写一个使用 API 的 Playwright 或 Cypress 测试，然后自己运行或在 CI 中运行。如果想手动测试，Proxy Mail QA for Chrome 会用测试账号填写注册表单，并直接在页面中显示验证码或链接。

面向 Claude Code 和其他智能体的技能 描述了整个流程，更多技能 涵盖编写测试、审查和移动应用。