Agent Skill 核验档案

MCP Oauth Triage

mcp-oauth-triage 是一个面向 OAuth 故障排查的 MCP Skill：当一个曾经认证成功的 MCP 连接器如今失败（token 交换成功后工具调用仍 401、刷新后中断、返回其他账户数据），在改代码之前用 oauth_triage.py 对故障进行分类。它通过信封检查、过期检查、轮换检查、绑定检查、缓存检查五类检测器区分五种共享同一症状的故障类别，并给出主要类别、置信度、发现和下一步探查动作。

适用任务

收集令牌记录、连接器日志和时间三份工件并脱敏后运行分类器，确定 401 故障属于哪一类（信封不匹配、过期语义、轮换覆盖、绑定故障、污染负缓存）
在依赖升级或序列化器变更导致连接器中断后，用 --expect-flat 等参数验证读取方的期望，确认令牌存储层级是否错位
对工单或 CI 输出机器可读的 JSON 判定结果（--json），并用 --redact 在记录进入工单或聊天前脱敏
修复后按验证清单执行完整往返验证：调用在刷新前、一次刷新后、第二次刷新后都成功才算修复

输入

令牌记录：连接器回读的存储 JSON，按写入原样
连接器日志：带时间戳的有序事件（交换、存储、加载、调用、错误）
时间信息：成功调用后多久出现失败

输出

行式报告或 JSON 判定：primary_class、confidence、findings（类别、严重度、证据文本）、next_probe、exit_code
exit code：0 无缺陷信号、1 仅可疑发现、2 确认缺陷类别

限制与检查

exit 0 不是健康检查：仅表示所供工件未发现缺陷信号，不证明连接器正常
假设曾存在可工作状态并已丢失；首次设置故障不在范围内
分类器不进行网络调用，无法主动探测提供方
修复后分类器对修复后的记录 exit 0
记录持有单一绝对整数过期时间，或读取方显式接受相对 TTL
每个凭据只有一个刷新者，并发探查显示无并行交换
存储的 refresh token 与最近一次成功交换返回的一致
通过先前失败表面的调用在刷新前和刷新后都成功

MCP Oauth Triage

适用任务

输入

输出

限制与检查

搜索

项目详情