AI Agent 接入MCP
MCP 故障排查
为 CrowScout MCP 预留的连接、认证、权限、数据、版本和撤销问题排查流程。
状态：通用框架。正式发布后应使用真实界面名称、错误代码、状态页和支持入口替换待填写内容。
Agent 找不到 CrowScout
依次确认：
- 当前客户端和版本位于经过验证的兼容列表；
- CrowScout MCP 已在正确的配置范围启用；
- 配置修改后是否需要重新加载或重启客户端；
- Server 地址或包来源与官方文档完全一致；
- 客户端日志中是否出现协议或启动错误。
不要为了排错把完整凭据复制到日志、截图或对话中。
认证失败
- 确认授权尚未过期或被撤销；
- 确认客户端使用的是当前连接，而不是旧的测试凭据；
- 检查系统时间和授权回调是否正常；
- 重新授权前先撤销无法识别的旧连接；
- 记录稳定错误代码和发生时间，再联系支持。
可以连接，但看不到 Product
- 检查该 Product 是否在连接允许范围内；
- 确认 Product 属于当前登录用户；
- 检查 Product 是否已归档、暂停或删除；
- 不要通过手动替换 Product ID 尝试绕过范围限制。
读取成功，但写入被拒绝
这通常表示连接只有只读权限、目标状态不允许当前动作，或 Agent 没有完成所需的用户确认。按配置与授权检查权限，不要直接授予与任务无关的更大范围。
数据似乎不是最新的
先查看 CrowScout 网页中的 Product 和扫描状态。扫描可能仍在运行，或 Agent 可能显示了之前对话中的上下文。要求 Agent 重新调用读取能力并返回数据时间，不要让它仅根据聊天记忆推断最新状态。
升级后不可用
正式发布后，请在此检查：
- MCP Server 或本地包版本：
待填写； - 客户端最低版本：
待填写； - 破坏性变更记录：
待填写； - 重新认证要求：
待填写； - 回退或恢复步骤：
待填写。
怀疑凭据泄漏
立即从 CrowScout 撤销对应连接，移除客户端中的旧凭据，检查最近使用记录，并创建权限更小的新连接。支持请求中只提供连接标识、错误代码和时间，不提供秘密值。