浏览 AI 知识库
Claude Desktop MCP 配置：核对配置文件、重启和连接状态
Claude Desktop 修改 MCP 配置后没有反应，先查 JSON 是否能解析、Server 是否启动、日志写在哪里，再决定是否重启。反复开关应用不会修复语法错误。
按实际操作顺序推进
每完成一段就检查当前输出，确认结果符合预期后再继续。
重启了几次都没变化，问题可能只是配置里多了一个逗号
修改 Claude Desktop 配置后界面没有任何变化。配置 JSON 实际多了尾随逗号，Server 启动即退出，但用户只反复重启应用。
- 配置备份和语法检查完成
- 客户端真正重启并加载
- Server 日志与工具状态一致
动手前，把材料和不能改的部分定下来
| 需要确认 | 本例内容 |
|---|---|
| 现有材料 | Claude Desktop 当前版本、操作系统、实际配置文件与 Server 命令；可查看客户端与 Server 日志。 |
| 不能越过的边界 | 配置位置和格式查当前官方文档；修改前备份；日志脱敏；先最小 Server 再添加参数。 |
| 要交付的结果 | 客户端状态与 Server 日志 |
Claude Desktop MCP 配置，从“确认系统与配置路径”开始做
确认系统与配置路径
按当前官方文档定位实际文件，记录应用版本和用户，避免编辑另一个账户或旧目录。
验证 JSON 与绝对路径
先通过结构化校验，命令与脚本路径在同一用户环境可运行，Windows 与 macOS 路径不混用。
处理环境变量
变量名称、来源和权限正确，敏感值不进入截图、版本库或共享配置。
完全重启并看状态
结束应用相关进程后重开，观察 Server 启动、退出码、stderr 和工具列表。
只读调用与回退
测试一个无副作用动作；失败时恢复备份并确认原配置可用。
JSON 有效，不代表应用读的是这份文件
| 层级 | 观察 | 证据 | 下一步 |
|---|---|---|---|
| 路径 | 编辑后工具没有变化 | 应用版本、用户和实际配置路径 | 退出应用后确认编辑的是当前账户文件 |
| 解析 | 启动日志显示配置错误 | JSON 校验错误位置 | 恢复备份，逐项修正括号、引号和逗号 |
| 进程 | Server 立即退出 | 退出码和 stderr | 在同一用户 Shell 手动运行命令 |
| 调用 | 工具出现但读取失败 | 工具参数、权限和资源错误 | 先读测试目录，检查环境变量和白名单 |
路径、版本和日志字段必须来自当前设备，不要用网上示例替代本机证据。
完成后的客户端状态与 Server 日志
备份后修正 JSON，完全退出并重开客户端；日志显示握手成功，工具列表出现。第一次调用读取教学文本；恢复备份也能撤销配置，不通过删除未知目录“清理”。
为什么“JSON 合法，Server 仍立即退出”还不能交付
JSON 合法，Server 仍立即退出
- 原因
- 命令在 GUI 环境缺少 Shell PATH 或工作目录
- 怎么改
- 用绝对可验证命令和明确 cwd 运行，比较终端与客户端环境变量