Claude Desktop 安装 MCP：配置文件、重启和连接状态

Claude Desktop 配置后要确认应用实际重载

配置文件路径、JSON 语法、命令路径和环境变量最容易出错。修改前退出应用并备份配置，保存 Server 的 stderr 或日志，再看客户端连接状态。

确认系统与配置路径

按当前官方文档定位实际文件，记录应用版本和用户，避免编辑另一个账户或旧目录。

记录 Client、Server、配置位置、传输方式、认证范围、工具列表和一次真实调用结果。

验证 JSON 与绝对路径

先通过结构化校验，命令与脚本路径在同一用户环境可运行，Windows 与 macOS 路径不混用。

确认“验证 JSON 与绝对路径”已经有可回查结果，再进入“处理环境变量”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

处理环境变量

变量名称、来源和权限正确，敏感值不进入截图、版本库或共享配置。

确认“处理环境变量”已经有可回查结果，再进入“完全重启并看状态”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

完全重启并看状态

结束应用相关进程后重开，观察 Server 启动、退出码、stderr 和工具列表。

确认“完全重启并看状态”已经有可回查结果，再进入“只读调用与回退”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

只读调用与回退

测试一个无副作用动作；失败时恢复备份并确认原配置可用。

先用只读、小范围请求验证连接；涉及写入、删除、付款或外发时必须重新确认对象与权限。 完成后把证据归入“客户端状态与 Server 日志”。

记录客户端状态与 Server 日志

“工具没出现”只是症状。配置解析、进程启动、工具发现和调用应分别有结果，便于定位失败层。