MCP 安装与使用
通过 Scoutary MCP，你可以让 AI agent 在对话里读取团队的采集内容，继续做整理、分析和总结。Claude Code、Codex、Cursor、WorkBuddy 等支持远程 HTTP MCP 的客户端都可以接入。
安装 MCP
- 在 Scoutary 看板切换到要使用的团队，打开设置 → MCP。
- 选择你的客户端，默认展示「一句话安装」。复制这段 prompt，直接发给 agent，让它按当前客户端的配置格式完成安装。
- 也可以切换到「命令行」「配置文件」或「一键添加」，按页面提示操作。不同客户端提供的方式可能不同。
页面给出的配置已经包含当前环境的 MCP 地址、团队 App ID 和账号 API Key，不需要再手动填写。切换团队或环境后，请重新复制对应配置。配置中包含完整凭据，请妥善保管。
验证是否已经可以使用
安装后，继续发一句话给 agent：
Scoutary MCP 已经可以正常用了么？请实际调用一个只读工具检查连接，并告诉我是否还需要重启、信任或启用。按 agent 的回复完成剩余操作，再发同一句话验证。确认工具调用成功并返回当前团队的数据或正常的空列表，才说明已经连通；仅写入配置文件还不代表当前会话已经能使用。
连通后，可以继续说：
用 Scoutary MCP 查看我当前团队的采集任务，并总结最近收集到的内容。请只读取数据。Codex：安装后如果直接使用用不了，可能需要重启
在 Codex 中安装 MCP 后，先发送上面的验证问句。若当前会话还无法使用，可能需要退出并重新打开 Codex；使用 ChatGPT 桌面 App 中的 Codex 模式时，可能需要完全退出 ChatGPT 再重新打开。
重新打开后，再问一次：
Scoutary MCP 已经可以正常用了么？请实际调用一个只读工具检查连接，并告诉我是否还需要做什么操作。如果仍然失败，让 agent 检查当前客户端是否已加载 scoutary、MCP 地址是否正确，以及两个认证请求头是否完整。Codex 的 MCP 配置使用 TOML，页面「Codex → 配置文件」会给出对应片段。参见 Codex 官方 MCP 配置说明。
WorkBuddy：新增的 MCP 需要信任并启用
在 WorkBuddy 里安装后，新加的 MCP 需要手动信任并启用：
- 在左侧边栏点「专家·技能·连接器」，在弹出的菜单里选「连接器」。
- 点击右上角「自定义连接器」。
- 在「MCP 服务管理」中找到
scoutary，点击「信任」，并确认右侧开关已打开、名称后面显示绿点。
然后回到对话，发送：
Scoutary MCP 已经可以正常用了么？请实际调用一个只读工具检查连接，并告诉我是否还需要信任或启用。按 agent 的回复完成剩余操作，再发同一句话验证。确认工具调用成功后，再继续读取和分析采集内容。
常见问题
配置已写入，但 agent 说找不到 Scoutary MCP
先发送验证问句。Codex 可以按重启说明处理；WorkBuddy 请确认已经信任并启用。
能连接，但读取失败或没有数据
请让 agent 返回具体错误，并检查配置对应的团队、账号权限和该团队是否已有采集内容。空列表可能只是团队暂无对应数据；认证或权限错误需要按错误提示处理。