MCP · Windows

MCP 一直 failed 或 pending,应该查哪里?

MCP(模型上下文协议)错误可能发生在四个不同层级。只反复安装,通常无法知道哪一层真正失败。

更新于 2026-07-11 · 约 6 分钟

先看状态含义

  • failed:常见于启动命令、依赖、路径或进程退出。
  • pending:常见于授权未完成、网络握手未结束或应用仍在等待。
  • 已连接但无工具:可能是服务端能力、插件加载或权限范围问题。
风险提示不要把 OAuth(开放授权)链接、访问令牌、客户端密钥或完整环境变量发给陌生人。

四步验证法

  1. 进程:查看 MCP 日志,确认启动命令、工作目录和运行时是否正确。
  2. 传输:确认使用 stdio(标准输入输出)还是 HTTP,代理、防火墙与证书是否影响连接。
  3. 身份:用 self 或账户信息工具验证登录,只证明“是谁”,不证明资源可读。
  4. 资源:执行一次 search(搜索)和一次 fetch(读取),确认发现与读取链路都成功。

成功标志

  • MCP 状态不再 failed 或 pending。
  • 工具列表可见。
  • 真实资源能完成 search → fetch,而不是只返回账户信息。

需要提供哪些信息

产品版本、MCP 名称、状态、脱敏日志最后 30 行,以及是否使用代理。删除邮箱、Token、Cookie 和本机用户名后再提交。