AI Agent 接入MCP
能力参考
CrowScout MCP 计划中的工具分组，以及正式工具参考应采用的统一页面结构。
状态：设计草案。以下名称是文档分组，不是最终 MCP tool 名称。
能力分组
Products
- 列出当前连接可访问的 Products；
- 读取当前已确认的 Product Profile；
- 读取当前发现目标和 Product 状态。
Leads
- 按 Product、路由、工作流状态和时间筛选 Leads；
- 读取 Lead 的原文摘要、匹配理由和证据；
- 读取关键词归因和分析结果；
- 在获得写入授权与确认后更新工作流状态。
Scans
- 读取当前关键词计划；
- 查看正在运行或最近完成的扫描；
- 解释真实的关键词、唯一帖子、评分和符合条件 Lead 进度；
- 在获得单独权限后启动扫描。
Drafts
- 读取现有回复或私信草稿；
- 为指定 Lead 创建草稿；
- 编辑 CrowScout 内的草稿；
- 清楚区分“草稿已批准”和“已在 Reddit 发送”。
单个工具的正式文档模板
每个最终工具都应包含以下部分：
最终工具名称
用途：一句话说明它为用户完成什么。
所需权限：只读或具体写入权限。
输入
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
待填写 | 待填写 | 待填写 | 包括范围、默认值和上限 |
输出
说明返回对象、分页方式、时间格式、可空字段和证据链接方式。
用户确认
说明是否修改数据、启动任务、消耗配额或需要显式确认。
错误
列出稳定错误代码、用户可理解的原因和恢复步骤。至少区分未认证、无权限、Product 不可用、输入无效、任务冲突、速率或配额限制以及服务暂不可用。
示例
提供经过真实 Server 验证、已经去除秘密值和用户数据的请求与响应。
返回数据原则
- 默认返回完成任务所需的最少字段；
- 分页和批量上限必须明确，避免 Agent 无界读取；
- 摘要应保留回到证据或原帖的稳定引用；
- 不向客户端暴露服务端 API key、Provider run 私密信息或内部错误堆栈；
- 对归档、删除、失败和仍在运行的状态提供明确区分。