MCP 扩展
验证 MCP 是否生效
验证 MCP 要依次确认进程能启动、客户端能发现工具、最小调用能返回、结果与真实外部状态一致。
提示：先确认当前使用的客户端、配置来源和权限范围，再按本文步骤操作。验证 MCP 是否生效完成后仍要用最小任务验证。
01.
先理解这项 MCP 能力
确认进程、工具列表、最小调用和返回结果。
验证 MCP 要依次确认进程能启动、客户端能发现工具、最小调用能返回、结果与真实外部状态一致。
检查启动日志
确认没有命令不存在、端口冲突、配置解析或缺少环境变量等错误。
检查工具是否被发现
在客户端中查看 Server 与工具列表，核对名称是否来自刚添加的配置。
执行只读最小调用
选择不会写入外部系统的工具，提供最少参数并保存原始返回。
这一节的目标：先确认要解决的问题、当前客户端和配置来源，再开始修改。
02.
接入前的准备
开始前把环境、材料和权限边界列清楚，可以避免把安装问题、配置问题和服务端问题混在一起。
- 确认 MCP Server 来源和维护状态
- 列出外部系统、认证与最小权限
- 先选择一个只读工具用于验证
03.
四步完成接入
- 1
检查启动日志
确认没有命令不存在、端口冲突、配置解析或缺少环境变量等错误。
- 2
检查工具是否被发现
在客户端中查看 Server 与工具列表，核对名称是否来自刚添加的配置。
- 3
执行只读最小调用
选择不会写入外部系统的工具，提供最少参数并保存原始返回。
- 4
对照真实状态
用原系统、文件或接口结果核对 MCP 返回，确认不是缓存、示例数据或权限过滤。
04.
怎样确认 MCP 生效
不要把“已经保存”或“没有弹窗”当成成功。至少确认下面三项都有可观察结果。
- 启动日志无关键错误
- 目标工具在客户端中可见
- 只读调用结果与真实状态一致
验证原则：先做只读、最小、可重复的检查，再把同一配置用于真实任务。
05.
常见问题与权限边界
Server 显示在线但调用失败怎么办？
继续检查工具参数、外部认证、资源权限和网络，不要只重启客户端。
为什么换项目后 MCP 不见了？
配置可能只写在项目范围，需要确认安装位置和客户端当前打开的目录。
06.
继续添加可控能力
把当前方法压缩成四个动作，完成后再进入相邻教程，不必一次改动所有配置。
- 1检查启动日志确认没有命令不存在、端口冲突、配置解析或缺少环境变量等错误。
- 2检查工具是否被发现在客户端中查看 Server 与工具列表，核对名称是否来自刚添加的配置。
- 3执行只读最小调用选择不会写入外部系统的工具，提供最少参数并保存原始返回。
- 4对照真实状态用原系统、文件或接口结果核对 MCP 返回，确认不是缓存、示例数据或权限过滤。