第 3 课

接入编程智能体:MCP 配置、权限开关、Skills 与冒烟脚本

用官方命令把 MCP 服务器接进 Claude Code、Codex 或 Gemini CLI,用 MCP Inspector 列出 33 个工具并实际调用;用 --slim、配置文件和隐私开关收紧权限,装上 Skill,再写一个 CLI 加 jq 的冒烟脚本。

图文20 分钟Chrome DevTools MCP 官方文档 ↗

课程目录第 3 / 3 课

学习位置仅保存在当前浏览器,有效期 180 天。

01 / 图文教材

接入编程智能体:MCP 配置、权限开关、Skills 与冒烟脚本

本课对照 chrome-devtools-mcp 官方 README、Client configurations 与 Configuration 文档编写;命令与输出在 Debian 13 x86_64 测试机上实跑,版本 chrome-devtools-mcp 1.13.0、MCP Inspector 2.15.0(2026-11-16)。

本课目标

  • 把 chrome-devtools-mcp 接进 Claude Code、Codex 或 Gemini CLI
  • 不打开任何客户端,用 MCP Inspector 在终端里验证服务器能用
  • 用 --slim、配置文件和隐私相关开关控制智能体能做什么
  • 装上官方 Skills,再写一个能放进 CI 的冒烟脚本

前置条件

  • 做完第 1、2 课,示例网页服务还在 8811 端口运行
  • 至少装了一个支持 MCP 的客户端(只做验证步骤可以不装)
  • 第 6 步需要 jq

第 1 步:标准配置

官方 README 给出的通用配置如下。大多数 MCP 客户端都接受这种 JSON 格式:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest"]
    }
  }
}

用 @latest 可以让客户端每次启动都拿到最新版。和 CLI 不同,MCP 服务器只有在智能体第一次调用需要浏览器的工具时才会启动 Chrome,光连上服务器不会打开浏览器。

第 2 步:用各客户端的命令添加

以下命令照抄自官方 Client configurations 文档。Claude Code:

claude mcp add chrome-devtools --scope user \
  npx chrome-devtools-mcp@latest

Codex CLI:

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

Gemini CLI 用扩展安装,会同时装上 MCP 服务器和 Skills:

gemini extensions install --auto-update \
  https://github.com/ChromeDevTools/chrome-devtools-mcp

Claude Code 也可以装成插件,同样会带上 Skills。在 Claude Code 里依次输入:

/plugin marketplace add ChromeDevTools/chrome-devtools-mcp
/plugin install chrome-devtools-mcp@chrome-devtools-plugins

装好后,官方建议的第一句提示词是:

Check the performance of https://developers.chrome.com

智能体应当自己打开浏览器并录一段性能 trace,也就是上一课第 5 步做的事。本课测试机没有登录这些客户端,以上命令没有在客户端内实测。

第 3 步:用 MCP Inspector 验证服务器

不想先装客户端时,可以用 MCP 官方的 Inspector 在命令行里直接调用 MCP 服务器。先列出全部工具:

npx -y @modelcontextprotocol/inspector --cli \
  npx -y chrome-devtools-mcp@latest --headless \
  --method tools/list | jq ".tools | length"
33

默认开启 33 个工具,涵盖输入、导航、模拟、性能、网络、调试和内存几类。再真正调用一个,让它打开示例网页。jq -r 只取出结果里的文字部分:

npx -y @modelcontextprotocol/inspector --cli \
  npx -y chrome-devtools-mcp@latest --headless --isolated \
  --method tools/call --tool-name new_page \
  --tool-arg url=http://127.0.0.1:8811/ \
  | jq -r ".content[0].text"
## Pages
1: about:blank
2: Demo Shop (http://127.0.0.1:8811/) [selected]

智能体收到的就是这样的结果,服务器的启动提示写在 stderr 里,不会混进去。注意两点:

  • MCP 模式默认有界面,没有图形界面的机器要加 --headless;CLI 模式则默认无头
  • MCP 模式默认使用固定的用户目录 ~/.cache/chrome-devtools-mcp/chrome-profile,Cookie 和页面会保留到下次。测试机上去掉 --isolated 连跑两次,第二次的页面列表里多出了上一次打开的页面。想每次都从干净状态开始就加 --isolated

第 4 步:用 --slim 和配置文件收紧工具

只需要打开网页、执行脚本和截图时,加 --slim 只暴露 3 个精简工具,智能体的上下文更省:

npx -y @modelcontextprotocol/inspector --cli \
  npx -y chrome-devtools-mcp@latest --headless --slim \
  --method tools/list | jq -c "[.tools[].name]"
["evaluate","navigate","screenshot"]

参数多了可以写进配置文件,键名用驼峰写法。新建 cdm.json:

{
  "headless": true,
  "slim": true,
  "usageStatistics": false
}

用 --config 指定它。Inspector 自己也有 --config 参数,所以要用 -- 把服务器命令隔开:

npx -y @modelcontextprotocol/inspector --cli \
  --method tools/list -- \
  npx -y chrome-devtools-mcp@latest --config ./cdm.json \
  | jq -c "[.tools[].name]"
["evaluate","navigate","screenshot"]

不传 --config 时,Linux 和 macOS 会读 ~/.config/cd4a/config.json。几个与权限相关的开关值得记住:

开关作用
--isolated用临时用户目录,关闭浏览器后自动清理
--no-usage-statistics不上报使用统计
--no-performance-crux不把 trace 网址发给 CrUX
--no-javascript-evaluation禁止在页面里执行脚本
--workspace限制截图等文件工具能写的目录
--blocked-url-pattern禁止访问匹配的网址

官方 README 提醒:MCP 客户端能看到并修改这个浏览器里的一切数据,不要在里面登录不想给智能体看的账号。

第 5 步:安装 chrome-devtools-cli Skill

npm 包里自带 7 个 Skills,用插件安装时会一起装上。不支持插件的智能体可以手动复制,以 Claude Code 为例:

mkdir -p ~/.claude/skills
SKILLS="$(npm root -g)/chrome-devtools-mcp/skills"
cp -R "$SKILLS/chrome-devtools-cli" ~/.claude/skills/
cd ~/.claude/skills && find chrome-devtools-cli
chrome-devtools-cli
chrome-devtools-cli/references
chrome-devtools-cli/references/installation.md
chrome-devtools-cli/SKILL.md

执行完记得 cd - 回到 cdm-demo 目录。这个 Skill 教智能体用第 1、2 课的 chrome-devtools 命令写 shell 脚本。Skill 描述的是特定版本的工具,官方要求每次升级包之后重新复制一次。

第 6 步:写一个冒烟脚本

CLI 的每个工具都支持 --output-format=json,配合 jq 就能写断言。把下面的内容存为 smoke.sh:

#!/usr/bin/env bash
set -euo pipefail
URL="${1:-http://127.0.0.1:8811/}"
cdt() { chrome-devtools "$@" --output-format=json 2>/dev/null; }

chrome-devtools navigate_page 1 --url "$URL" > /dev/null 2>&1
errors=$(cdt list_console_messages 1 \
  | jq '[.consoleMessages[] | select(.type == "error")] | length')
failed=$(cdt list_network_requests 1 \
  | jq '[.networkRequests[] | select(.status >= "400")] | length')
chrome-devtools take_screenshot 1 --filePath smoke.png > /dev/null

echo "console errors: $errors, failed requests: $failed"
[ "$errors" -eq 0 ] && [ "$failed" -eq 0 ]

再准备一个故意出错的页面 broken.html:

cat > broken.html <<'HTML'
<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Broken</title></head>
<body>
<main><h1>Broken page</h1></main>
<script src="missing.js"></script>
<script>undefinedFunction();</script>
</body>
</html>
HTML

分别检查两个页面:

chmod +x smoke.sh
./smoke.sh; echo "exit=$?"
./smoke.sh http://127.0.0.1:8811/broken.html; echo "exit=$?"
console errors: 0, failed requests: 0
exit=0
console errors: 2, failed requests: 1
exit=1

健康页面退出码为 0,出错页面为 1,CI 可以直接据此判定失败。守护进程没在运行时,脚本第一条命令会自动把它拉起来。用完后收尾:

chrome-devtools stop
kill %1

kill %1 停掉第 1 课在后台起的网页服务。如果换了终端,就用 pkill -f "http.server 8811"。

常见坑

  • 服务器启动后客户端报超时:首次 npx 要下载包,Windows 上官方建议调大客户端的启动超时
  • 没有图形界面时浏览器起不来:MCP 模式默认有界面,加 --headless
  • Skill 让智能体调用了不存在的参数:升级包后忘了重新复制 Skill
  • Inspector 报 --config 不能和命令同用:在服务器命令前加 --

小结

一份标准 JSON 配置就能把 Chrome DevTools 交给任何 MCP 客户端,再用 Inspector 在终端里确认它真的能用。日常开发里,用 --slim、--isolated 和配置文件控制智能体的权限;在 CI 里,用 CLI 加 jq 写断言脚本。

参考来源

官方 docs 目录(本课用到其中的 client-configurations.md 和 configuration.md):

https://github.com/ChromeDevTools/chrome-devtools-mcp/tree/main/docs

https://github.com/modelcontextprotocol/inspector