Integrazioni: Assistenti AI

Agent DVR può essere utilizzato direttamente da assistenti AI come Claude, ChatGPT, Cursor e VS Code Copilot. Chiedi in linguaggio naturale - "quali avvisi ho avuto la notte scorsa?", "mostrami cosa è successo sulla telecamera del vialetto questa mattina", "disabilita le telecamere nel garage" - e l'assistente risponde dalle tue telecamere dal vivo, registrazioni e registro degli avvisi, incluse le immagini.

Questo funziona attraverso il Model Context Protocol (MCP), lo standard aperto che gli assistenti utilizzano per connettersi agli attrezzi esterni. Agent DVR fornisce un server MCP in due posizioni, e colleghi il tuo assistente a quella che più ti conviene:

• Integrato in Agent DVR (Endpoint locale): gestito dal tuo server sulla tua rete locale. Nessun account o abbonamento necessario. Per assistenti in esecuzione sullo stesso computer o LAN.
• Attraverso iSpyConnect.com (Endpoint cloud): raggiunge i tuoi server attraverso lo stesso accesso remoto utilizzato dal portale web e dalle app mobili, da qualsiasi luogo, senza inoltro porte. Richiede un abbonamento iSpyConnect. Questo è quello da utilizzare per claude.ai, ChatGPT e telefoni.

Entrambi espongono lo stesso insieme di attrezzi. Richiede Agent DVR 8.0.3 o versione successiva.

Ogni server Agent DVR fornisce MCP su /mcp nel suo server web locale, quindi se apri l'interfaccia Agent DVR su http://localhost:8090 l'endpoint è http://localhost:8090/mcp (utilizza l'indirizzo e la porta del tuo server da un altro computer sulla LAN, ad esempio http://192.168.1.10:8090/mcp). È abilitato per impostazione predefinita e può essere disattivato con AI Assistant (MCP) Endpoint in Impostazioni server - Server locale.

L'accesso segue esattamente le stesse regole del resto dell'API locale: dalla tua rete non è necessario alcun accesso, a meno che Proteggi API sia abilitato, nel qual caso l'assistente deve inviare il nome utente e la password di un utente amministratore (la maggior parte dei client MCP ti consente di aggiungere un'intestazione di autorizzazione). Le connessioni da fuori dalla tua rete richiedono inoltre una licenza, la stessa dell'accesso al port-forward dell'interfaccia.

Claude Code

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

Cursor

Aggiungi a .cursor/mcp.json (oppure tramite Impostazioni - MCP):

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

VS Code (Copilot)

Aggiungi a .vscode/mcp.json:

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

Claude Desktop

L'app desktop di Claude non può chiamare un server sul tuo computer direttamente, quindi utilizza una piccola estensione che lo fa per te. Scarica AgentDVR.mcpb, poi in Claude Desktop apri Impostazioni - Estensioni e trascina il file sulla pagina. Si installa abilitato e si connette a http://localhost:8090/mcp; clicca Configura solo se il tuo server si trova su un altro computer o ha Proteggi API abilitato. Claude chiede il permesso la prima volta che ogni strumento viene utilizzato - scegli "Consenti sempre" per interrompere i promemoria.

Altri assistenti

Qualsiasi client che supporta MCP su HTTP ("Streamable HTTP") può utilizzare lo stesso URL. Cerca "Server MCP", "connettori" o "attrezzi" nelle impostazioni dell'assistente.

L'app web di Claude e le app mobile, e ChatGPT, non possono raggiungere un server sulla tua rete in nessun modo; utilizzano l'Endpoint cloud.

Con un abbonamento iSpyConnect, i tuoi server sono raggiungibili anche all'indirizzo:

https://www.ispyconnect.com/mcp

Aggiungi quell'URL come connettore personalizzato o server MCP nel tuo assistente (ad esempio Impostazioni - Connettori in claude.ai e nelle app Claude, o l'equivalente in ChatGPT e Cursor). L'assistente apre una pagina di accesso iSpyConnect; effettua l'accesso, scegli se consentire il controllo oltre alla visualizzazione, e clicca Consenti. Non è necessario configurare nient'altro: ogni server Agent DVR connesso al tuo account con accesso remoto abilitato è disponibile, e l'assistente ti chiederà quale intendi se ne hai più di uno.

Le richieste viaggiano attraverso lo stesso relay che utilizza il portale web, pertanto non è necessario alcun inoltro di porta e il tuo server non è mai esposto a Internet. L'accesso si interrompe quando l'abbonamento scade, e l'accesso di ciascun assistente può essere rimosso dalle impostazioni del connettore dell'assistente stesso in qualsiasi momento.

Il tuo server deve essere in esecuzione e connesso a iSpyConnect (l'icona del lucchetto nell'interfaccia locale mostra lo stato della connessione remota). Blocca accesso esterno nelle Impostazioni server blocca anche questo endpoint.

Gli assistenti vedono una piccola serie di attrezzi costruiti per uno scopo specifico piuttosto che l'API grezza, quindi le risposte rimangono veloci ed economiche:

• Visualizzazione: elenca i tuoi Server e Dispositivi (con Posizione e stato di salute), ricevi un riepilogo dell'Attività (Registrazioni e Avvisi per Telecamera per ora, con ciò che è stato Rilevato), elenca Registrazioni in una finestra temporale, visualizza un'intera finestra in un colpo d'occhio come griglia di fotogrammi, visualizza una Telecamera nell'arco di un giorno come sequenza temporale di fotogrammi, campiona fotogrammi da una Registrazione, acquisisci un'istantanea dal vivo di una Telecamera, leggi il registro degli Avvisi e ottieni un collegamento per aprire una Registrazione nell'interfaccia web.
• Controllo: attivare e disattivare il server, applicare profili, abilitare o disabilitare i dispositivi, modificare le modalità di registrazione, attivare o disattivare gli avvisi e i rilevatori, spostare le telecamere PTZ verso i preset, e altre modifiche di stato dall'API.
• Tutto il resto: un catalogo di ulteriori comandi di lettura e controllo che l'assistente può richiamare quando nessuno strumento dedicato è adatto (statistiche di sistema, stato completo di un dispositivo, preset PTZ e così via).

L'assistente non può eliminare registrazioni o foto, modificare la configurazione del dispositivo o del server, aggiungere o rimuovere dispositivi, o riavviare il server: questi comandi non vengono deliberatamente offerti, qualunque sia l'endpoint utilizzato. Sull'endpoint cloud, la visualizzazione e il controllo sono permessi separati che accordi nella pagina di accesso, e l'utilizzo è limitato per velocità per proteggere il relè.

Prompt di esempio

• "Qualcuno è venuto alla porta d'ingresso nelle ultime 24 ore? Mostrami."
• "Quali uccelli hanno visitato la mangiatoia stamattina?"
• "Quanto è stata affollata la strada oggi, e quando?"
• "Mostrami il giardino sul retro nell'arco della giornata. Quando ha iniziato a piovere?"
• "Quali Avvisi ho avuto ieri, e uno di loro era una Persona?"
• "Chi è alla porta d'ingresso in questo momento?"
• "Quali telecamere sono offline?"
• "Stiamo uscendo - attiva tutto con il Profilo Assente."
• "Disabilita tutte le telecamere nella posizione home."
• "Mandami un collegamento al video del corriere."

Flussi di lavoro pronti

Il Server offre inoltre modelli di prompt che gli assistenti con supporto ai prompt (Claude Desktop, Claude Code, Cursor e altri) mostrano come Comandi slash o in un menu. Ognuno esegue un flusso di lavoro multi-step completo e segnala il Risultato:

• morning_briefing - ciò che le Telecamere hanno visto dalla sera precedente: Attività, Avvisi, Persone, veicoli e animali notevoli, e stato di salute delle Telecamere.
• door_report - chi si è presentato a una Telecamera di porta, con orari, cosa ha fatto ogni visitatore e un collegamento a ogni clip.
• wildlife_report - quali animali e uccelli una Telecamera ha catturato, identificati il più possibile fedelmente rispetto alle riprese.
• camera_health - ogni Server e Telecamera controllato per offline, Disabilitato, errori e Telecamere che sono rimaste silenziose.
• day_in_review - una Telecamera nell'arco di un'intera giornata come sequenza temporale di fotogrammi, con una narrazione di come la scena è cambiata.

• L'assistente non riesce a connettersi all'endpoint locale: controlla l'URL in un browser - http://localhost:8090/mcp dovrebbe rispondere (un messaggio di errore va bene; "connessione rifiutata" no). Assicurati che la porta corrisponda a Impostazioni server - Server locale e che l'endpoint sia abilitato lì.
• 401 Non autorizzato: Proteggi API è abilitato, quindi l'assistente deve inviare le credenziali di un utente amministratore, oppure ti stai connettendo da fuori della tua rete.
• 403 Accesso negato: connessione da fuori della tua rete senza licenza. Usa invece l'Endpoint cloud.
• 404 Non trovato: l'endpoint è disattivato in Impostazioni server, oppure il server è più vecchio della versione 8.0.3.
• L'endpoint cloud dice che il server è offline: il server non è connesso a iSpyConnect. Controlla l'icona del lucchetto nell'interfaccia locale e che Blocca accesso esterno sia disattivato.
• Visualizzare le azioni dell'assistente: impostare Registrazione log su Debug in Impostazioni server e aprire i log dal Menu server. Sull'endpoint locale ogni richiesta e chiamata di strumento viene registrata con un prefisso "MCP", inclusi gli Argomenti e il tempo impiegato. Attraverso l'endpoint cloud gli strumenti vengono eseguiti su iSpyConnect.com e il server visualizza solo i singoli Comandi che inviano, registrati con un prefisso "RelayApi".