FactVerse MCP 将受控的工业能力开放给兼容 MCP 的客户端。选择工具前，先使用本指南理解 endpoint、scope、来源系统和生成工具参考如何共同支撑客户工作流。
如何理解 MCP 模型
| 层级 | 作用 |
|---|
| Endpoint | 受控 MCP slice，例如 /mcp/base/、/mcp/pdm/ 或已启用的模块 endpoint。 |
| API key | 标识客户端允许访问的租户和 scope。客户端通过 X-API-Key 发送。 |
| Scope | 控制哪些工具可被列出和调用。 |
| Tool | 运行时发现的函数，用于读取、计算、摘要或起草已审批动作。 |
| 证据 | 工作流返回或记录的来源引用、时间戳、资产 ID、场景版本和复核记录。 |
生成的 工具参考 列出本次文档构建的公开工具目录。具体 key 可调用哪些工具，以运行时工具发现为准。
Endpoint 系列
| Endpoint 系列 | 用于 | 典型工作流 |
|---|
/mcp/base/ | 通用资产读取、文档搜索、数据质量检查、仿真、预测、优化和受控动作草稿。 | 设施运营、Physical AI 准备、工单草稿、跨域分析。 |
/mcp/pdm/ | 设备健康、异常上下文、预测性维护摘要和部件智能。 | 预测性维护复核和维护计划。 |
/mcp/trafficops/ | 模块启用后的人流、车流、检查点、车道、排班和拥堵分析。 | 口岸运营和交通流分析。 |
/mcp/telcoops/ | 模块启用后的网络健康、事故解释和容量预测。 | 网络运营复核。 |
/mcp/semiops/ | 模块启用后的洁净室、颗粒、压差、公辅、SMT 和设施环境信号。 | 设施和洁净室运营复核。 |
/mcp/aviation/ | 模块启用后的航空数据可靠性分析。 | 可靠性复核和部件分析。 |
优先选择能支持工作流的最小 endpoint 集合。经过复核的工作流需要跨域证据时，客户端可以配置多个 endpoint。
能力类别
| 类别 | 解决什么问题 | 常见证据 |
|---|
| 资产与知识读取 | 理解设备、文档、流程、状态和运营上下文。 | 资产 ID、文档引用、时间戳、状态记录。 |
| 数据质量与连接器 | 检查来源数据是否新鲜、已映射且可用。 | 连接器状态、质量标记、缺失字段、来源时间戳。 |
| 预测性维护 | 复核设备状态、异常窗口和维护历史。 | 健康输出、信号窗口、工单记录、工程师反馈。 |
| 仿真与 what-if 分析 | 对比方案、验证假设，并准备 Physical AI 或设施规划工作。 | 场景 ID、输入假设、后端、输出指标、验证说明。 |
| 优化与预测 | 探索策略、布局、分配、需求或容量选项。 | 目标、约束、假设、结果备选项。 |
| 空间分析 | 分析区域、布局、路径、传感器布点和场景相关异常。 | 场景 ID、区域、坐标上下文、传感器引用。 |
| 受控动作 | 经复核后起草工单或运营记录。 | 审批状态、复核人、草稿记录、最终动作 ID。 |
工作流选择
| 客户任务 | 从这里开始 | 需要时增加 |
|---|
| 设施状态复核 | /mcp/base/ 读取 scope | 用于已批准摘要或分析的计算 scope。 |
| 预测性维护复核 | /mcp/pdm/ 读取 scope | 用于资产文档和已复核工单草稿的 /mcp/base/。 |
| Physical AI 场景准备 | /mcp/base/ 读取和计算 scope | 用于约束场景的运营信号模块 endpoint。 |
| 洁净室或公辅运营复核 | 模块启用时使用 /mcp/semiops/ | 用于文档、工单和数据质量上下文的 /mcp/base/。 |
| 交通或检查点复核 | 模块启用时使用 /mcp/trafficops/ | 用于共享资产或文档上下文的 /mcp/base/。 |
使用生成参考
- 选择工作流和 endpoint。
- 在 Scope 矩阵 中确认最小 scope 集合。
- 由客户端执行运行时工具发现。
- 在 工具参考 中交叉检查工具名称和参数。
- 使用 工作流运行记录 记录证据和复核状态。
良好的集成行为
- 调用工具前先在运行时列出工具。
- 把生成建议和已确认事实分开。
- 在面向用户的输出中返回来源时间戳、资产或场景标识。
- 将计算结果作为带可见假设的工程复核输出。
- 写入动作在人工审批前保持草稿状态。
- 捕获复核人的修正，让工作流持续改进。