快速结论
先记录社区壳与内核版本，再区分服务可达、账号登录、授权完成和工具调用四个阶段；错误信息只保留脱敏内容。
- 模型 API Key 与 MCP 服务授权可能来自不同系统。
- v0.24.3 调整连接检查的凭据服务。
- v0.24.4 为预发布，包含 OAuth 错误与 WebView 登录相关调整。
本次更新：10 月 29 日复核：10 月 29 日：保存 MCP 后检查重载与重启提示。保留原网址及首次发布时间。
本教程依据社区发行说明整理，操作顺序属于本站编辑建议。它适用于排查 DSH Tauri，不代表官方 Harness 有相同界面或实现。
1. 先记录壳、内核与服务信息
记录应用版本、实际 dsh 内核版本、操作系统、MCP 服务地址与授权方式。不要在工单里粘贴 API Key、Cookie、授权码或登录回调的完整查询参数。模型能够回答，只说明模型连接可用，不能证明 MCP 服务的凭据有效。
2. 按失败阶段定位
| 阶段 | 观察什么 | 下一步 |
|---|---|---|
| 服务连接 | 是否能到达预期服务地址 | 核对地址和本机网络 |
| 登录页面 | 是否停在身份验证或访问控制页 | 确认登录的是正确服务账号 |
| 授权返回 | 是否完成回调并保存授权 | 记录脱敏错误、时间和版本 |
| 调用工具 | 列表能显示但执行是否失败 | 用一个允许的只读操作检查权限 |
3. 对照版本修复
v0.24.3将 credentials 服务注入连接检查。v0.24.4列出安全展示 MCP OAuth 失败信息、升级已安装辅助组件，以及将 Cloudflare Access 登录留在 WebView 的改动。v0.24.4 页面标记预发布，是否采用该渠道需要结合自己的问题决定。
如果升级后仍失败，把旧版与新版的现象并列记录，再到社区问题区反馈。不要反复清空全部配置来试错，先保留可恢复的配置记录。
4. 恢复后做一次小范围验证
重新连接后先读取一个允许访问的非敏感测试对象，检查返回是否来自预期服务。需要写入能力时，再确认范围和权限。一次连接检查通过不足以证明所有工具和账号权限都可用。
版本渠道可参考官方、社区与 Nightly 对照。
10 月 23 日：先检查配置是否完整保留
社区 v0.25.0 修复编辑或复制 MCP 服务时 !!js 值和隐藏字段保留。若问题恰好从编辑、复制或升级后开始，先用脱敏副本比较必要字段，再核对账号登录与授权回调。
配置保留修复不能证明所有 OAuth 故障都已解决。字段完整后，仍分别确认服务可达、授权完成和只读调用；操作步骤见配置升级教程。
10 月 29 日：保存 MCP 后检查重载与重启提示
PR #1272 描述保存后触发 profile 热重载；无法重载、失败或需要重启时，由面板报告。原始说明仍保留手动编辑配置的监听问题未定位、未在真实桌面实测的限制。
因此保存成功、凭据可用和实际工具调用继续分别验收，不能据热重载修复推断 OAuth 授权已自动完成。
参考资料
本文依据以下资料整理，版本与接口信息请以来源页面的现行说明为准。