快速结论
先记录社区壳与内核版本，再区分服务可达、账号登录、授权完成和工具调用四个阶段；错误信息只保留脱敏内容。
- 模型 API Key 与 MCP 服务授权可能来自不同系统。
- v0.24.3 调整连接检查的凭据服务。
- v0.24.4 为预发布，包含 OAuth 错误与 WebView 登录相关调整。
本次更新：10 月 19 日核对一手来源后新增；原始消息日期及适用范围在正文标明。
本教程依据社区发行说明整理，操作顺序属于本站编辑建议。它适用于排查 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 对照。
参考资料
本文依据以下资料整理，版本与接口信息请以来源页面的现行说明为准。
阅读至此返回学习中心