MCP AI 助手介接

AI 能做什麼

工具共 262 個、35 個分類，由後端的 API 自動鏡像產生，功能與編輯器一致。每個工具描述標示「唯讀」或「破壞性」，更新類工具採先讀現值、合併、再寫入，不會把沒提到的欄位洗回預設。

• 讀專案：專案清單、頁面索引（頁碼、名稱、元件數）、單頁內容、專案設定、專案匯出。
• 建畫面：建立專案、新增或覆寫單頁、改名、移動與交換頁碼（自動重新對應引用）、組合件、圖片上傳、內建圖庫查詢、字型、多國語字典。
• 設通訊：通道、設備、表、點位的建立修改刪除與 Excel 匯入匯出；BACnet 掃描與物件匯入；OPC UA 節點瀏覽；寫入點位；重啟通訊；Modbus 與 OPC UA 伺服器設定。
• 警報與趨勢：警報表與規則（含批量）、確認狀態、查活躍與歷史警報、確認；趨勢表與點位、歷史查詢、Excel 匯出。
• 自動化：腳本建立、驗證、觸發、重啟；排程建立與立即執行；背景任務；報表模板上傳。
• 查狀態：系統資訊與授權健康、CPU 記憶體磁碟網路、通訊狀態、各通道狀態、在線客戶端、儲存空間、備援狀態、更新記錄、操作紀錄。
• 現場操作：部署、停止運轉、讓現場螢幕立刻切頁、攝影機與 VNC 連線測試、USB 檔案清單、事件錄影片段查詢與保護。

安全與追溯

MCP 端點在後端同一個埠的 /mcp 路徑，以系統帳號密碼做 Basic 認證，角色需 Engineer 以上。所有 MCP 操作都寫入操作紀錄，可事後追溯。

• 受專案保護密碼的專案，AI 必須先解鎖才能讀寫設計內容。
• 試用模式下的部署驗證在後端強制執行，AI 無法繞過。
• 限 Admin 或 Engineer 的工具（備援設定、儲存空間、重開機、關機、使用者管理）依角色阻擋。
• 登入、授權續期、部署驗證、專案解鎖等敏感接口刻意不開放為工具。

畫面

操作流程

1. 1在設備上準備 Engineer 以上角色的系統帳號。
2. 2在自己的 AI 客戶端（例如 Claude Code 等支援 MCP 的工具）新增 HTTP 型 MCP 伺服器，位址為 http://設備IP:7050/mcp，以該帳號做 Basic 認證。
3. 3連上後先用總覽與搜尋工具了解專案與可用工具，再呼叫需要專案識別碼的工具。
4. 4修改前先讀再寫，例如先取回頁面再儲存頁面；受保護專案先用密碼解鎖。
5. 5事後在操作紀錄查看 AI 做過的每一筆操作。