企业官网建设流程全解析

1. Windows 下 Claude Code 接 Playwright-MCP 调用本机 Edge 到底解决什么问题

如果你在 Windows 上用 Claude Code，想让它帮你做浏览器自动化——打开网页、点击按钮、截图、填表单——大概率会碰到 Playwright-MCP 这个工具。它的默认行为是自动下载一套独立的 Chromium 内核，体积 200MB 起步，国内网络环境下经常卡在下载环节，或者下到一半超时失败。更让人头疼的是，即使下载成功，你本机明明已经装了 Microsoft Edge，却还要多跑一个浏览器内核，磁盘和内存都白占。

这套方案的核心思路很直接：让 Playwright-MCP 跳过自带 Chromium 的下载，直接调用你 Windows 上已经安装好的 Edge。配置的关键就一个参数--executable-path，指向msedge.exe的完整路径。配好之后，Claude Code 通过 MCP 协议驱动 Edge 完成自动化操作，不再碰 Playwright 的浏览器二进制包。

适合谁看：已经在 Windows 10/11 上装了 Node.js LTS 和 Claude Code CLI，想用 MCP 做浏览器自动化但被 Chromium 下载卡住的开发者；或者你本机 Edge 用得好好的，不想再装一套浏览器内核的人。整条链路从环境确认、全局安装、MCP 配置、验证请求到报错排查，下面一步步走完。

需要说明的是，这个方案每次启动的是全新空白 Edge 实例，不会复用你日常 Edge 的登录账号和 Cookie。如果你需要带登录态操作，文末会给出 CDP 调试端口模式的拓展方案。

2. 前置准备：TaoToken 与 Windows 环境确认

在开始配 MCP 之前，先把两件事搞定：一是 Claude Code 能正常跑起来，二是模型调用通道稳定。我这边一直用 TaoToken 作为 Claude Code 的接入通道，它的 API 地址是https://taotoken.net/api，官网在https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=。如果你还没配好 Claude Code 的模型通道，先去控制台拿一个 API Key，再按接入文档把环境变量或配置文件写好。

2.1 确认 Node.js、npm、Claude Code 版本

打开 PowerShell，依次执行下面三条命令，每条都要有正常版本号输出才算就绪：

node -v npm -v claude --version

如果claude提示「不是内部或外部命令」，说明 Claude Code CLI 没装或者没进 PATH。先装 Node.js LTS，安装完重启终端再试。Node 版本建议 18 以上，npm 跟着 Node 一起装好就行。

2.2 设置国内 npm 镜像源

Playwright-MCP 是 npm 包，国内直连官方源经常慢到超时。先把镜像源切到 npmmirror：

npm config set registry https://registry.npmmirror.com

设置完可以用npm config get registry确认一下，输出应该是https://registry.npmmirror.com/。这一步能明显减少后面全局安装时的等待时间。

2.3 确认本机 Edge 路径

大多数 Windows 10/11 的 Edge 装在默认位置：

C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe

如果你的 Edge 不在这个路径，右键桌面 Edge 快捷方式 → 属性 → 复制「目标」里的完整路径。注意路径里可能带引号，复制时把引号去掉，只保留C:\...\msedge.exe这一段。后面配置 MCP 时要用到这个路径，先记下来。

3. 可复制配置：全局安装 Playwright-MCP 并指定 Edge

这一章是整篇的核心操作区。Windows 下用npx @playwright/mcp@latest动态拉取，很容易出现网络卡死、进程闪退、参数解析异常。所以优先全局安装，把 MCP 服务本体固定下来。

3.1 全局安装 @playwright/mcp

npm install -g @playwright/mcp

装完之后验证全局命令是否可用：

playwright-mcp

正常的话会输出 MCP 服务的启动信息，然后停在那里等待连接。按Ctrl + C终止即可。如果这条命令报「不是内部或外部命令」，说明全局 bin 目录没进 PATH，重新装一遍 Node 或者手动把 npm 全局路径加到系统 PATH。

3.2 清除旧的错误 MCP 配置

如果你之前配过 playwright 相关的 MCP，先删掉旧的，避免参数冲突：

claude mcp remove playwright --scope user

如果提示没有这个配置，忽略即可，说明本来就没配过。

3.3 用命令行添加 MCP 配置（推荐）

命令行方式比手改 JSON 稳，不容易写错层级和转义。执行：

claude mcp add playwright --scope user -- playwright-mcp --executable-path "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"

这里几个点要注意：--scope user表示全局用户级配置，对所有项目生效；--后面的内容是传给 MCP 服务的实际命令和参数；--executable-path后面跟 Edge 的完整路径，路径带空格所以用双引号包起来。这条命令执行完，Claude Code 的配置文件里就会多出 playwright 这个 MCP 服务。

3.4 查看 MCP 连接状态

claude mcp list

成功的话输出里会包含 playwright，状态显示✔ Connected，并且能看到 args 里带了 Edge 路径。如果显示红叉或者-32000: MCP error connection closed，先别慌，往下看第 5 章的排查。

注意：claude mcp list的探测机制在 Windows 上偶尔会误报，短暂显示红叉但实际会话里工具能正常加载。最终以 Claude Code 会话内是否出现mcp__playwright__工具为准。

3.5 手动改 .claude.json 的备选方案

命令行方式搞不定时，可以手动改配置文件。关键点：mcpServers必须放在 JSON 根节点，和projects同级，不要嵌套进projects对象内部。嵌套进去只对单个项目生效，容易让人以为配置没生效。

{ "mcpServers": { "playwright": { "command": "playwright-mcp", "args": [ "--executable-path", "C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe" ] } } }

Windows 下 JSON 路径的反斜杠必须写成双反斜杠\\，否则解析会出错。改完保存，把所有 Claude Code 终端关掉，重新开 PowerShell 再启动。

4. 验证请求：从工具加载到 Edge 自动化跑通

配置写完不算完，得实际跑一遍确认链路通了。新开一个 PowerShell 窗口，启动 Claude Code 会话：

claude

进去之后先关掉 auto 自动模式，防止 AI 自己写 Node 脚本绕过 MCP 工具：

auto off

4.1 测试一：确认 MCP 工具加载成功

在会话里让它列出所有可用工具。输出里应该出现大量mcp__playwright__开头的工具，比如browser_navigate、browser_click、browser_take_screenshot。看到这些就说明 MCP 加载完成，Edge 路径参数也生效了。

4.2 测试二：完整浏览器自动化

给 Claude Code 下一条完整指令，比如：

调用 playwright mcp 工具，打开浏览器访问百度，搜索"MCP协议"，完成后截图保存到桌面

预期现象：直接唤起本机 Edge 浏览器窗口，不会触发 Chromium 下载；自动访问百度、输入关键词、执行搜索；截图输出到桌面并返回文件路径。整个过程你能看到 Edge 窗口被自动操作，这就是 MCP 在驱动本机 Edge 的直接证据。

4.3 测试三：简单访问截图

再跑一条更简单的验证：

访问 https://www.bing.com，截图保存到桌面

如果这条也能正常出图，说明导航和截图两个基础能力都通了。到这一步，Windows 下 Claude Code 通过 Playwright-MCP 调用本机 Edge 的完整链路就算跑通了。

5. 本篇常见错排查：-32000、Chromium 下载、Token 超限

配 MCP 的过程里，下面几个报错出现频率最高，逐个说清楚原因和处理方式。

5.1 -32000: MCP error connection closed

这是最典型的连接报错，原因通常有三个：@playwright/mcp全局包没装好；PowerShell 命令参数复制不完整；Node 没加入系统 PATH。处理方式是按顺序重来一遍：

npm install -g @playwright/mcp claude mcp remove playwright --scope user claude mcp add playwright --scope user -- playwright-mcp --executable-path "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"

重装后如果还报，检查playwright-mcp这个命令能不能在 PowerShell 里单独跑起来。跑不起来就是 PATH 问题，跟 MCP 配置无关。

5.2 仍然尝试下载 Playwright 自带 Chromium

说明 MCP 配置里没带上--executable-path，或者参数写错了没生效。先删旧配置，再重新执行完整的 add 命令，然后用claude mcp list确认 args 里确实包含 Edge 路径。只要这个参数在，程序就不会去用 Playwright 自带的浏览器目录。

5.3 number of input tokens has exceeded max_prompt_tokens

会话历史累积太多，token 超限了。最简单的处理：关掉当前 PowerShell，新开一个窗口重新运行claude。旧会话没法修复，只能重开。如果经常碰到，说明单次任务太重，拆成多个小任务分别跑。

5.4 AI 自己写 JS 脚本，没有调用 MCP 工具

这是 auto 模式在作怪，AI 觉得写脚本更快就绕过了 MCP。会话里执行auto off关掉自动模式，强制它优先调用 MCP 工具。关掉之后，它就会老老实实走mcp__playwright__那套工具链。

5.5 残留文件清理说明

@playwright/mcp全局 npm 包要保留，它是 MCP 服务本体，别卸载。npx 运行产生的临时文件执行完自动销毁，无残留。ms-playwright文件夹里只有空占位文件，没下载浏览器，可以直接删；只要配置带了--executable-path，程序不会用这个目录。claude mcp remove只删 JSON 配置，不会卸载 npm 包。

6. 需要登录态？CDP 调试端口模式与后续接入

上面这套方案每次启动的是全新空白 Edge 实例，没有登录状态。如果你要操作需要登录的站点，得改用 CDP 调试端口模式，复用你手动登录后的 Edge 会话。

先用 PowerShell 手动启动带调试端口的 Edge，这个窗口不要关：

& "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --remote-debugging-port=9222 --user-data-dir="$env:TEMP\edge_mcp_profile"

运行后会弹出一个独立 Edge 窗口，你可以手动登录需要的账号。然后改 MCP 配置，让它连这个调试端口：

claude mcp remove playwright --scope user claude mcp add playwright --scope user -- playwright-mcp --cdp-endpoint http://127.0.0.1:9222

使用限制要记牢：每次用之前必须先执行上面那条启动 Edge 的命令；Edge 窗口一关，MCP 立刻断开。这个模式适合需要登录态的自动化场景，日常不需要登录态的话，还是用--executable-path那套更省事。

如果你还没配好 Claude Code 的模型通道，建议先去 TaoToken 控制台拿 API Key，再按接入文档把环境配好，这样 MCP 配完就能直接跑。需要长期做编码和 Agent 任务的，可以看看 Coding Plan，模型对话调试则用模型对话页面。整条链路配下来，Windows 下 Claude Code 驱动本机 Edge 做自动化就不再被 Chromium 下载卡住了。