Logo di Performance HubPerformance Hub
Sezione del sito: Documentazione

Integrazioni e MCP

In questa pagina

CCTV / VSaaS espone i propri dati in modo programmatico tramite MCP (Model Context Protocol), la stessa interfaccia di integrazione usata in tutto il Performance Hub. Il modo preferito per sviluppare sulla piattaforma è tramite l'appliance Agente AI, che parla MCP in modo nativo, conosce il contesto della struttura e può reagire agli eventi in tempo reale.

Due modi di accesso

PercorsoChe cos'èQuando usarlo
L'appliance Agente AI (preferito)L'Agente AI della tua struttura si connette al Performance Hub tramite MCP senza alcuna configurazione aggiuntiva. Fagli domande ("chi era nella struttura alle 6 di stamattina?"), crea automazioni che reagiscono agli eventi e lascia che metta in relazione i dati TVCC con tutto ciò che conosceQuasi sempre: senza codice, in tempo reale e in forma di conversazione
MCP direttoQualsiasi client o agente compatibile con MCP che si connette con una chiave MCP del Performance HubSoftware personalizzato, piattaforme di agenti esterne, integrazioni basate su script

Il percorso tramite Agente AI è preferito perché gli eventi gli arrivano nel momento in cui si verificano (il rilevamento di una persona, un dispositivo che va offline), quindi le integrazioni create in questo modo sono reattive e non basate su interrogazioni periodiche. I dettagli sulla connessione di un Agente AI si trovano in Connessione al Performance Hub.

Autenticazione e ambito

L'accesso MCP diretto si autentica con una chiave MCP personale (un token phk_…) generata dal tuo profilo del Performance Hub. Ogni chiamata a uno strumento è soggetta alle stesse regole dell'interfaccia:

  • Puoi interrogare solo le strutture a cui il tuo account ha accesso.
  • Gli strumenti sono vincolati ai moduli: gli strumenti di visione e relativi alle persone richiedono che la struttura abbia attivato la TVCC e le funzionalità relative alle persone; gli strumenti per i dispositivi richiedono Gestione dei dispositivi.
  • Le chiamate sono soggette agli stessi controlli del resto della piattaforma.

Tratta le chiavi MCP come password: assegnale ad account di servizio quando possibile e rinnovale quando cambia il personale.

L'interfaccia degli strumenti

Il catalogo completo e sempre aggiornato degli strumenti MCP (nomi, parametri e cosa restituisce ciascuno) si trova nella documentazione MCP in Uso con l'AI, così c'è un'unica fonte di riferimento da consultare. Per questo modulo, le categorie pertinenti sono:

  • Strumenti TVCC: telecamere ed Edge Processor e la ricerca semantica nelle riprese registrate, la stessa ricerca eseguita dalla pagina TVCC.
  • Strumenti AI Insights & People: l'interfaccia dei dati sulle persone: ricerca nella timeline dei rilevamenti, consultazione delle persone e delle loro visite, cronologia dei check-in e istantanee dei report della struttura.
  • Strumenti di Gestione dei dispositivi: elenco degli Edge Processor e delle telecamere con il relativo stato e invio di comandi remoti ai dispositivi.

La stessa interfaccia MCP comprende il resto del Performance Hub (controllo di porte e cancelli, consultazione dei profili utente e delle strutture e altro ancora), quindi un'integrazione può estendersi su più moduli: "quando viene rilevata una persona sconosciuta fuori orario, controlla i registri delle porte e avvisa il responsabile" è un'unica automazione dell'Agente AI, non tre sistemi diversi.

Schemi che funzionano bene

  • Monitoraggio fuori orario: un'automazione dell'Agente AI sugli eventi di rilevamento al di fuori degli orari di apertura, che avvisa il personale indicando la telecamera e l'ora.
  • Riepilogo giornaliero: un'automazione pianificata che riassume la giornata precedente: visite, ore di maggiore affluenza, stato delle telecamere, arretrato dei caricamenti.
  • Monitoraggio della flotta su larga scala: operatori con più strutture che interrogano gli strumenti di elenco dei dispositivi in tutte le strutture dai propri strumenti NOC, oppure lasciano che un Agente AI sorvegli e segnali i problemi.
  • Assistente per le indagini: "mostrami tutti quelli che sono entrati tra le 17 e le 18" ottiene risposta in forma di conversazione tramite gli strumenti di ricerca nella timeline dei rilevamenti, invece di scorrere manualmente le riprese.

Cosa non possono fare le integrazioni

L'interfaccia MCP offre accesso ai dati e al piano di controllo. Il video vero e proprio (flussi dal vivo e riproduzione delle registrazioni) viene fornito ai browser tramite il modulo e i link di condivisione per ospiti, non tramite MCP. Per consegnare riprese a una parte esterna, genera un link di condivisione.