Claude Code 虽能完成代码编写、文件操作等任务但在浏览器自动化、数据库查询、GitHub 操作等场景中还需要借助外部工具扩展能力。MCPModel Context Protocol正是连接 Claude Code 与外部工具的协议。本文将介绍 MCP 作用、Server 选择、3 种配置方法及常见报错排查。一、Claude Code 为什么需要 MCPMCPModel Context Protocol是一套连接 AI 应用、外部工具和数据源的开放协议。Claude Code 本身可以完成代码编写、文件处理等任务而通过 MCP可以进一步接入浏览器、数据库、代码仓库等外部能力。从工作原理来看Claude Code 负责理解用户需求并判断是否需要调用外部工具MCP Server 则负责提供具体能力。收到调用请求后Server 执行对应操作再将结果返回给 Claude Code。通过这种方式不同工具可以按照统一的协议接入无需为每个工具单独建立连接机制。目前 MCP 常见的传输协议主要有两种stdio通过标准输入输出进行通信通常用于本地运行的 MCP ServerHTTP通过 HTTP 与远程 MCP Server 通信适合已经部署在服务器上的服务了解完MCP的传输协议后选择MCP Server可以根据实际提供的能力进行区分类型主要用途常见场景浏览器自动化控制浏览器网页访问、测试、自动化文件与本地资源处理指定资源文件处理、资料读取开发工具连接开发服务GitHub、Issue、代码协作数据查询连接数据服务数据查询、分析、检索因此选择 MCP 时不必盲目追求数量先明确需要扩展的能力再根据 Server 的功能和运行环境进行选择即可。二、Claude Code 配置 MCP 的 3 种常用方法方法一命令行添加 HTTP MCP ServerHTTP MCP Server 通常已经部署在远程环境中Claude Code 只需要连接对应的服务地址即可不需要在本地安装和启动 Server。对于新手来说这种方式配置步骤较少适合快速接入已经搭建好的 MCP 服务。在 Claude Code 中执行的基本命令如下claude mcp add --transport http 名称 MCP服务URL如果服务需要身份认证可以使用 --header 添加 Tokenclaude mcp add --transport http my-server https://example.com/mcp --header Authorization: Bearer YOUR_TOKEN添加完成后在 Claude Code 中输入 /mcp检查 Server 是否出现在列表中并确认连接状态。如果没有连接成功建议按照 MCP 地址、认证信息、网络连接、远程 Server 状态的顺序检查。先确认服务地址本身可以正常访问再排查 Claude Code 的配置问题可以避免反复修改命令。方法二命令行添加 stdio MCP Server如果 MCP Server 需要在本地运行可以使用 stdio 方式。Claude Code 会启动对应程序并通过标准输入输出与 Server 通信因此 npx、uvx、Node.js 和 Python 等本地工具都可以采用这种方式。先按照下面的格式添加 Serverclaude mcp add --transport stdio 名称 -- 启动命令 [参数]这里的 -- 用于区分 Claude Code 自身的参数和 MCP Server 的启动参数。配置时需要确保启动命令已经安装并且能够在当前终端环境中正常执行。以 Playwright MCP 为例可以直接执行claude mcp add --transport stdio playwright -- npx playwright/mcplatest配置完成后可以通过 /mcp 检查 Server 是否正常连接。如果像将Playwright MCP这类浏览器自动化工具进一步用于数据采集真正需要关注的不只是浏览器能否打开网页还包括目标站点的反爬机制。网站通常会结合请求频率、访问行为、Cookie 和会话状态、浏览器特征和网络出口等判断访问是否异常可能出现验证码、访问受限、页面加载失败等情况这些限制会直接影响采集效率和数据完整性更严重可能会导致账号被封。对于需要通过自动化数据采集的场景下可以在浏览器或运行环境中配置像IPFoxy的住宅代理相对于数据中心代理这类代理更接近正是用户网络的出口特征适合长期稳定的采集任务能够减少网络出口频繁变化造成的任务中断/访问异常降低触发反爬机制的概率。方法三通过 JSON 配置 MCP Server如果需要同时管理多个 MCP Server或者希望将配置纳入项目协作可以直接通过 JSON 文件进行管理。Claude Code 主要有两种配置范围项目级 .mcp.json 和用户级 ~/.claude.json。其中.mcp.json 适合团队协作配置可以随项目统一维护~/.claude.json 更适合个人使用可以在不同项目中复用自己的 MCP 配置。以下为项目级 .mcp.json 配置示例{mcpServers: {playwright: {type: stdio,command: npx,args: [playwright/mcplatest]}}}如果只希望个人全局使用可以在 ~/.claude.json 中配置{mcpServers: {playwright: {type: stdio,command: npx,args: [playwright/mcplatest]}}}两种配置的区别主要在作用范围项目级配置适合团队统一工具和环境用户级配置则适合个人长期使用。无论采用哪种方式完成配置后都可以通过 /mcp 检查 Server 是否被 Claude Code 正确识别。三、Claude Code 配置 MCP 失败常见问题及解决方法1. Windows 下出现 npx ENOENTENOENT 通常表示系统找不到指定的可执行文件。Windows 下 Claude Code 调用 npx 时如果 Node.js 未正确安装、PATH 未配置或者 Shell 没有获取到正确的环境变量就可能出现该错误。先在终端执行npx --version如果无法运行重新检查 Node.js、npm 安装及 PATH 配置如果终端能够正常运行但 Claude Code 仍报错则检查 Claude Code 使用的 Shell 和环境变量。必要时可以改用 node 直接启动 MCP Server绕过 npx 调用。2. 出现 uvx ENOENT与 npx ENOENT 类似该错误通常意味着 Claude Code 找不到 uvx 可执行文件常见原因是 uv 未安装或者安装目录没有加入系统 PATH。先执行uvx --version如果命令不存在安装 uv 并将其目录加入 PATH。修改环境变量后重新打开终端并重启 Claude Code再检查 MCP 是否能够正常启动。3. 显示 No MCP servers configured该提示通常意味着 Claude Code 没有读取到有效的 MCP Server 配置而不是 Server 连接失败。常见原因包括 Server 没有成功添加、配置文件位置错误或 JSON 格式存在问题。先确认 MCP Server 是否已经添加再检查 .mcp.json 或 ~/.claude.json 是否位于正确位置并核对 mcpServers、type、command、args 等字段。修改后重新启动 Claude Code并运行 /mcp 查看 Server 状态。如果是 Windows Playwright MCP还应重点检查 npx、Shell 和 stdio 通信。如果 npx 可以正常运行但 Server 仍无法启动可以尝试使用 Node.js 直接执行 Playwright MCP 的入口文件。总结Claude Code 配置 MCP 的核心并不在于记住命令而在于根据 Server 的运行方式选择合适的配置方案。远程服务优先使用 HTTP本地工具使用 stdio个人长期使用或团队协作则可以通过 JSON 文件管理配置。遇到运行异常时按照配置、依赖、Shell 环境、网络连接和 Server 状态的顺序逐项排查能够更快定位问题并完成修复。
企业数字化 ERP 产品动态
相关推荐
PostgreSQL 日报｜SSI 谓词锁缺陷（9 月 23 日） PostgreSQL 技术文章
文件上传后在 Neon 上运行任务
Neon Functions 现在支持直接由对象存储的上传事件触发，无需在应用层编写轮询或监听桶的代码。文件上传到桶中后，Function 会自动触发，处理后续的 Postgres 操作——例如向 files 表插入记… · 2026/9/24 16:23:53
Wand-Enhancer 上手记：一次本地补丁，免费解锁 WeMod 专业版 Wand-Enhancer 上手记：一次本地补丁，免费解锁 WeMod 专业版 【免费下载链接】Wand-Enhancer Advanced UX and interoperability extension for Wand (WeMod) app 项目地址: https://gitcode.com/GitHub_Trending/we/Wand-Enhancer
Wand-Enhancer … · 2026/9/24 16:23:47
FPGA与以太网（基本都能实现1Gbit/s就用LWIP实现最高效虽然达不到纯FPGA的效率） 一：
1.1：以太网数据帧（IEEE 802.3 标准规定） 1.2：千兆以太网：英文全称 Gigabit Ethernet，简称 GbE 或 1GE，是传输速率为 1 Gbit/s（1000 Mbit/s） 的以太网技… · 2026/9/24 16:23:28
Ansible Playbook 实战：批量配置 Linux 主机 前言
在云原生运维、服务器集群管理场景中，我们经常需要对多台 Linux 主机做统一初始化、基线配置、环境标准化。
如果采用手动逐台操作，会出现大量重复劳动，同时极易产生配置不一致、漏配置、配置错误等问题，后续集群运维、K8s 部… · 2026/9/24 17:34:11
快速上手 mongoose web 服务器：用 TaoToken 统一 Key 打通 RESTful 接口调试 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/24 17:34:11
Yarn 常驻TM 容器与常驻Flink 任务 常驻 TM 容器：是 YARN 层面的资源容器（进程）Yarn Session / Per-Job：是 Flink 跑在 YARN 上的两种部署模式，决定了 AM、TM 容器的生命周期两种模式下，只要流任务在持续运行，TM 容器就会常驻不退… · 2026/9/24 17:34:11
为什么 AI 写数据要先分级？R0-R5 工具风险模型 上一篇讲了「Runtime over Prompt：为什么 System Prompt 不是安全边界」——安全边界要落在 Tool 真正执行之前。这一篇往深一层：边界既然落在执行路径上，Runtime 凭什么判断一个 Tool 该不该放行？
AI 真正让企业犹豫的ÿ… · 2026/9/24 17:33:53
Unicode与UTF-8编码深度解析：rune、字节与国际化 Unicode与UTF-8编码深度解析：rune、字节与国际化为什么"hello"是5个字符，"你好"也是2个字符，但len("你好")却是6？为什么用range遍历字符串不会乱码，用下标访问却会？本文从Un… · 2026/9/24 17:33:47
基于YOLOv8的渔船作业监控系统：从环境搭建到边缘部署全流程 简介：这是一套面向计算机、人工智能、自动化等专业学生与教师的毕业设计级项目资源，围绕YOLOv8实现渔船作业监控系统，可用于毕设、课程设计、大作业或项目立项演示。压缩包共97个文件，约24.21MB，以70个Python源码文件为… · 2026/9/24 0:00:13
1D-CNN时间序列建模实战：从Conv1d原理到工业落地 简介：面向时间序列数据建模的一维卷积神经网络完整实现，适合深度学习入门者及需要快速验证时序模型的研究者，能够从音频、文本、传感器或股价等序列中挖掘局部特征与时间依赖。压缩包体积很小，只有3KB，内含3个Python脚… · 2026/9/24 0:00:26
柔软的L：汉语语流中被忽视的舌肌张力控制 1. 这个“L”不是字母表里的L，而是舌尖上的L最近在几个方言群和语音教学社群里，反复看到有人发一句：“也说字母L：柔软的长舌”。初看以为是英语发音课笔记，点开才发现全是方言爱好者、播音系学生、语言康复师甚至戏曲演… · 2026/9/24 0:00:44
