Intégrations: Assistants IA

Agent DVR peut être utilisé directement à partir d'assistants IA tels que Claude, ChatGPT, Cursor et VS Code Copilot. Posez des questions en langage naturel - « quelles alertes ai-je eues la nuit dernière ? », « montre-moi ce qui s'est passé sur la caméra de l'allée ce matin », « désactive les caméras du garage » - et l'assistant répond à partir de vos caméras en direct, de vos enregistrements et de votre journal des alertes, y compris les images.

Cela fonctionne par le Model Context Protocol (MCP), la norme ouverte que les assistants utilisent pour se connecter aux outils externes. Agent DVR fournit un serveur MCP à deux endroits, et vous connectez votre assistant à celui qui vous convient :

• Intégré à Agent DVR (Point de terminaison local) : fourni par votre propre serveur sur votre réseau local. Aucun compte ou abonnement nécessaire. Pour les assistants s'exécutant sur le même ordinateur ou sur le LAN.
• Via iSpyConnect.com (Point de terminaison cloud) : accède à vos serveurs via l'accès à distance que le portail web et les applications mobiles utilisent, de n'importe où, sans redirection de port. Nécessite un abonnement iSpyConnect. C'est celui à utiliser pour claude.ai, ChatGPT et les téléphones.

Les deux exposent le même ensemble d'outils. Nécessite Agent DVR 8.0.3 ou version ultérieure.

Chaque serveur Agent DVR propose MCP à l'adresse /mcp sur son serveur Web local, donc si vous ouvrez l'interface Agent DVR à l'adresse http://localhost:8090, le point de terminaison est http://localhost:8090/mcp (utilisez l'adresse et le port de votre serveur depuis un autre ordinateur du réseau local, par exemple http://192.168.1.10:8090/mcp). Il est activé par défaut et peut être désactivé via Point de terminaison Assistant IA (MCP) dans Paramètres du serveur - Serveur local.

L'accès suit exactement les mêmes règles que le reste de l'API locale : depuis votre propre réseau, aucune connexion n'est nécessaire, sauf si Protéger l'API est activé, auquel cas l'assistant doit envoyer le nom d'utilisateur et le mot de passe d'un utilisateur administrateur (la plupart des clients MCP vous permettent d'ajouter un en-tête d'autorisation). Les connexions en provenance de l'extérieur de votre réseau nécessitent en outre une licence, de la même manière que l'accès par redirection de port à l'interface.

Claude Code

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

Cursor

Ajoutez à .cursor/mcp.json (ou via Paramètres - MCP) :

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

VS Code (Copilot)

Ajoutez à .vscode/mcp.json :

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

Claude Desktop

L'application de bureau Claude ne peut pas appeler directement un serveur sur votre propre ordinateur. Elle utilise donc une petite extension qui le fait pour vous. Téléchargez AgentDVR.mcpb, puis dans Claude Desktop ouvrez Paramètres - Extensions et glissez le fichier sur la page. Il s'installe activé et se connecte à http://localhost:8090/mcp ; cliquez sur Configurer uniquement si votre serveur se trouve sur un autre ordinateur ou si la protection de l'API est activée. Claude demande une permission la première fois que chaque outil est utilisé - choisissez « Toujours autoriser » pour arrêter les invites.

Autres assistants

Tout client prenant en charge MCP sur HTTP (« HTTP diffusable ») peut utiliser la même URL. Recherchez « Serveurs MCP », « connecteurs » ou « outils » dans les paramètres de l'assistant.

L'application web Claude et les applications mobiles, ainsi que ChatGPT, ne peuvent pas accéder à un serveur sur votre propre réseau du tout ; elles utilisent le Point de terminaison Cloud.

Avec un abonnement iSpyConnect, vos serveurs sont également accessibles à :

https://www.ispyconnect.com/mcp

Ajoutez cette URL en tant que connecteur personnalisé ou serveur MCP dans votre assistant (par exemple Paramètres - Connecteurs sur claude.ai et les applications Claude, ou l'équivalent dans ChatGPT et Cursor). L'assistant ouvre une page de connexion iSpyConnect ; connectez-vous, choisissez si vous souhaitez autoriser le contrôle ainsi que la visualisation, et cliquez sur Autoriser. Aucune autre configuration n'est nécessaire : chaque serveur Agent DVR connecté à votre compte avec l'accès à distance activé est disponible, et l'assistant vous demandera lequel vous voulez dire si vous en avez plus d'un.

Les demandes transitent par le même relais que celui utilisé par le portail web, donc aucune redirection de port n'est nécessaire et votre serveur n'est jamais exposé à Internet. L'accès s'arrête quand votre abonnement expire, et l'accès de chaque assistant peut être supprimé à partir des paramètres du connecteur de l'assistant lui-même à tout moment.

Votre serveur doit être en cours d'exécution et connecté à iSpyConnect (l'icône de cadenas dans l'interface locale affiche l'état de la connexion à distance). Bloquer l'accès externe dans les Paramètres du serveur bloque également ce point de terminaison.

Les assistants accèdent à un petit ensemble d'outils créés spécifiquement plutôt qu'à l'API brute, afin que les réponses restent rapides et économiques :

• Consultation : afficher vos Serveurs et Périphériques (avec Emplacement et état), obtenir un résumé d'Activité (Enregistrements et Alertes par Caméra par heure, avec les éléments détectés), lister les Enregistrements dans une fenêtre temporelle, voir une fenêtre complète d'un coup d'œil sous forme de grille d'images, voir une Caméra sur un jour sous forme de Chronologie d'images, échantillonner des images d'un Enregistrement, prendre un instantané en direct d'une Caméra, lire le journal d'Alerte et obtenir un lien pour ouvrir un Enregistrement dans l'interface web.
• Contrôle : activer et désactiver le serveur, appliquer des profils, activer ou désactiver les périphériques, modifier les modes d'enregistrement, activer ou désactiver les alertes et les détecteurs, déplacer les caméras PTZ vers les préréglages, et autres changements d'état à partir de l'API.
• Tout le reste : un catalogue de commandes supplémentaires de lecture et de contrôle que l'assistant peut appeler quand aucun outil dédié ne convient (statistiques système, état complet d'un périphérique, préréglages PTZ, etc.).

L'assistant ne peut pas effacer d'enregistrements ou de photos, modifier la configuration d'un périphérique ou d'un serveur, ajouter ou supprimer des périphériques, ni redémarrer le serveur : ces commandes ne sont volontairement pas proposées, quel que soit le point de terminaison utilisé. Sur le point de terminaison cloud, l'affichage et le contrôle sont des autorisations distinctes que vous accordez sur la page de connexion, et l'utilisation est limitée en débit pour protéger le relais.

Invites d'exemple

• « Quelqu'un a-t-il sonné à la porte d'entrée au cours des 24 dernières heures ? Montre-moi. »
• « Quels oiseaux ont visité la mangeoire ce matin ? »
• « Quel était le trafic dans l'allée aujourd'hui, et à quel moment ? »
• « Montre-moi le jardin de derrière sur toute la journée. Quand a-t-il commencé à pleuvoir ? »
• « Quelles Alertes ai-je eu hier, et y en avait-il concernant des Personnes ? »
• « Qui est à la porte d'entrée en ce moment ? »
• « Quelles caméras sont hors ligne ? »
• « Nous partons - activez tout avec le Profil Absence. »
• « Désactive toutes les caméras dans l'emplacement maison. »
• « Envoie-moi un lien vers le clip du coursier. »

Flux de travail prêts à l'emploi

Le Serveur propose aussi des modèles d'Invite que les assistants compatibles avec les Invites (Claude Desktop, Claude Code, Cursor et autres) affichent comme commandes slash ou dans un menu. Chacun exécute un flux de travail complet multi-étapes et signale le Résultat :

• morning_briefing - ce que les Caméras ont enregistré depuis hier soir : Activité, Alertes, Personnes, véhicules et animaux notables, et état de santé des Caméras.
• door_report - qui s'est présenté à une porte (Caméra), avec les heures, ce que chaque visiteur a fait et un lien vers chaque clip.
• wildlife_report - quels animaux et oiseaux une Caméra a captés, identifiés aussi précisément que le permet le film.
• camera_health - tous les Serveurs et Caméras vérifiés pour Hors ligne, Désactivé, erreurs et Caméras silencieuses.
• day_in_review - une Caméra sur toute une journée sous forme de Chronologie d'images, avec un récit de la façon dont la scène a changé.

• L'assistant ne peut pas se connecter au point de terminaison local : vérifiez l'URL dans un navigateur - http://localhost:8090/mcp devrait répondre (un message d'erreur est acceptable ; « connexion refusée » ne l'est pas). Assurez-vous que le port correspond aux Paramètres du serveur - Serveur local et que le point de terminaison y est activé.
• 401 Non autorisé : Protéger l'API est activé, donc l'assistant doit envoyer les identifiants d'un utilisateur administrateur, ou vous vous connectez depuis l'extérieur de votre réseau.
• 403 Accès interdit : connexion depuis l'extérieur de votre réseau sans licence. Utilisez plutôt le Point de terminaison cloud.
• 404 Non trouvé : le point de terminaison est désactivé dans les Paramètres du serveur, ou le serveur est plus ancien que 8.0.3.
• Le point de terminaison cloud indique que le serveur est hors ligne : le serveur n'est pas connecté à iSpyConnect. Vérifiez l'icône de cadenas dans l'interface locale et que Bloquer l'accès externe est désactivé.
• Voir ce que fait l'assistant : définissez la Journalisation sur Débogage dans les Paramètres du serveur et ouvrez les Journaux depuis le Menu du serveur. Sur le point de terminaison local, chaque demande et appel d'outil est enregistré avec un préfixe « MCP », y compris les arguments et le temps d'exécution. Via le point de terminaison cloud, les outils s'exécutent sur iSpyConnect.com et le serveur ne voit que les Commandes individuelles qu'ils envoient, enregistrées avec un préfixe « RelayApi ».