Performance Hub-logoPerformance Hub
Sitesectie: Documentatie

Integraties en MCP

Op deze pagina

CCTV / VSaaS stelt zijn gegevens programmatisch beschikbaar via MCP (Model Context Protocol), dezelfde integratielaag die in heel Performance Hub wordt gebruikt. De voorkeursmanier om op het platform te bouwen is via het AI-agent-apparaat, dat standaard MCP spreekt, de context van de faciliteit kent en in realtime op gebeurtenissen kan reageren.

Twee toegangswegen

RouteWat het isWanneer
Het AI-agent-apparaat (voorkeur)De AI-agent van je faciliteit maakt direct via MCP verbinding met Performance Hub. Stel er vragen aan ("wie was er vanochtend om 6 uur in de faciliteit?"), bouw automatiseringen die op gebeurtenissen reageren, en laat de agent gegevens van Camerabewaking koppelen aan alles wat hij verder weetVrijwel alles: geen code, realtime en conversationeel
Directe MCPElke client of agent met MCP-ondersteuning die verbinding maakt met een MCP-sleutel van Performance HubMaatwerksoftware, externe agentplatforms, gescripte integraties

De route via de AI-agent heeft de voorkeur omdat gebeurtenissen er direct naartoe stromen wanneer ze plaatsvinden (een persoonsdetectie, een apparaat dat offline gaat), zodat integraties die daar zijn gebouwd reactief zijn in plaats van periodiek te pollen. De details over het verbinden van een AI-agent staan in Verbinding maken met Performance Hub.

Authenticatie en afbakening

Directe MCP-toegang authenticeert met een persoonlijke MCP-sleutel (een phk_…-token) die je in je profiel in Performance Hub genereert. Elke toolaanroep is afgebakend volgens dezelfde regels als de gebruikersinterface:

  • Je kunt alleen faciliteiten waartoe je account toegang heeft bevragen.
  • Tools zijn beperkt per module: voor de beeld- en personentools moet de faciliteit Camerabewaking en de personenfuncties hebben ingeschakeld; apparaattools vereisen Apparaatbeheer.
  • Voor aanroepen geldt hetzelfde auditbeleid als voor de rest van het platform.

Behandel MCP-sleutels als wachtwoorden: koppel ze waar mogelijk aan serviceaccounts en vervang ze wanneer er personeelswisselingen zijn.

De beschikbare tools

De volledige, altijd actuele catalogus van MCP-tools (namen, parameters en wat elke tool teruggeeft) staat in de MCP-documentatie onder Gebruik met AI, zodat er één bron is om te raadplegen. Voor deze module zijn de relevante categorieën:

  • Tools voor Camerabewaking: camera's en Edge Processors, en opgenomen beelden doorzoeken op betekenis, dezelfde zoekfunctie als op de pagina van Camerabewaking.
  • Tools voor AI Insights & People: de gegevens over personen: de detectietijdlijn doorzoeken, personen en hun bezoekactiviteit opzoeken, de check-ingeschiedenis en momentopnamen van rapporten van de faciliteit.
  • Tools voor Apparaatbeheer: Edge Processors en camera's met hun status weergeven en opdrachten op afstand naar apparaten sturen.

Dezelfde MCP-laag omvat de rest van Performance Hub (bediening van deuren en poorten, gebruikersprofielen en faciliteiten opzoeken, en meer), zodat een integratie meerdere modules kan beslaan: "wanneer er buiten openingstijden een onbekende persoon wordt gedetecteerd, controleer de deurlogboeken en breng de manager op de hoogte" is één automatisering van de AI-agent, geen drie systemen.

Patronen die goed werken

  • Monitoring buiten openingstijden: een automatisering van de AI-agent op detectiegebeurtenissen buiten de openingstijden, die medewerkers op de hoogte brengt met de camera en het tijdstip.
  • Dagelijkse samenvatting: een geplande automatisering die gisteren samenvat: bezoeken, drukste uren, camerastatus, uploadachterstand.
  • Grootschalige monitoring van apparaten: organisaties met meerdere faciliteiten die de tools voor apparaatoverzichten voor al hun faciliteiten bevragen vanuit hun NOC-tools, of een AI-agent laten meekijken en escaleren.
  • Onderzoeksassistent: "laat iedereen zien die tussen 17.00 en 18.00 uur binnenkwam", conversationeel beantwoord via de zoektools voor de detectietijdlijn, in plaats van handmatig door beelden te scrollen.

Wat integraties niet kunnen

De MCP-laag biedt toegang tot gegevens en de beheerlaag. Video zelf (livestreams en het afspelen van opnamen) wordt via de module en deellinks voor gasten aan browsers geleverd, niet via MCP. Genereer een deellink om beelden aan een externe partij te geven.