Logo Performance HubPerformance Hub
Section du site : Documentation

Intégrations et MCP

Sur cette page

CCTV / VSaaS expose ses données de manière programmatique via MCP (Model Context Protocol), la même interface d'intégration que celle utilisée dans l'ensemble du Performance Hub. La méthode privilégiée pour développer sur la plateforme passe par l'appareil Agent IA, qui parle MCP nativement, connaît le contexte de l'installation et peut réagir aux événements en temps réel.

Deux points d'entrée

VoieDescriptionQuand l'utiliser
L'appareil Agent IA (privilégié)L'Agent IA de votre installation se connecte au Performance Hub via MCP dès sa mise en service. Posez-lui des questions (« qui était dans l'installation à 6 h ce matin ? »), créez des automatisations qui réagissent aux événements, et laissez-le croiser les données de vidéosurveillance avec tout ce qu'il sait par ailleursPresque tous les cas : sans code, en temps réel et conversationnel
MCP directTout client ou agent compatible MCP qui se connecte avec une clé MCP Performance HubLogiciels personnalisés, plateformes d'agents externes, intégrations scriptées

La voie de l'Agent IA est privilégiée parce que les événements lui parviennent au moment où ils se produisent (une détection de personne, un appareil qui passe hors ligne) : les intégrations qui y sont créées sont donc réactives, et non fondées sur l'interrogation périodique. Les détails de la connexion d'un Agent IA figurent dans Se connecter au Performance Hub.

Authentification et périmètre

L'accès MCP direct s'authentifie avec une clé MCP personnelle (un jeton phk_…) générée depuis votre profil Performance Hub. Chaque appel d'outil est limité par les mêmes règles que l'interface :

  • Vous ne pouvez interroger que les installations auxquelles votre compte a accès.
  • Les outils dépendent des modules : les outils de vision et de personnes nécessitent que l'installation dispose de la vidéosurveillance et des fonctionnalités liées aux personnes ; les outils d'appareils nécessitent Gestion d'appareils.
  • Les appels sont soumis au même régime d'audit que le reste de la plateforme.

Traitez les clés MCP comme des mots de passe : attribuez-les à des comptes de service lorsque c'est possible et renouvelez-les lorsque le personnel change.

L'ensemble des outils

Le catalogue complet et toujours à jour des outils MCP (noms, paramètres et données renvoyées par chacun) se trouve dans la documentation MCP, sous Utilisation avec l'IA, afin de disposer d'une source de référence unique. Pour ce module, les catégories pertinentes sont les suivantes :

  • Outils de vidéosurveillance : les caméras et les Edge Processors, ainsi que la recherche sémantique dans les images enregistrées, la même recherche que celle de la page de vidéosurveillance.
  • Outils AI Insights & People : l'interface des données sur les personnes : recherche dans la chronologie des détections, consultation des personnes et de leurs visites, historique des enregistrements d'arrivée et instantanés des rapports d'installation.
  • Outils Gestion d'appareils : la liste des Edge Processors et des caméras avec leur état, et l'envoi de commandes à distance aux appareils.

La même interface MCP couvre le reste du Performance Hub (contrôle des portes et des portails, consultation des profils utilisateur et des installations, et plus encore) : une intégration peut donc couvrir plusieurs modules. « Lorsqu'une personne inconnue est détectée en dehors des heures d'ouverture, consulter les journaux des portes et prévenir le responsable » constitue une seule automatisation de l'Agent IA, et non trois systèmes.

Scénarios efficaces

  • Surveillance en dehors des heures d'ouverture : une automatisation de l'Agent IA sur les événements de détection en dehors des heures d'ouverture, qui prévient le personnel en indiquant la caméra et l'horodatage.
  • Résumé quotidien : une automatisation planifiée qui résume la veille : visites, heures d'affluence, état des caméras, retard de téléversement.
  • Surveillance de parc à grande échelle : les opérateurs multi-installations interrogent les outils de liste des appareils de toutes leurs installations depuis les outils de leur NOC, ou laissent un Agent IA surveiller et faire remonter les incidents.
  • Assistant d'enquête : « montre-moi toutes les personnes entrées entre 17 h et 18 h » obtient une réponse conversationnelle grâce aux outils de recherche dans la chronologie des détections, au lieu d'un parcours manuel des images.

Ce que les intégrations ne peuvent pas faire

L'interface MCP donne accès aux données et au plan de contrôle. La vidéo elle-même (flux en direct et lecture des enregistrements) est diffusée aux navigateurs via le module et les liens de partage invité, et non via MCP. Pour transmettre des images à un tiers, générez un lien de partage.