Agent Skills
返回列表
连接器修复

连接器修复

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 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 打不开浏览器,或网络/代理把发现阶段拦在外面。

技能如何排查与修复

技能按四步收敛根因,任一步命中即可进入对应修复,不必机械跑完全部流程。

  1. 日志定位:从 WorkBuddy 日志确认失败连接器名(如 connector:qq-mail)、目标 URL(如 https://api.mail.qq.com/mcp),以及是否已有 captureResourceMetadataUrl(OAuth 发现是否成功)。
  2. 网络排除:对 MCP 端点做可达性验证;若 HTTP 正常而客户端仍失败,说明问题在本地环境。
  3. 默认浏览器诊断(核心):检查当前用户 HKCU\Software\Microsoft\Windows\Shell\Associations\UrlAssociations\http\UserChoice 中的 ProgId,并验证 HKCR\<ProgId>\shell\open\command 指向的可执行文件是否仍存在——ProgId 仍指向已卸载浏览器是最常见根因。
  4. 确认可用浏览器:枚举本机仍安装的 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 向业务方说明根因并验收重连结果。