第 3 课
接入编程智能体:MCP 配置、权限开关、Skills 与冒烟脚本
用官方命令把 MCP 服务器接进 Claude Code、Codex 或 Gemini CLI,用 MCP Inspector 列出 33 个工具并实际调用;用 --slim、配置文件和隐私开关收紧权限,装上 Skill,再写一个 CLI 加 jq 的冒烟脚本。
课程目录第 3 / 3 课
学习位置仅保存在当前浏览器,有效期 180 天。
接入编程智能体: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
