Chrome DevTools MCP 教程:让 Codex/Claude 自动调试网页

AI 编程最大的盲点不是写不出代码——是它能改代码,却看不见代码在浏览器里到底跑成了什么样。

你让它修一个表单提交的 bug,它改了 API 调用、换了参数、加了 catch。然后呢?它不知道页面上弹了一个 500 错误,更不知道 CORS 被拦截了、控制台里堆了三行红色报错。

Chrome DevTools MCP 解决的就是这个问题。Chrome 官方出的。Apache-2.0 协议。Chrome 149 里已经标了「稳定」状态。

装完它,你的 Agent 能:打开真实 Chrome 页面、读控制台日志、检查网络请求、截桌面和移动端截图、模拟设备、录性能。从「猜 bug」到「看证据」,差距等于修一天和修五分钟。

一条命令装到 Codex

前提:Chrome 稳定版 + Node.js LTS + npm。然后:

PHP
codex mcp add chrome-devtools -- npx -y chrome-devtools-mcp@latest

这一条命令会自动在 Codex 的 config.toml 里写入 MCP 服务配置。参数建议:

PHP
[mcp_servers.chrome-devtools]
command = "npx"
args = ["-y", "chrome-devtools-mcp@latest"]
startup_timeout_sec = 30
tool_timeout_sec = 120

默认会启动独立的 Chrome 实例,和你日常用的浏览器互不干扰。只想做基础页面检查时加 --slim --headless,工具列表更精简、后台运行不弹窗。

对于 Claude Code 和 Cursor,配置方式类似——把上面的命令和参数照客户端 MCP 配置页填进去就行。

连接已登录的 Chrome——方便但危险

Chrome 144+ 支持 --autoConnect。先打开 chrome://inspect/#remote-debugging,允许远程调试,再在配置里加:

PHP
args = ["-y", "chrome-devtools-mcp@latest", "--autoConnect"]

Agent 会继承你当前浏览器的全部登录状态、Cookie 和页面。

这意味着如果你正登着银行、邮箱或后台管理面板,Agent 也看得见。不要用这个模式连主浏览器去测陌生网站。如果必须用登录态调试,单独开一个仅登测试账号的 Chrome 用户配置,和主浏览器一刀切。

五步调试流程:从只读到验证

别一上来就让 Agent 改代码。按照这个顺序:

  1. 启动本地开发服务器,给 Agent 一个明确的测试 URL
  2. 只读诊断:打开页面 → 收集控制台错误 → 列出失败的网络请求 → 截桌面和移动端截图
  3. 要求复现步骤和收集到的证据后,再允许改代码
  4. 改完代码后重新加载,用同一组操作重复验证
  5. 最后核对控制台清零了吗、失败请求修复了吗、核心流程跑通了吗、性能指标变了吗

一个好的起始指令长这样:

打开 http://localhost:3000,只做诊断:检查控制台错误、失败的网络请求和 390×844 视口下的布局。先返回证据和复现步骤,不要修改代码,不要提交表单。

这个指令的关键是「先返回证据,不要改代码」——它在训练你的 Agent 先观察再动手。

别忘了关遥测

项目 README 里写着:工具使用统计默认开启。如果你在内网、客户系统或敏感测试环境上跑,加一个参数关掉:

PHP
args = ["-y", "chrome-devtools-mcp@latest", "--no-usage-statistics"]

另外性能工具可能用公开页面的 URL 去请求 Google CrUX 数据——内网地址和敏感环境建议用隔离浏览器配置。

谁该装、什么时候别急着用

立马装,如果你:

  • 日常做前端或全栈开发,每次改完都手动打开浏览器检查
  • 用过 Codex/Claude/Cursor 修前端 bug,修完不确定页面上到底好了没有
  • 需要 Agent 做跨视口的响应式检查——桌面 + 移动端撸一遍

暂时别急,如果你:

  • 项目是纯后端或 CLI 工具,没有浏览器 UI
  • 只做小规模静态页面,手动 F5 刷新足够
  • 对 Chrome 远程调试机制不熟悉,怕把日常浏览器搞乱

看法

这个 MCP 是这一波「软件 MCP」(JetBrains、Chrome、终端等)里最值得日常开发者先装的一个。

原因很简单:它不卖概念,它解决一个真实到不能再真实的问题——你让 AI 改了前端代码,AI 不知道页面上到底发生了什么。 装上之后,你的 Agent 和真实浏览器之间不再隔着一堵墙。

装完先用只读模式跑三天。读懂控制台、抓到网络错误、截到移动端布局崩坏的证据——你再让它改,它给的建议会明显更准。

参考资料:Chrome 官方配置文档Chrome 149 DevTools 更新官方 GitHub 仓库

本文最后更新于2026年7月14日,若涉及的内容可能已经失效,直接留言反馈补链即可,我们会处理,谢谢
声明:本站所有内容均由互联网收集整理、网友上传,并且以计算机技术研究交流为目的,仅供大家参考、学习,请勿用于任何商业目的与商业用途,如需商用请支持正版!如亲下载后改变其用途与使用方式,与本站无任何关系,本站已经进行告知义务!我们只做安全认证测试如果资源侵犯了您的版权利益,请联系站长邮箱:17606723350@163.com