MCP 已连接却不能用？按阶段排查 Mono 连接问题

MCP 服务器保存成功，并不代表工具能用。地址可能是对的，但登录还没完成；登录可能成功了，但服务器的工具没能加载；工具也可能加载了，却仍然收到错误的请求。改任何设置之前，先找出第一个出问题的环节。

本文介绍 Reunified 的 Mono 中的故障排查。Mono 还没有正式推出（可以加入候补名单）。如果是第一次连接，请使用 MCP 配置指南。这里的目标是把含糊的“不能用”变成一个清楚、可重复的观察结果，同时避免意外重复写入操作。

1. 记录现象，停止结果不明的重试

记下服务器名称、传输方式、设备、应用版本、你想做的事以及确切的错误信息，去掉其中的机密内容。注明同样的设置以前是否能用，以及之后改了什么。“登录后工具列表是空的”比“MCP 坏了”有用得多。

如果上一次请求可能会创建、发送或更新内容，重试前先检查目标位置。响应丢失并不代表操作没有发生。排查时改用一个只读的小请求，比如列出一个你能核对的测试项目中的某一项。

私下保存一份最后能用的设置。不要把令牌、授权码或工具的私密输出贴到公开的求助帖里。

Mono 的 HTTP 连接需要的是 MCP 服务器地址，而不是普通网站首页或模型 API 地址。把完整的 URL（包括路径）和服务器发布方当前的文档对照。网页能在浏览器里打开，只说明这个页面能访问，不代表 MCP 能在那里工作。

使用“标准输入/输出”（stdio）时，在需要启动它的设备上检查命令和参数。重新登录解决不了命令缺失或设备无法运行的问题。手机和电脑不一样，不要指望电脑上的命令能在手机上运行。

含有 localhost 的地址指向发出请求的那台设备本身。请从实际设备、通过受支持且已登录的途径测试。不要为了让测试通过而削弱正常服务器的访问控制。

检查你选的认证方式。“Bearer 令牌”需要在对应字段中填入该服务的正确令牌。OAuth 需要正确的账户、满足服务器的要求，并完整地回到 Mono；提前关掉浏览器不算登录成功。

Mono 可以在登录完成前就保存服务器，所以已保存的服务器并不能证明登录成功。即使登录成功，服务器的工具也可能有一段时间加载失败。无论是已保存的条目，还是“已连接到”的提示，都不能证明某个工具已经可用。

如果更改服务器 URL 或传输方式，Mono 会把它当作新的连接，因此你可能需要重新登录。地址确实写错就改正，但不要把反复修改一个能用的 URL 当作通用的重置手段。请按照发布方文档中的客户端和重定向设置操作，不要自己猜测数值。

MCP 架构区分了工具、资源和提示。服务器可能只提供其中一部分，所以只提供资源的服务器不会给助手任何可调用的工具。

对于已安装的 MCP 技能，打开它的“配置”部分，查看 Mono 找到了哪些工具。如果是空的，检查登录情况以及服务器是否列出了工具；不要以为服务的所有操作都能用。保存服务器并不是完整的健康检查。

也要检查聊天所用的模型。并非每个模型都能调用工具，你自己接入的一些模型也是如此。一个文字回答得很好的模型，仍可能是已连接的工具从未被使用的原因。自定义端点指南对此有说明。

用一个无害的请求，并把结果和原始服务对照：

text

读取我指定的现有演示条目的标题。
不要创建、编辑、发送或删除任何内容。
如果访问失败，请报告失败，不要猜测标题。

看到的情况	下一步检查
无法连接到地址	地址、传输方式、设备网络以及服务器是否在运行
登录无法完成	账户、认证方式以及发布方的 OAuth 要求
一个工具都没有出现	服务器提供什么、工具是否已加载、模型是否支持工具
某个工具失败	所需输入、服务端权限以及返回的错误
能读取，写入被阻止	你原本想给的访问范围和该工具的权限设置；不要全部放开

工具本身的错误，和一个空但成功的结果是两回事。把返回的状态和相关文字放在一起保存，并去掉机密信息。

每次只改一项，重复同样的只读测试并记录结果。如果之后需要写入，先确认确切的目标，并在服务中核实结果后再尝试下一次。

简短记下出问题的环节、版本、所做的更改以及最后一次成功的测试。在 Mono 中删除连接和在服务商那里撤销访问权限是两个独立的步骤。使用过程中的权限决定，请阅读工具权限审查指南；一次又一次地批准并不能修好连接。