连接器修复
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c00f577c/lianjieqixiufu。
技能介绍
问题背景
在 WorkBuddy 里接第三方 MCP 连接器时,OAuth 往往要由系统默认浏览器打开授权页。Windows 上若出现 streamableHttp connect failed: Failed to open: 找不到应用程序 (0x800401F5)、sse connect failed: SSE error: Non-200 status code (405),或界面提示授权超时、找不到应用程序,多数并不是 MCP 服务端本身坏了,而是本地 ShellExecute 打不开浏览器,或网络/代理把发现阶段拦在外面。
技能如何排查与修复
技能按四步收敛根因,任一步命中即可进入对应修复,不必机械跑完全部流程。
- 日志定位:从 WorkBuddy 日志确认失败连接器名(如
connector:qq-mail)、目标 URL(如https://api.mail.qq.com/mcp),以及是否已有captureResourceMetadataUrl(OAuth 发现是否成功)。 - 网络排除:对 MCP 端点做可达性验证;若 HTTP 正常而客户端仍失败,说明问题在本地环境。
- 默认浏览器诊断(核心):检查当前用户
HKCU\Software\Microsoft\Windows\Shell\Associations\UrlAssociations\http\UserChoice中的 ProgId,并验证HKCR\<ProgId>\shell\open\command指向的可执行文件是否仍存在——ProgId 仍指向已卸载浏览器是最常见根因。 - 确认可用浏览器:枚举本机仍安装的 Edge、Chrome 等,为覆写命令选目标路径。
修复侧优先推荐 HKCU 覆写 shell\open\command(无需管理员、仅当前用户),把失效的 ChromeCoreHTM、SogouExplorerHTML 等映射到仍存在的 msedge.exe 或 chrome.exe;验证注册表生效后让用户在 WorkBuddy 中重连,状态应变为 connected。方案 B 是引导用户在 Windows 设置 → 默认应用 → Web 浏览器 中正式改默认浏览器,适合作为 HKCU 修复后的长期收尾。
适用边界
- HKCU 方案只影响当前用户,不改动其他账户的全局注册表。
- 浏览器程序存在但仍失败时,需回到代理、防火墙或 DNS。
- 网络不通且非代理问题时,不要误把问题全部归因于 OAuth 浏览器链路。
使用场景
- 用户在 WorkBuddy 绑定 QQ 邮箱等 MCP 连接器时弹出 0x800401F5 或「找不到应用程序」,需要定位 connector 名并恢复 OAuth。
- 卸载 Chrome 或搜狗后默认浏览器 ProgId 仍指向旧路径,WorkBuddy 授权页打不开,需在 HKCU 覆写 http 打开命令。
- 日志里已有 captureResourceMetadataUrl,但 streamableHttp/SSE 仍失败,要先区分 MCP 网络可达性与本地浏览器问题。
- 内网用户反复出现「连接器授权超时」,支持人员需按四步流程读 WorkBuddy 日志并指导重连验证 connected。
适合人员
- 驻场或远程 IT 支持,接手 WorkBuddy 桌面端「连接器连不上」工单,需要可复述的标准诊断与修复步骤。
- 在本机调试 WorkBuddy 与第三方 MCP 的集成工程师,OAuth 卡在打开系统浏览器而非服务端返回错误。
- 曾批量卸载/更换浏览器的企业 Windows 用户,第三方连接器突然全部授权失败,需修默认 HTTP 关联而非重装客户端。
- 负责 WorkBuddy 连接器上线的实施同学,要用日志里的 connector 与目标 URL 向业务方说明根因并验收重连结果。