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 的大部分工具使用 dcops.read。派工核准和閉環對帳屬於動作類工具，需要 dcops.action.write，並應在營運負責人確認後呼叫。

繼續閱讀

頁面	用途
接入指南	設定 Claude、Cursor、Python 或其他相容 MCP 的客戶端。
能力指南	理解 endpoint 系列、能力類別和工作流程選擇。
Scope 矩陣	規劃 endpoint、scope、複核人和存取包。
錯誤與稽核	診斷存取、scope、來源資料、計算和寫入動作失敗。
工具參考	查看工具名稱、scope、說明和參數。
權限範圍參考	查看 endpoint 和 scope 細節。

已退役入口

已退役的 physical MCP endpoint 會保留遷移提示。新的整合應使用 scope 參考中描述的基礎平台與模組級 MCP endpoint。資料中心工作流程從 /mcp/dcops/ 開始，需要共享文件、工單或跨模組證據時再增加 /mcp/base/。