前言¶
接了十几个 MCP 连接器之后,最容易出问题的不是”连不上”,而是”悄悄断”:乐享、腾讯文档、QQ 邮箱、小红书、GitHub,某天调用返回 401,你才想起凭证是半年前授权的。逐个客户端翻配置、挨个试连通性,是一件重复但没技术含量的活。连接器状态管家把这件事压缩成一次盘点:列出当前已连的平台,显示在线/离线,检查凭证是否临近过期,对离线或过期项给出重连与重授权步骤。全程只读,不修改任何配置。
这是什么¶
连接器状态管家(@user_af163eaa/z-connector-health,版本 1.0.0)是一个面向智能体开发者的诊断类 Skill,由社区开发者 user_af163eaa 发布维护,托管在 SkillHub 的 ai-agent 分类下。它解决的问题是:当你或用户问出”现在连了哪些平台”“连接正常吗”“凭证是不是快过期了”这类问题时,Agent 需要一份结构化的、可执行的连通性与凭证状态清单,而不是让用户自己去每个平台的后台确认。
它不负责创建连接,也不负责修复连接。定位是只读诊断工具。
核心功能¶
1、一键盘点当前已连的连接器/MCP,覆盖乐享、腾讯文档、QQ 邮箱、小红书、GitHub 等常见平台,输出清单而不是散文。
2、逐项显示在线/离线状态,把”连着但没通”和”根本没连”区分开。
3、检查各连接器凭证是否临近过期、是否需要重新登录。
4、对离线项和过期项给出重连与重授权的可执行步骤,而不是只说”请重新授权”。
5、只读诊断:不写入配置、不重写连接、不替你点击授权按钮。这一点对排查类工具很重要,避免了诊断动作本身改变现场。
安装与启用¶
官方页面未提供独立的安装命令,只给出 SkillHub 坐标:
@user_af163eaa/z-connector-health
在 SkillHub 页面上可以直接获取该 Skill。若你的客户端支持手动放置,按其 Skills 目录规范放入该 Skill 的 SKILL.md 即可;各客户端的目录路径不一致,以你自己使用的客户端文档为准。
官方标注的标签为 requires_api_key=false,即调用该 Skill 本身不需要额外申请 API Key——它只是读取你已有连接器的状态。
典型用法¶
触发场景是自然语言提问,不需要记参数:
连接器状态
看看连了啥
连接正常吗
MCP在线吗
连接器体检
凭证过期检查
哪些平台连着
连接诊断
在 Agent 对话中直接说”帮我做个连接器体检”,它会返回当前已连平台的在线状态与凭证状态,并对需要处理的项给出下一步操作指引。
适用场景与注意¶
适合谁:在 Cursor、Claude Code 或其他支持 MCP/连接器的 Agent 客户端里接了多个第三方平台(文档、邮箱、社交、代码托管)的开发者;以及配置由多人维护、凭证归属不清晰的团队。
需要留意的几点:
1、诊断结果取决于 Agent 运行时实际暴露的连接器列表。如果某个连接器根本没有注册进当前会话,它不会出现在清单里——不是它坏了,是你还没连。
2、它给的是重连与重授权步骤,不是自动修复。授权动作涉及各平台登录页,仍需人工完成。
3、凭证”临近过期”的阈值由 Skill 自身逻辑决定,官方资料未给出具体天数;如果某个凭证在你看来已经不可用但未被标记,按实际报错手动重连即可。
4、只读不等于无风险:它会发起连通性探测请求。处于严格出网策略下的环境,探测可能被网络层拦截,此时报出的离线需要结合网络日志判断,而不是急着重新授权。
结尾¶
连接器一多,”连没连、通没通、凭证还有效多久”就从个人记忆问题变成环境状态问题。连接器状态管家用一次只读盘点回答这三点,并把需要人工介入的项单独列出来。官方地址:https://api.skillhub.cn/user_af163eaa/z-connector-health ,SkillHub 页面:https://www.skillhub.cn/skills/user_af163eaa/z-connector-health 。当前 SkillHub 显示评分 100000、下载 1174 次、安装 0 次。