# 跨连接找工具，并在发现失败后恢复

返回[首次成功统一入口](README.md)。

适用场景：你已连接多个 MCP Server，想按任务找工具、看参数；或某条连接的最近发现失败，但仍需要判断工具曾经有哪些。本文不演示执行真实业务工具。

## 授权前提、费用与数据去向

工具搜索和筛选只读取当前范围的本机安全缓存，不执行目标工具，通常不会产生服务商调用费用。“检查连接”和“重新发现工具”会联系对应 MCP Server，需要有效的 OAuth/API Key/本地进程权限，并可能计入服务商请求配额。

搜索关键词、安全 Schema 缓存和诊断摘要保留在本机 DSH profile；检查/重新发现时会向目标 MCP Server 发送协议请求。真正工具调用的参数与数据去向另由该工具和服务商决定，必须在首次调用前单独确认。

## 先定位正确的工具

1. 在 DSH 选中目标 Workspace，再打开“MCP连接器 → 工具”。未选 Workspace 时仅能看到全局连接；项目连接不会越界显示。
2. 输入工具名或描述中的关键词。精确工具名优先；同名结果仍需核对连接、服务和来源。
3. 使用“连接”“服务”“发现状态”筛选。若结果为空，先清除筛选，再确认连接已启用、范围正确且至少成功发现过一次。
4. 点击“参数详情”：先看类型、必填、枚举和可展开的嵌套摘要；复杂规则可打开“原始 Schema（安全缓存）”。它仍经过安全裁剪和容量限制，不是服务端完整原文。

工具页搜索的是**当前范围内已启用连接的最后成功安全缓存**，不是整个市场中未安装连接器的工具。搜索/筛选不请求目标服务，也不执行目标工具。

## 最近发现失败时怎么做

1. 看结果上的连接器/连接/服务来源、最近发现状态和“最后成功缓存时间”。超过 24 小时的缓存会标记陈旧；缓存能看不代表服务当前可调用。
2. 展开“连接状态与故障处理”，先阅读失败阶段、稳定 code 和建议。`状态未知` 不等于连接成功。
3. 根据建议使用“检查连接”或“重新发现工具”。前者检查单连接健康；后者重新获取该连接的工具元数据，二者都不是目标工具试运行，也不保证自动修复。
4. 若遇 429/限流，等待显示的重试时间，不要连续点击。工具页手动动作不能绕过有效限流；鉴权失败需更新凭据或重新授权。
5. 修复后再次观察发现状态与时间；最后再通过正常 DSH 会话调用一个获准的只读工具，确认真实业务路径。

后台发现最多并行处理两条连接。健康连接是**五分钟后到期**，不是精确每五分钟或永久实时轮询；普通失败指数退避，鉴权失败暂停自动重试。页面状态通知不等于持续健康探针。

## 可复现步骤与成功判据

1. 选择正确 Workspace，记录连接名、范围、预期工具名/关键词和开始时间。
2. 在“工具”页清空筛选后搜索，再依次加上连接、服务和发现状态筛选。预期：可解释结果是如何缩小的，且每条结果来源正确。
3. 打开参数详情，核对必填、类型、枚举和嵌套摘要。预期：能组成一个不含敏感数据的最小只读输入；缓存陈旧则先恢复。
4. 对异常连接先记录阶段/code/最后成功时间，再只执行页面建议的一个动作。预期：状态更新为当前时间，或给出可复核的稳定错误；不连续点击绕过限流。
5. 恢复发现后，回到正常 DSH 会话，经 Host 审批链执行最小只读调用。预期：得到与测试输入可辨认对应的结果，无写入、删除、发布或未批准付费。
6. 记录下表三层结果。只有调用层也通过才是“首次成功”；其余情况写“无数据/待验收”。

| 层次 | 你应看到什么 |
|---|---|
| 连接 | “已安装”中对应连接存在，范围与启停状态正确 |
| 发现/注册 | 工具页出现预期工具、来源和最近成功时间；必要时核对 Host 工具注册 |
| 调用 | 正常会话中通过 Host 审批链完成一个服务商许可的只读调用并得到预期结果 |

不要用缓存搜索结果代替调用验收，也不要在公开反馈中粘贴真实参数、结果或凭据。进一步诊断见[用户手册：工具工作台](../USER-GUIDE.md#51-工具工作台统一查找工具)。