Integrationen: KI-Assistenten

Agent DVR kann direkt von KI-Assistenten wie Claude, ChatGPT, Cursor und VS Code Copilot verwendet werden. Stellen Sie Fragen in natürlicher Sprache – „Welche Alarme hatte ich letzte Nacht?", „Zeige mir, was heute Morgen auf der Einfahrtskamera passiert ist", „Deaktiviere die Kameras in der Garage" – und der Assistent antwortet anhand Ihrer Live-Kameras, Aufnahmen und des Alarmprotokolls, einschließlich Bilder.

Dies funktioniert über das Model Context Protocol (MCP), den offenen Standard, den Assistenten verwenden, um sich mit externen Werkzeugen zu verbinden. Agent DVR stellt einen MCP-Server an zwei Stellen bereit, und Sie verbinden Ihren Assistenten mit der Variante, die für Sie passt:

• In Agent DVR integriert (Lokaler Endpunkt): bereitgestellt von Ihrem eigenen Server in Ihrem lokalen Netzwerk. Kein Konto oder Abonnement erforderlich. Für Assistenten, die auf demselben Computer oder LAN ausgeführt werden.
• Über iSpyConnect.com (Cloud-Endpunkt): erreicht Ihre Server über denselben Fernzugriff, den das Web-Portal und die mobilen Apps verwenden, von überall aus, ohne Portweiterleitung. Erfordert ein iSpyConnect-Abonnement. Dies ist die Option für claude.ai, ChatGPT und Telefone.

Beide stellen denselben Satz von Werkzeugen bereit. Erfordert Agent DVR 8.0.3 oder später.

Jeder Agent DVR-Server stellt MCP unter /mcp auf seinem lokalen Webserver bereit. Wenn Sie die Agent DVR-Benutzeroberfläche unter http://localhost:8090 öffnen, ist der Endpunkt http://localhost:8090/mcp (verwenden Sie die Adresse und den Hafen Ihres Servers von einem anderen Computer im LAN, zum Beispiel http://192.168.1.10:8090/mcp). Es ist standardmäßig aktiviert und kann mit KI-Assistent (MCP)-Endpunkt in Server-Einstellungen - Lokaler Server ausgeschaltet werden.

Der Zugriff folgt genau denselben Regeln wie der Rest der lokalen API: aus Ihrem eigenen Netzwerk ist keine Anmeldung erforderlich, es sei denn, API schützen ist aktiviert. In diesem Fall muss der Assistent den Benutzernamen und das Passwort eines Admin-Benutzers senden (die meisten MCP-Clients ermöglichen das Hinzufügen eines Authorization-Headers). Verbindungen von außerhalb Ihres Netzwerks erfordern zusätzlich eine Lizenz, die gleiche wie für den portweitergeleiteten Zugriff auf die Benutzeroberfläche.

Claude Code

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

Cursor

Hinzufügen zu .cursor/mcp.json (oder über Einstellungen - MCP):

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

VS Code (Copilot)

Hinzufügen zu .vscode/mcp.json:

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

Claude Desktop

Die Claude-Desktop-App kann keinen Server auf Ihrem eigenen Computer direkt aufrufen, daher wird dafür eine kleine Erweiterung verwendet. Laden Sie AgentDVR.mcpb herunter, öffnen Sie dann in Claude Desktop Einstellungen - Erweiterungen und ziehen Sie die Datei auf die Seite. Sie wird aktiviert installiert und verbindet sich mit http://localhost:8090/mcp; klicken Sie auf Konfigurieren nur, wenn sich Ihr Server auf einem anderen Computer befindet oder wenn API schützen aktiviert ist. Claude fragt beim ersten Mal bei der Verwendung der einzelnen Werkzeuge um Erlaubnis - wählen Sie "Immer erlauben", um die Aufforderungen zu beenden.

Andere Assistenten

Jeder Client, der MCP über HTTP ("Streamable HTTP") unterstützt, kann die gleiche URL verwenden. Suchen Sie nach "MCP-Servern", "Konnektoren" oder "Werkzeugen" in den Einstellungen des Assistenten.

Die Claude-Web-App und Mobile-Apps sowie ChatGPT können einen Server in Ihrem eigenen Netzwerk überhaupt nicht erreichen; sie nutzen den Cloud-Endpunkt.

Mit einem iSpyConnect-Abonnement sind Ihre Server auch unter folgender Adresse erreichbar:

https://www.ispyconnect.com/mcp

Fügen Sie diese URL als Benutzerdefiniert-Connector oder MCP-Server in Ihrem Assistenten hinzu (beispielsweise Einstellungen - Connectors in claude.ai und den Claude-Apps oder das Äquivalent in ChatGPT und Cursor). Der Assistent öffnet eine iSpyConnect-Anmeldeseite; melden Sie sich an, wählen Sie, ob Sie Steuerung sowie Anzeige erlauben möchten, und klicken Sie auf Erlauben. Nichts anderes muss konfiguriert werden: Jeder Agent DVR-Server, der mit Ihrem Konto verbunden ist und Fernzugriff aktiviert hat, ist verfügbar, und der Assistent fragt, welchen Sie meinen, wenn Sie mehr als einen haben.

Anfragen werden über das gleiche Relais wie das Webportal übertragen, sodass keine Portweiterleitung erforderlich ist und Ihr Server nicht dem Internet ausgesetzt wird. Der Zugriff stoppt, wenn Ihr Abonnement abläuft, und der Zugriff jedes Assistenten kann jederzeit in den Connector-Einstellungen des Assistenten selbst entfernt werden.

Ihr Server muss ausgeführt werden und mit iSpyConnect verbunden sein (das Vorhängeschloss-Symbol in der lokalen Benutzeroberfläche zeigt den Fernverbindungsstatus an). Externen Zugriff blockieren in Server-Einstellungen blockiert auch diesen Endpunkt.

Assistenten erhalten einen kleinen Satz von speziell entwickelten Werkzeugen anstelle der rohen API, sodass Antworten schnell und kostengünstig bleiben:

• Anzeigen: Ihre Server und Geräte auflisten (mit Standort und Zustand), eine Zusammenfassung der Aktivität abrufen (Aufnahmen und Alarme pro Kamera pro Stunde, mit erkannten Objekten), Aufnahmen in einem Zeitfenster auflisten, ein ganzes Fenster auf einen Blick als Raster von Bildern sehen, eine Kamera über einen Tag hinweg als Zeitleiste von Bildern sehen, Bilder aus einer Aufnahme entnehmen, einen Live-Schnappschuss einer Kamera machen, das Alarmprotokoll lesen und einen Link zum Öffnen einer Aufnahme in der Web-Benutzeroberfläche abrufen.
• Steuerung: den Server aktivieren und deaktivieren, Profile anwenden, Geräte aktivieren oder deaktivieren, Aufnahmemodi ändern, Alarme und Detektoren ein- oder ausschalten, PTZ-Kameras zu Voreinstellungen bewegen und weitere Zustandsänderungen aus der API.
• Alles Weitere: ein Katalog mit weiteren Lese- und Steuerbefehlen, die der Assistent aufrufen kann, wenn kein spezialisiertes Werkzeug passt (Systemstatistiken, vollständiger Status eines Geräts, PTZ-Voreinstellungen und so weiter).

Der Assistent kann keine Aufnahmen oder Fotos löschen, die Konfiguration von Geräten oder Servern ändern, Geräte hinzufügen oder entfernen oder den Server neu starten: Diese Befehle werden absichtlich nicht angeboten, unabhängig davon, welcher Endpunkt verwendet wird. Beim Cloud-Endpunkt sind Anzeige und Steuerung separate Berechtigungen, die Sie auf der Anmeldungsseite erteilen, und die Verwendung ist begrenzt, um das Relay zu schützen.

Beispielaufforderungen

• "Ist in den letzten 24 Stunden jemand an der Haustür gewesen? Zeig mir."
• "Welche Vögel haben heute Morgen den Futterplatz besucht?"
• "Wie viel Betrieb herrschte heute auf der Einfahrt, und wann?"
• "Zeig mir den Garten hinten über den ganzen Tag. Wann hat es angefangen zu regnen?"
• "Welche Alarme hatte ich gestern, und waren welche davon Personen?"
• "Wer steht gerade an der Haustür?"
• "Welche Kameras sind offline?"
• "Wir fahren weg - aktiviere alles mit dem Profil Abwesend."
• "Deaktiviere alle Kameras am Standort Zuhause."
• "Schreib mir einen Link zum Clip des Kurierfahrers."

Vorgefertigte Arbeitsabläufe

Der Server bietet auch Aufforderungsvorlagen, die Assistenten mit Aufforderungsunterstützung (Claude Desktop, Claude Code, Cursor und andere) als Schrägstrich-Befehle oder in einem Menü anzeigen. Jede führt einen kompletten mehrstufigen Arbeitsablauf aus und meldet das Ergebnis:

• morning_briefing - was die Kameras seit gestern Abend gesehen haben: Aktivität, Alarme, bemerkenswerte Personen, Fahrzeuge und Tiere sowie Kamerazustand.
• door_report - wer an einer Türkamera vorbeikam, mit Zeiten, was jeder Besucher tat und ein Link zu jedem Clip.
• wildlife_report - welche Tiere und Vögel eine Kamera aufnahm, so genau wie das Bildmaterial es zulässt.
• camera_health - jeder Server und jede Kamera überprüft auf Offline, Deaktiviert, Fehler und Kameras, die keinen Ton mehr von sich geben.
• day_in_review - eine Kamera über einen ganzen Tag hinweg als Zeitleiste von Bildern, mit einer Erzählung darüber, wie sich die Szene verändert hat.

• Der Assistent kann sich nicht mit dem lokalen Endpunkt verbinden: Überprüfen Sie die URL in einem Browser - http://localhost:8090/mcp sollte antworten (eine Fehlermeldung ist in Ordnung; "Verbindung abgelehnt" nicht). Stellen Sie sicher, dass der Hafen den Server-Einstellungen - Lokaler Server entspricht und dass der Endpunkt dort aktiviert ist.
• 401 Nicht autorisiert: API schützen ist aktiviert, daher muss der Assistent die Anmeldedaten eines Administrator-Benutzers senden, oder Sie verbinden sich von außerhalb Ihres Netzwerks.
• 403 Verboten: Verbindung von außerhalb Ihres Netzwerks ohne Lizenz. Verwenden Sie stattdessen den Cloud-Endpunkt.
• 404 Nicht gefunden: Der Endpunkt ist in den Server-Einstellungen ausgeschaltet oder der Server ist älter als 8.0.3.
• Der Cloud-Endpunkt teilt mit, dass der Server offline ist: Der Server ist nicht mit iSpyConnect verbunden. Überprüfen Sie das Vorhängeschloss-Symbol in der lokalen Benutzeroberfläche und dass "Externen Zugriff blockieren" ausgeschaltet ist.
• Anzeigen der Aktivitäten des Assistenten: Stellen Sie die Protokollierung auf Debug in den Server-Einstellungen ein und öffnen Sie die Protokolle aus dem Servermenü. Auf dem lokalen Endpunkt wird jede Anfrage und jeder Werkzeugaufruf mit einem "MCP"-Präfix protokolliert, einschließlich der Argumente und der benötigten Zeit. Über den Cloud-Endpunkt werden die Werkzeuge auf iSpyConnect.com ausgeführt und der Server sieht nur die einzelnen Befehle, die sie senden, protokolliert mit einem "RelayApi"-Präfix.