整合: AI 助理

連線 AI 助理

Agent DVR 可以直接從 AI 助理（例如 Claude、ChatGPT、Cursor 和 VS Code Copilot）使用。以自然語言提問 - 「我昨晚有什麼警報？」、「顯示我今早車道攝影機發生了什麼」、「停用車庫中的攝影機」- 助理會從您的直播攝影機、錄影片段和警報記錄檔（包括影像）回答。

這是透過 Model Context Protocol (MCP) 實現的，這是助理用來連線到外部工具的開放標準。Agent DVR 在兩個地方提供 MCP 伺服器，您可以將助理連線到任何適合您的地方：

  • 內建於 Agent DVR（本機端點）：由您本機網路上的伺服器提供服務。不需要帳戶或訂閱。適用於在同一部電腦或 LAN 上執行的助理。
  • 透過 iSpyConnect.com（雲端端點）：透過網頁入口網站和行動應用程式使用的相同遠端存取，從任何地方到達您的伺服器，無需通訊埠轉發。需要 iSpyConnect 訂閱。這是用於 claude.ai、ChatGPT 和手機的選項。

兩者都公開相同的工具集。需要 Agent DVR 8.0.3 或更新版本。

本機端點

每個 Agent DVR 伺服器都在其本機網頁伺服器的 /mcp 位置提供 MCP，所以如果您在 http://localhost:8090 開啟 Agent DVR 使用者介面，端點就是 http://localhost:8090/mcp（從區域網路上的另一部電腦使用您伺服器的位址和通訊埠，例如 http://192.168.1.10:8090/mcp）。預設為開啟，可以在伺服器設定 - 本機伺服器中使用 AI Assistant (MCP) Endpoint 關閉。

存取遵循與其餘本機 API 完全相同的規則：在您自己的網路中不需要登入，除非已啟用 保護 API，在這種情況下助理必須傳送管理員使用者的使用者名稱和密碼（大多數 MCP 用戶端允許您新增驗證標頭 (Authorization Header)）。來自網路外部的連線另外還需要授權金鑰，與通訊埠轉發存取使用者介面相同。

Claude Code

claude mcp add --transport http agentdvr http://localhost:8090/mcp

Cursor

新增至 .cursor/mcp.json（或透過設定 - MCP）：

{ "mcpServers": { "agentdvr": { "url": "http://localhost:8090/mcp" } } }

VS Code (Copilot)

新增至 .vscode/mcp.json：

{ "servers": { "agentdvr": { "type": "http", "url": "http://localhost:8090/mcp" } } }

Claude Desktop

Claude 桌面應用程式無法直接呼叫您自己電腦上的伺服器，所以它使用一個小型擴充功能為您執行此操作。下載 AgentDVR.mcpb，然後在 Claude Desktop 中開啟 設定 - 擴充功能，並將檔案拖曳到頁面上。它會以已啟用狀態安裝，並連接到 http://localhost:8090/mcp；只有當您的伺服器位於另一台電腦上或已啟用 保護 API 時，才要點擊 設定。Claude 在第一次使用每個工具時要求許可 - 選擇「一律允許」以停止提示。

Claude Desktop 會對每個不是從 Anthropic 自身目錄安裝的擴充功能顯示紅色警告。這對此檔案而言是預期的；該擴充功能僅與您提供的位址通訊。

其他助理

任何支援 HTTP 上 MCP（「串流 HTTP」）的用戶端都可以使用相同的網址。在助理的設定中尋找「MCP 伺服器」、「連接器」或「工具」。

Claude 網頁應用程式和行動應用程式，以及 ChatGPT，完全無法連接您自己網路上的伺服器；它們使用 雲端端點。

雲端端點

使用 iSpyConnect 訂閱，您的伺服器也可以在以下位置存取：

https://www.ispyconnect.com/mcp

將該網址 (URL) 新增為助手中的自訂連接器或 MCP 伺服器（例如 claude.ai 和 Claude 應用程式中的「設定 - 連接器」，或 ChatGPT 和 Cursor 中的等效選項）。助手會開啟 iSpyConnect 登入頁面；登入、選擇是否允許控制以及檢視，然後點擊「允許」。不需要進行任何其他設定：所有已連線到您帳戶且已啟用遠端存取的 Agent DVR 伺服器都可用，如果您有多於一個伺服器，助手會詢問您指的是哪一個。

請求會透過網路入口網站使用的相同轉接器傳輸，因此不需要連接埠轉發，您的伺服器永遠不會暴露於網際網路。當您的訂閱過期時，存取會停止，每個助手的存取可以隨時從助手本身的連接器設定中移除。

您的伺服器必須執行中並連線到 iSpyConnect（本機使用者介面中的掛鎖圖示顯示遠端連線狀態）。伺服器設定中的「阻擋外部存取」也會阻止此端點。

助理可以做什麼

助理可以存取一組專門用途的工具，而非原始 API，因此回應快速且成本低廉：

  • 檢視:列出伺服器和裝置(含位置和狀態)、取得活動摘要(每部攝影機每小時的錄影片段和警報,以及偵測到的內容)、列出時間視窗內的錄影片段、以幀格的方式一次查看整個視窗、以時間軸方式查看攝影機全天的幀、從一段錄影片段中取樣幀、取得攝影機的即時快照、讀取警示記錄檔,以及取得在網頁 UI 中開啟錄影片段的連結。
  • 控制：啟用和停用伺服器、套用設定檔、啟用或停用裝置、變更錄影模式、開啟或關閉警報和偵測器、將 PTZ 攝影機移至預設位置，以及來自 API 的其他狀態變更。
  • 其他：進一步讀取和控制指令的目錄，助理可在沒有專用工具適用時呼叫（系統統計資料、裝置的完整狀態、PTZ 預設位置等）。

助理無法刪除錄影片段或相片、變更裝置或伺服器組態、新增或移除裝置，或重新啟動伺服器：無論使用哪個端點，這些指令都刻意不提供。在雲端端點上，檢視和控制是您在登入頁面上授予的個別權限，使用量受到速率限制以保護中繼站。

範例提示

  • 「過去 24 小時內有人來過前門嗎?給我看看。」
  • 「今天早上有哪些鳥類來訪餵食器?」
  • 「今天車道的使用量有多少,何時使用?」
  • 「給我看看後花園全天的景況。何時開始下雨?」
  • 「昨天我收到哪些警報,其中是否有人員?」
  • 「現在誰在前門?」
  • 「哪些攝影機離線？」
  • 「我們即將出門 - 以外出設定檔啟用所有保護。」
  • 「停用家居位置中的所有攝影機。」
  • 「傳送給我快遞員片段的連結。」

現成的工作流程

伺服器也提供提示詞範本,支援提示詞的助手(Claude Desktop、Claude Code、Cursor 及其他)會將其顯示為斜線指令或在功能表中。每個範本都會執行完整的多步驟工作流程並報告結果:

  • morning_briefing - 攝影機從上一個晚上起看到的內容:活動、警報、顯著人員、車輛和動物,以及攝影機狀態。
  • door_report - 誰來過門聲攝影機、時間、每位訪客做了什麼,以及每段片段的連結。
  • wildlife_report - 攝影機捕捉到哪些動物和鳥類,根據錄影片段盡可能精確地識別。
  • camera_health - 檢查每部伺服器和攝影機是否離線、已停用、出錯以及已停止活動的攝影機。
  • day_in_review - 攝影機全天的時間軸幀檢視,附帶場景變化的敘述。

故障排除

  • 助理無法連線到本機端點：在瀏覽器中檢查網址 - http://localhost:8090/mcp 應該會回應（錯誤訊息可以接受；「連線遭拒」不行）。確保通訊埠符合伺服器設定 - 本機伺服器，且端點在該處已啟用。
  • 401 未授權：保護 API 已啟用，所以助理必須傳送管理員使用者的認證資訊，或者您是從網路外部連線。
  • 403 禁止存取：在沒有授權金鑰的情況下從網路外部連線。改用雲端端點。
  • 404 找不到：端點在伺服器設定中已關閉，或伺服器版本早於 8.0.3。
  • 雲端端點指出伺服器離線：伺服器未連線到 iSpyConnect。檢查本機使用介面中的掛鎖圖示，並確認阻擋外部存取已關閉。
  • 查看助手正在執行的動作：在伺服器設定中將日誌紀錄設為偵錯，然後從伺服器功能表開啟日誌。在本機端點上，每個請求和工具呼叫都會記錄下來，前綴為「MCP」，包括參數和花費的時間。透過雲端端點，工具在 iSpyConnect.com 上執行，伺服器只會看到它們傳送的個別指令，記錄前綴為「RelayApi」。