Playwright MCP
让 Claude Code 通过 Playwright 导航并检查真实网页。
webtesting
关于 Playwright MCP
Playwright MCP 通过 MCP 服务器把浏览器自动化工具提供给 Claude Code,允许代理检查页面并操作浏览器控件。适合验证网页流程或读取页面信息;浏览器配置和登录状态会影响它能够访问的内容。
- 浏览器导航与页面交互工具。
- 利用结构化浏览器信息检查页面。
- 可通过服务器选项配置浏览器行为。
如何安装
先打开来源文档,核对项目的前置条件与安装位置。复制以下命令,逐行运行;命令中的示例路径需要替换为自己的目录。
终端
claude mcp add --transport stdio playwright -- npx -y @playwright/mcp@latest按来源说明完成必要的认证或设置,重新加载会话后确认新能力可用。仓库内的项目可能共享同一个插件安装包。
开始使用
注册 MCP 服务并确认连接。先用公开测试页面和明确任务验证,再检查浏览器配置,决定是否用于已登录站点。
使用前留意
浏览器访问可能涉及已登录页面;请使用可信的浏览器配置。
这个服务给 Agent 什么能力
Playwright MCP 通过模型上下文协议提供浏览器操作能力。默认交互基于结构化可访问性快照,而非截图坐标。
- 连接与检查
- 在已安装 Node.js 18 或更新版本的终端执行上方命令,再到 Claude Code 的 MCP 服务列表确认 playwright 已连接。
- 首次任务
- 先让 Claude 打开 https://example.com 并报告标题和各级标题。核对返回的页面结构后,再尝试表单或需登录的网站。
浏览器访问范围与限制
- 浏览器资料
- 持久浏览器资料可能含 Cookie 和登录会话。应有意识地选择允许 MCP 服务访问的资料和页面。
- 来源限制
- 维护者明确说明 --allowed-origins 不是安全边界。它只能用于请求过滤,不能视为敏感页面的隔离措施。
- 快照可见性
- 可访问性快照适合语义化控件;Canvas 内容和纯视觉细节可能需要其他检查方式。
以上步骤根据维护者文档整理;本站未将来源核对当作运行环境实测。