把配置里的 command、args 和环境变量抄到终端，看它是否立刻起来、是否在等交互输入。stdio 服务器不应打印横幅或进度条到标准输出，那些字节会破坏协议。
起来之后先做只读调用：列出工具、读一个无害资源。确认返回是结构化的，而不是整页 README。再试一个你准备批准的写操作，看失败时有没有清楚错误。
远程 HTTP 先用同一 URL 做一次握手。过期 OAuth、公司代理和错误的路径都会表现为超时。对照本站「调试 MCP 连接」和「传输方式」。
通过验收再写进项目配置。版本钉死，密钥放用户环境。不要把第一次成功的实验命令连同令牌一起提交。