MCP 开放接入与工具权限
用标准协议把业务能力开放给支持 MCP 的 AI 办公平台，工具白名单分级、连接即身份、契约版本化。
为什么要开放接入
用户已经在 AI 办公平台里干活了，再让他切回一个独立网站填表，路径太长。通过 MCP（Model Context Protocol）标准协议，业务能力可以直接在支持 MCP 的 AI 办公平台（如 WorkBuddy、Trae）里被调用，结果仍由后端落库、可分享、可复核。
分工口径固定为：AI 做理解，后端做权威；AI 做生成，后端做契约；AI 做交互，后端做资产。
协议与实现的演进
| 环节 | 早期 | 定稿 |
|---|---|---|
| 传输层 | 自建 JSON-RPC 分发器 | 官方 MCP SDK 2.3.0 Streamable HTTP |
| 版本策略 | 单版本 | N / N-1 双版本，按官方 12 个月弃用窗口滚动下线旧版 |
| 分发逻辑 | 手写分发层 | 中间件承载鉴权、工具准入、身份绑定、可见性过滤 |
| 身份 | 调用方传内部用户编号 | 「连接即身份」，由令牌绑定，工具列表不再暴露身份参数 |
契约版本从 v1.1 走到 v1.7：v1.2 明确素材来源边界（不允许用文档替代真实素材），v1.3 增加写入前协议与用户确认门禁，v1.7 增加写入后回读，保证「落库结果」与「用户确认的内容」一致。提示层作引导，关键动作由服务端强制执行。
默认安全的权限模型
能力侧维护工具白名单（工具名 → 所需权限，未登记即不可访问），授权侧由客户端令牌携带已授予权限，分三级：
- 读：业务列表 / 详情、报告列表 / 详情
- 分析：竞争、洞察、策略、工作流执行
- 写：档案更新、品牌与业务实体建档
工具列表按权限过滤，未登记或权限不足一律拒绝，不默认放行。
报告与资产
报告结果按落库模块名显式寻址，不再靠工作流名推断（推断失败会静默不落库）。三层有效期各司其职：采集层 180 天、报告去重层 90 天、读取侧按类型单独判定；新鲜度先判状态有效、再用更新时间。公开报告默认链接级可访问，权限由服务端凭证判定。
衔接
- 能力移交的整体背景：V4 · 开放接入与租户化
- 采集侧如何共用同一套入口：URL 采集管线的通用方法