Claude Desktop 配置 MCP 教程：从安装到调用成功

Claude Desktop 配置 MCP 其实只需要改一个 JSON 文件：把 MCP server 的启动命令写进 claude_desktop_config.json，保存后完全重启客户端，输入框出现连接器图标就算成功。下面按官方文档（modelcontextprotocol.io）的流程走一遍，并补充国内环境最常见的几个坑。

配置前的两件事

• Claude Desktop：只支持 macOS 和 Windows，网页版无法加载本地 MCP server；从 claude.ai/download 获取最新版，旧版本对 MCP 的支持不完整。
• Node.js：官方文件系统 server 等大多数 MCP server 靠 Node 运行，终端执行 node --version 能出版本号即可，建议 LTS 版本。

claude_desktop_config.json 在哪里

这是整个配置的核心文件，位置因系统而异：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

不想手动找路径的话，打开客户端菜单栏的 Settings → Developer → Edit Config，点一下就会自动创建并打开这个文件。

两种 server 类型：stdio 与远程 HTTP

MCP server 按连接方式分两类，写法不一样：

• stdio（本地进程）：Claude Desktop 在你电脑上直接拉起一个子进程，通过标准输入输出通信。安全性好、不暴露网络端口，绝大多数场景用它。
• HTTP（远程服务）：server 部署在远端，客户端通过 URL 连接，适合团队共享或需要鉴权的云端服务，通常填一个 url 字段而不是 command 。

新手建议从 stdio 开始，配好后再考虑远程方案。

配置示例：官方文件系统 server

Windows 用户注意路径要用双反斜杠转义，否则 JSON 解析会出错：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\你的用户名\\Desktop",
        "C:\\Users\\你的用户名\\Downloads"
      ]
    }
  }
}

字段含义：mcpServers 是固定顶层键（注意是复数，写错一个字母整个文件失效）；filesystem 是你给 server 起的显示名；command 是启动命令；args 里的两个目录是授权 Claude 读写范围——server 只能访问列出来的目录，这是权限边界，别随手把整个磁盘丢进去。如果要加 API Key，用 env 字段注入环境变量，多个 server 就在 mcpServers 下并列多个条目。

完整操作步骤

常见报错排查

• 图标不出现 / server 没加载：九成是 JSON 语法问题（少逗号、路径没转义），先用在线校验工具过一遍；其次确认配置里全是绝对路径，相对路径无效。
• spawn npx ENOENT：Claude Desktop 找不到 Node，说明 npx 不在它继承的 PATH 里，Windows 下可先执行 npm install -g npm 全局安装，或在配置的 env 里手动补 PATH 。
• ENOENT: no such file or directory：args 里的目录不存在，先建好目录或改正路径。
• 日志文件：macOS 在 ~/Library/Logs/Claude，Windows 在 %APPDATA%\Claude\logs；mcp.log 记录连接过程，mcp-server-名字.log 是单个 server 的 stderr 输出，报错原因基本都能在里面找到。

配置逻辑摸清之后，进阶方向有两个：一是参考这份好用的 MCP 服务器推荐清单给 Claude 接上搜索、浏览器、数据库等能力；二是照着这篇 MCP Server 自己搭建教程把内部 API 封装成自己的 server，实现一次开发、所有 MCP 客户端复用。