Claude Desktop 接 MCP 实战：配置、排查与常用官方服务器清单
配置文件是第一道坎 接 MCP 最常见的挫败不是代码错，而是配了等于没配——工具列表里死活不出现，又没有报错。根因几乎都在那个 JSON 配置文件。Claude Desktop 的配置文件位置：macOS 在 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 在 %APPDATA%\Claude\claude_desktop_config.json。 一个最小可用的配置长这样（以官方 filesystem 服务器为例）： { "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/yourname/notes"] } } } 关键：command 和 args 分开写，路径写绝对路径，JSON 不能有注释、不能有多余逗号。配完必须完全退出 Claude Desktop 再重开——它只在启动时加载配置，热更新不生效，这是最多人栽的地方。 排查三步法 工具没出现时，按这个顺序查： 第一，看日志：Claude Desktop 日志在 macOS 的 ~/Library/Logs/Claude/，Windows 的 %APPDATA%\Claude\logs\。MCP 启动失败的报错（npx 找不到、路径不存在、Python 报错）都记在这里，别猜。第二，手动跑一遍命令：把配置里的 command + args 原样复制到终端执行，能跑通说明是环境问题，跑不通就是命令本身错。第三，确认 npx/node 版本：很多官方服务器是 Node 包，本机 Node 版本太低会静默失败，先 node -v 确认在 18 以上。 几个开箱即用的官方服务器 服务器 作用 适用场景 filesystem 读写指定目录文件 让助手整理笔记、改文档 fetch 抓取网页内容 让助手读指定 URL sqlite / postgres 查询数据库 自然语言查业务数据 git 读仓库状态、diff 代码助手看提交历史 配好之后，Claude 对话框里会出现小锤子图标，点进去就能看到加载成功的工具清单。VS Code 的 Copilot、Cursor 这类 IDE 也都支持 MCP，配置思路一致——都是告诉客户端「去哪里启动这个 server」。 ...