FactVerse MCP 集成

FactVerse 使用 Model Context Protocol，把 AI Agent 与受控的工业工具、数字孪生上下文、仿真服务、运营数据和已批准的执行路径连接起来。

集成模型

支持 MCP 的客户端携带 API Key 调用 FactVerse MCP 端点。FactVerse 根据 API Key 解析租户和授权 scope，只暴露该 key 可以使用的工具。

AI client -> FactVerse MCP endpoint -> scoped tools -> FactVerse services

认证

面向客户的 MCP 请求使用请求头中的 API Key：

X-API-Key: your-api-key

API Key 用来识别租户和授权 scope。客户端不应通过自带租户 header 来替代基于 key 的授权。

客户端配置示例

{
  "mcpServers": {
    "factverse": {
      "url": "https://your-factverse-host/mcp/base/",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

使用工具

请通过 MCP 客户端在运行时发现可用工具。工具可用性会随着模块、客户 scope 和客户环境配置演进。

工具参考页面用于查看 MCP 工具名称、scope、说明和参数。客户环境中的实际可用工具以运行时发现为准。

Endpoint 选择

Endpoint	主要用途
/mcp/base/	通用资产、文档、数据质量、仿真、优化、预测和受控动作草稿。
/mcp/pdm/	预测性维护健康、异常、部件和维护建议复核。
/mcp/dcops/	数据中心资产健康、告警、预测、诊断、维护建议、派工复核和闭环证据。

数据中心运营的大部分工具使用 dcops.read。派工批准和闭环对账属于动作类工具，需要 dcops.action.write，并应在运营负责人确认后调用。

继续阅读

页面	用途
接入指南	配置 Claude、Cursor、Python 或其他兼容 MCP 的客户端。
能力指南	理解 endpoint 系列、能力类别和工作流选择。
Scope 矩阵	规划 endpoint、scope、复核人和访问包。
错误与审计	诊断访问、scope、来源数据、计算和写入动作失败。
工具参考	查看工具名称、scope、说明和参数。
权限范围参考	查看 endpoint 和 scope 细节。

已退役入口

新的 Physical AI 集成应使用 scope 参考中描述的基础平台与模块级 MCP endpoint。数据中心工作流从 /mcp/dcops/ 开始，需要共享文档、工单或跨模块证据时再增加 /mcp/base/。