Playwright MCP

它是什么

Playwright MCP 是 Microsoft 做的浏览器自动化 MCP 服务器。你的 AI 助手会得到一个真实的浏览器，可以在里面打开网页、点击、输入和读取内容。每个页面都以取自无障碍树（accessibility tree）的结构化文本交给模型。不用截图，也不用视觉模型。

1. 你让助手在某个页面上做一件事
2. 它用 browser_navigate 打开页面
3. browser_snapshot 以文本形式返回无障碍树
4. 它用 browser_click 和 browser_type 点击和输入

适合谁

工作离不开网页、又想让助手替自己点来点去的人。MCP 服务器适合一直开着浏览器的长时间循环，比如探索式测试，或者能自我修复的测试。对上下文吃紧的编程智能体，Microsoft 的 README 建议改用它另外提供的、带技能的 Playwright CLI，用的 Token 更少。

如果你从不跟网页打交道，就用不上它。

用在哪里

README 里给每个客户端都写了各自的配置方法。

• 编程智能体：Claude Code、Codex、Gemini CLI、Goose、Cline 和 opencode
• 编辑器：Cursor、装了 Copilot 的 VS Code 和 Windsurf
• 聊天应用：Claude Desktop
• 其他大多数 MCP 客户端：用下面的标准配置

如何设置

大多数客户端一行命令就能添加。

1. 用下面对应你客户端的那行命令添加这个服务器，或者把标准配置粘贴进它的 MCP 设置。
2. 先提一个小要求，比如问一个你熟悉的页面的标题，就能看到浏览器打开。

Claude Code 和 Codex 各用一行命令就能添加。

claude mcp add playwright npx @playwright/mcp@latest

codex mcp add playwright npx "@playwright/mcp@latest"

VS Code 用它自己的命令行添加。

code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'

其他大多数客户端读取标准配置。

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

如何使用

用平常的话说出你想要什么，助手会自己挑工具。默认会打开一个浏览器窗口，你可以看着它一步步做。

启动参数会改变浏览器的打开方式：

README 给这种干净会话的配置：

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--isolated",
        "--storage-state={path/to/storage.json}"
      ]
    }
  }
}

示例

你让 Claude Code 检查你预发布站点上的结账流程。

Open our staging site, add the blue mug to the cart, go to checkout and tell me whether the total includes tax.

浏览器窗口打开，马克杯加进购物车，结账页加载出来。助手根据它读到的页面作答，并引用页面上显示的商品明细和总价。你要截图，browser_take_screenshot 就会存一张。

新手与专家

新手：MCP 是一种给 AI 助手添加额外工具的标准方式。这个 MCP 服务器给它的是一个网页浏览器。你用平常的话说要做什么，助手就替你点击和输入，过程都在一个你能看着的窗口里。让它打开一个你熟悉的网站，告诉你页面上有什么。

专家：它通过 Playwright 驱动浏览器，交给模型的是无障碍树而不是像素，所以操作针对的是元素，不是屏幕坐标。这比基于视觉的循环更轻量，在不同布局下也更稳定。画在 canvas 上的页面比较难操作，--caps=vision 打开的坐标工具就是为此准备的。README 列出了 72 个工具，其中 25 个默认开启。

默认配置文件按工作区持久保存，所以每个工作区同一时间只能有一个客户端。想同时运行两个，就各用 --isolated 启动，或者各给一个单独的 --user-data-dir。无头浏览器一小时内没有工具调用就会关闭，有界面的浏览器则从不自动关闭，--idle-timeout 可以改变这一点。

注意事项

• 不是安全边界：Microsoft 明确这么说。你的电脑能访问的地方，这个浏览器都能访问。
• 会运行代码：有两个默认工具会运行代码。browser_evaluate 在页面里运行，browser_run_code_unsafe 在服务器进程里运行，README 说这等同于在你的电脑上运行任意代码。
• 文件：访问限制在工作区内，除非你加上 --allow-unrestricted-file-access
• 登录状态：你登录过的网站会一直保持登录，状态存在磁盘上的一个配置文件里

在 Windows 上，这个配置文件在这里：

%USERPROFILE%\AppData\Local\ms-playwright\mcp-{channel}-{workspace-hash}