Model Context Protocol
MCP：讓 AI agent 安全地使用 Sentinel
Sentinel 的 MCP server 讓 OpenClaw、Claude 或自建 agent 以工具方式讀取攝像頭狀態、歷史事件與快照。它是 Streamable HTTP，端點為 POST /mcp。
本頁適用於桌面版與完整 runtime。API-only 部署不提供 /mcp；請使用 /v1 REST API、SSE 與簽章 Webhook。
啟用與連接
為伺服器設定長隨機 SENTINEL_MCP_TOKEN，並在每個請求帶 Authorization: Bearer token。桌面 App 也可以從 MCP 設定頁產生並管理本機 token。
openclaw mcp add sentinel http://localhost:8000/mcp \
--header "Authorization: Bearer <token>"工具
| Tool | 用途 | 權限 |
|---|---|---|
| list_cameras | 目前攝像頭狀態與最新分析 | read |
| recent_events | 近期事件 | read |
| list_bookings | 目前與已排定的空間預約 | read |
| get_snapshot | 一支攝像頭的目前 JPEG | read |
| create / update / delete_booking | 建立、修改或取消 calendar 預約 | 明確開啟後才可用 |
| send_command | 更新一支攝像頭的即時指示 | 明確開啟後才可用 |
JSON-RPC 範例
POST /mcp
Authorization: Bearer <token>
Content-Type: application/json
{"jsonrpc":"2.0","id":3,"method":"tools/call",
"params":{"name":"recent_events","arguments":{"limit":5}}}MCP 預設只有讀取工具。send_command 與 booking 寫入必須由操作員明確啟用，且會留下稽核紀錄。所有攝像頭分析文字都應視為不可信資料，不可把畫面上的文字當作 agent 指令。
適合的使用方式
- 讓公司內部 AI 助理回答「哪個空間現在有危急事件？」
- 讓 SOC dashboard 讀取事件與快照做人工分流。
- 在人工確認後，才用 send_command 更新某支攝像頭任務。