Playwright MCP 是什么？
Playwright MCP 是微软推出的浏览器自动化 MCP 服务器。接入 Codex 后，Codex 可以打开真实网页、识别按钮和输入框、执行点击与输入、切换桌面和手机视口，并把页面结构、截图和运行结果带回当前任务。它适合网页验收、交互排错和回归测试，不是普通搜索工具。
一句话理解让编码助手通过结构化页面信息执行浏览器检查、交互和回归验证。
为什么需要它？
把“打开页面看看”变成可重复的导航、点击、表单、截图和日志检查流程。
接入前，AI 只能依赖你粘贴的材料、截图或旧上下文；接入后，它可以在你授权的范围内调用真实工具，并把结果、来源和状态带回当前任务。
核心能力
读取页面可访问性结构并定位元素
把真实信息带回当前任务，减少反复复制和手动核对。
执行导航、点击、输入和截图
在明确授权范围内调用工具，并保留执行过程和结果。
检查响应式页面与浏览器运行时状态
回读来源、状态与限制，方便继续处理和人工验收。
适合谁？怎么用？
- 检查网页能不能打开、点击和提交
- 需要检查本地网站、复现交互问题、采集页面状态或验证修复结果的开发与运营人员。
- 能看到目标 URL、关键元素和截图；没有把测试操作误当成真实发布。
- 不适合直接连接带支付、生产账号或敏感 Cookie 的日常浏览器。
- 可读取浏览器中显示的页面内容
- 可代表用户点击、输入和跳转
怎么接入？
- 1准备
确认 Node.js 与 npx 可用，并使用独立测试浏览器配置。
- 2授权
在 Codex 终端运行
codex mcp add playwright -- npx -y @playwright/mcp@latest；其他客户端请按各自官方配置格式登记。 - 3连接
重新加载客户端并运行
codex mcp list，确认 Playwright 已出现。 - 4开始使用
打开无登录态测试页，读取页面结构验证连接。
安装命令
添加 Playwright MCP
codex mcp add playwright -- npx -y @playwright/mcp@latest在 PowerShell、Windows Terminal 或 macOS/Linux 终端运行。需要 Node.js 和 npx。
检查命令
确认 MCP 已经登记
codex mcp list不想自己操作终端时，把下面整段发给 Codex。它会先核对官方说明和前置条件，遇到凭证或占位符会停下来询问。
发给 Codex
自助接入 Playwright MCP
请帮我在当前电脑上接入并验证 Playwright MCP。
官方来源：https://github.com/microsoft/playwright-mcp
目标接入命令：codex mcp add playwright -- npx -y @playwright/mcp@latest
请按以下步骤执行：
1. 先阅读官方 README，核对当前推荐接入方式与上述命令。如果官方说明已经变化，先告诉我差异，不要盲目执行旧命令。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证，也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符，先列出需要我提供的值并停下来，不要自行猜测。
4. 条件满足后执行接入命令，再运行 codex mcp list，确认 Playwright MCP 已登记，并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接：请用 Playwright MCP 打开我的本地预览，检查首页、移动端菜单和搜索是否正常，只读并截图。
6. 不要创建、修改、删除、发送内容，也不要连接生产环境；需要写权限或更高权限时先征求我确认。- 复制完整指令，发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境；遇到 Token、项目 ID、路径或其他占位符时，应停下来向你确认。
- 接入后运行
codex mcp list，再用 Playwright MCP 的只读首测任务回读结果。
第一次调用示例
登记完成后，新开一个任务，先用下面这句做只读验证，把目标、范围和停止条件一次说清楚。
发给 Codex
第一次只读任务
请用 Playwright MCP 打开我的本地预览，检查首页、移动端菜单和搜索是否正常，只读并截图。怎样算成功
能看到目标 URL、关键元素和截图；没有把测试操作误当成真实发布。
- 先让工具读取页面结构和当前 URL。
- 执行一次点击或输入并保存截图。
- 检查控制台、网络或页面状态是否符合预期。
- 在新视口重复关键流程并回读结果。
权限与安全
凭证与连接方式
本地 stdio；首次建议使用独立测试浏览器，不需要把个人登录态带进去。
- 可读取浏览器中显示的页面内容
- 可代表用户点击、输入和跳转
- 不要连接含生产账号、支付或敏感会话的日常浏览器配置
