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 集合。
- 由客戶端執行執行時工具發現。
- 在 工具參考 中交叉檢查工具名稱和參數。
- 使用 工作流程執行記錄 記錄證據和複核狀態。
良好的整合行為
- 呼叫工具前先在執行時列出工具。
- 把生成建議和已確認事實分開。
- 在面向使用者的輸出中返回來源時間戳、資產或場景標識。
- 將計算結果作為帶可見假設的工程複核輸出。
- 寫入動作在人工審批前保持草稿狀態。
- 捕獲複核人的修正，讓工作流程持續改進。