1. Windows PowerShell 里给 Claude Code 装 MCPs 到底卡在哪如果你在 Windows 上用 PowerShell 跑 Claude Code想给它挂一个 MCPModel Context Protocol服务器大概率会经历一段非常迷惑的过程命令敲下去没报错但claude mcp list里就是Failed to connect或者干脆甩你一句/usr/bin/bash: Files\Git\bin\bash.exe: No such file or directory让人怀疑自己是不是装了个假的 Windows。这个问题的本质是 Claude Code 的 MCP 机制默认按 Unix 那套思路设计它习惯用npx、bash、/usr/bin/...这类路径去拉起子进程。而 Windows 的 Node 全局包路径长这样B:\nvm\v22.17.0\node_modules\...反斜杠、盘符、空格混在一起路径解析一旦出错MCP 进程就起不来。再叠加一个坑官方那个modelcontextprotocol/server-puppeteer包已经标记为不再维护Package no longer supported你就算路径配对也可能因为包本身被弃用而连不上。所以这篇就聚焦一件事在 Windows PowerShell 环境下把 Claude Code 的 MCPs 装好、调通并且把 endpoint 和鉴权统一改到 TaoToken 通道。我拿 Puppeteer 当例子因为它最典型——既涉及浏览器自动化这种重依赖又能用一次截图任务直接验证 MCP 到底有没有生效。适合谁看已经在 Windows 上用 Claude Code、想接 MCP 但被路径和连接问题劝退的人以及想把模型调用收敛到一个统一入口、不想每个工具各配一套 Key 的人。核心检索词先摆出来Claude Code 在 PowerShell 下安装 MCPs关键不是命令写得多花而是三件事——选对没被弃用的包、用完整 Node 路径注册、把模型通道指向 TaoToken。下面按可复制的步骤走。2. 前置准备Node 路径、TaoToken 通道与 settings 落点在动手注册 MCP 之前先把地基打好。很多人一上来就claude mcp add结果失败后完全不知道是哪一层的问题。我们分三块Node 环境、TaoToken 通道、以及 Claude Code 的 settings 文件位置。先说 Node。Claude Code 的 MCP 服务器基本都是 Node 包所以你得先确认 Node 装在哪、全局包目录是什么。在 PowerShell 里执行node -v npm root -gnpm root -g会告诉你全局包的绝对路径比如B:\nvm\v22.17.0\node_modules。这个路径后面注册 MCP 时要一字不差地用上。注意如果你用 nvm-windows 管理 Node 版本切换版本后这个路径会变所以每次换版本都要重新确认。再说 TaoToken 通道。TaoToken 提供统一的模型调用入口Claude Code 这类工具可以通过配置 Base URL 和 API Key把请求打到同一个通道上省得每个工具单独配。你需要先去控制台拿一个 API Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsoleAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys拿 Key 的时候注意两点一是别把 Key 直接写进会提交到 Git 的文件里二是记下你要用的 Model ID后面配置里要填。TaoToken 的 API 基址是https://taotoken.net/api这个地址不加 UTM 参数直接用于程序请求。然后是 Claude Code 的 settings 落点。Claude Code 的用户级配置一般在用户目录下的.claude.json或.claude/settings.jsonMCP 注册信息会写进mcpServers字段。你可以先用命令看当前状态claude mcp list如果这条命令本身都跑不起来说明 Claude Code CLI 没装好或没进 PATH先解决这个再往下。确认能跑之后我们进入正式配置。这里有个容易忽略的点Windows 下 Claude Code 读取配置时对路径里的反斜杠和空格很敏感。所以后面写 JSON 时反斜杠要转义成\\或者干脆用正斜杠/。我实测下来正斜杠在 Node 的require/import里也能正常解析能少踩很多转义的坑。最后提醒一句MCP 服务器是独立进程它和 Claude Code 主进程之间通过 stdio 通信。所以任何让子进程启动失败的路径问题、权限问题、包缺失问题都会表现为「连不上」。排查时永远先怀疑子进程有没有真的起来。3. 可复制配置puppeteer-mcp-server 注册与 settings 片段这一节是全文最核心的部分所有命令和配置都可以直接复制。我们分三步装包、注册、写 settings。第一步装一个还在维护的包。官方modelcontextprotocol/server-puppeteer已经弃用换成社区维护的puppeteer-mcp-servernpm install -g puppeteer-mcp-server装完确认路径npm list -g puppeteer-mcp-server输出大概长这样B:\nvm\v22.17.0 └── puppeteer-mcp-server0.7.2记住这个B:\nvm\v22.17.0\node_modules\puppeteer-mcp-server\dist\index.js它就是入口文件。第二步注册 MCP。这里有个大坑直接写包名会失败因为 Windows 下 Claude Code 解析npx/bash路径会出问题。错误写法会失败claude mcp add puppeteer -s user -- npx -y puppeteer-mcp-server claude mcp add puppeteer -s user -- puppeteer-mcp-server正确写法是用完整 Node 路径指向入口文件claude mcp add puppeteer -s user -- node B:\nvm\v22.17.0\node_modules\puppeteer-mcp-server\dist\index.js注意-s user表示用户级作用域对所有项目生效如果你只想在某个项目里用可以改成-s project。第三步写 settings 片段。注册命令会自动写入配置但如果你想手动改或检查.claude.json里的mcpServers应该长这样{ mcpServers: { puppeteer: { type: stdio, command: node, args: [ B:\\nvm\\v22.17.0\\node_modules\\puppeteer-mcp-server\\dist\\index.js ], env: {} } } }如果你更习惯用 TOML 风格的配置部分版本支持等价写法是[mcpServers.puppeteer] type stdio command node args [B:\\nvm\\v22.17.0\\node_modules\\puppeteer-mcp-server\\dist\\index.js]现在把模型通道改到 TaoToken。Claude Code 的模型配置通常在 settings 里指定 Base URL 和 API Key。你需要把 endpoint 指向https://taotoken.net/apiKey 用刚才在控制台拿到的。一个可参考的 settings 片段{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的_TaoToken_API_Key } }这里三件套要写全Base URL、Key、Model ID。Model ID 按你在 TaoToken 控制台选的模型填比如claude-sonnet-4-20250514这类。如果你用的是 Claude Code 的 coding plan 场景可以走这个入口了解https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan配置改完后重启 Claude Code 让 settings 生效。注意MCP 注册和模型通道是两套配置别混在一起改否则出问题很难定位。4. 验证请求用一次 Puppeteer 截图任务确认 MCP 生效配置写完不算完得验证。验证分两层先确认 MCP 连上了再确认 Puppeteer 工具真的能干活。第一层检查连接状态claude mcp list成功输出类似Checking MCP server health... puppeteer: node B:\nvm\v22.17.0\node_modules\puppeteer-mcp-server\dist\index.js - ✓ Connected看到✓ Connected就说明子进程起来了、stdio 通了。如果还是Failed to connect先别急着改配置用 debug 模式看详细错误claude --mcp-debugdebug 模式会把 MCP 服务器的 stderr 打出来路径错误、包缺失、权限问题都会现形。第二层实际调用 Puppeteer。在 Claude Code 会话里让它执行一个截图任务比如「打开 example.com 并截图保存到当前目录」。MCP 生效时Claude Code 会调用puppeteer_navigate和puppeteer_screenshot这两个工具。可用的工具包括puppeteer_navigate导航到指定网页puppeteer_screenshot截取当前屏幕puppeteer_click点击页面元素puppeteer_fill填写表单如果截图成功生成文件说明整条链路通了Claude Code → MCP 子进程 → Puppeteer → 浏览器 → 截图落盘。这一步同时验证了模型通道Claude Code 得先能正常对话才能发起工具调用和 MCP 通道。我试过在截图任务里加一个明确的文件名比如「保存为 test.png」这样验证时不用去猜文件在哪。如果任务跑完没生成文件先看 Claude Code 有没有报工具调用错误再看 Puppeteer 是不是缺 Chromium 依赖——puppeteer-mcp-server首次运行可能会下载浏览器网络不通就会卡住。验证模型通道是否走 TaoToken可以在 Claude Code 里发一条普通对话然后去 TaoToken 控制台看调用记录。如果记录里有对应的请求说明 endpoint 和 Key 都生效了。模型对话入口在这里可以对照https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentchat5. 本篇常见错排查401、local proxy failed 与 reading choices这一节把真实会撞到的报错列出来对照着改。报错一/usr/bin/bash: Files\Git\bin\bash.exe: No such file or directory这是最经典的 Windows 路径解析问题。Claude Code 试图用 bash 拉起 MCP但 Windows 上 Git Bash 的路径带空格Program Files解析就断了。解决方案就是本文第 3 节的做法不用npx/包名直接用完整node路径指向dist/index.js。报错二✗ Failed to connect连接失败可能原因有三个Node 路径写错、包没装成功、防火墙拦截。排查顺序先npm list -g puppeteer-mcp-server确认包在再确认args里的路径和npm root -g输出一致最后看防火墙有没有拦 Node 子进程。用claude --mcp-debug能看到具体 stderr。报错三401 Unauthorized这个通常出在模型通道不是 MCP。说明 TaoToken 的 API Key 没配对或者 Base URL 写错了。检查ANTHROPIC_BASE_URL是不是https://taotoken.net/apiKey 有没有多余空格。Key 去这里重新确认https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys报错四local proxy failed本地代理失败一般是网络层问题。检查系统代理设置、确认https://taotoken.net/api能通。如果你在公司网络里可能有出口限制换个网络环境试试。报错五reading choices相关错误这类错误通常出现在模型返回格式解析阶段说明请求发出去了但响应不符合预期。常见原因是 Model ID 填错或者通道返回了非预期结构。确认 Model ID 和 TaoToken 控制台里的一致别自己拼一个不存在的模型名。报错六EPERM: operation not permitted权限问题。以管理员身份运行 PowerShell或者检查目标目录的写入权限。全局包目录如果装在系统盘受保护位置普通用户可能写不进去。报错七OAuth 相关错误如果你在配置里用了需要 OAuth 的通道但没完成授权流程会报这个。Claude Code 的 OAuth 配置和 API Key 配置是两条路别混用。用 TaoToken 的话直接走 API Key 就行不需要额外 OAuth。排查通用原则先看claude mcp list确认 MCP 层再看普通对话确认模型层两层分开定位别一起改。6. 把 MCP 和模型通道都收敛到 TaoToken 的长期用法装好一个 Puppeteer MCP 只是开始。真正省事的做法是把所有 MCP 服务器和模型调用都收敛到同一套配置上这样换机器、换项目时不用重新折腾。其他 MCP 服务器的安装模式和 Puppeteer 一样核心都是「完整 Node 路径 入口文件」。比如文件系统操作npm install -g some-org/filesystem-mcp claude mcp add filesystem -s user -- node B:\nvm\v22.17.0\node_modules\some-org\filesystem-mcp\dist\index.js数据库连接npm install -g sqlite-mcp-server claude mcp add sqlite -s user -- node B:\nvm\v22.17.0\node_modules\sqlite-mcp-server\dist\index.js规律很清楚先npm install -g再npm root -g拿路径最后用完整路径注册。别偷懒用包名Windows 下十有八九会挂。模型通道这边TaoToken 的接入文档值得过一遍里面有不同工具的配置示例https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc如果你长期用 Claude Code 做编码或 Agent 任务Coding Plan 会比按量更划算入口在上面第 3 节给过。API 基址统一用https://taotoken.net/apiKey 在控制台管理Model ID 按需切换。几个我踩过的坑直接给你一是 nvm 切版本后一定要重新确认npm root -g路径变了 MCP 就连不上二是 settings 里的反斜杠要么转义要么换正斜杠别裸写三是 MCP 服务器别装太多每个都是独立进程装十几个会明显拖慢启动四是定期npm update -g更新依赖包弃用的包越早换越好。最后一步把配置备份成一份可复制的模板换机器时直接改路径就能用。这比每次重新查文档快得多。