Performance Hub-LogoPerformance Hub
Websitebereich: Dokumentation

Integrationen und MCP

Auf dieser Seite

CCTV / VSaaS stellt seine Daten programmatisch über MCP (Model Context Protocol) bereit – dieselbe Integrationsschnittstelle, die im gesamten Performance Hub verwendet wird. Der bevorzugte Weg, auf der Plattform aufzubauen, führt über die KI-Agent-Appliance, die MCP nativ beherrscht, den Kontext der Einrichtung kennt und in Echtzeit auf Ereignisse reagieren kann.

Zwei Zugangswege

WegWas es istWann
Die KI-Agent-Appliance (bevorzugt)Der KI-Agent Ihrer Einrichtung verbindet sich ab Werk über MCP mit dem Performance Hub. Stellen Sie ihm Fragen ("Wer war heute um 6 Uhr morgens in der Einrichtung?"), erstellen Sie Automatisierungen, die auf Ereignisse reagieren, und lassen Sie ihn Daten der Videoüberwachung mit allem anderen verknüpfen, was er weißFür fast alles – ohne Code, in Echtzeit und im Dialog
Direktes MCPJeder MCP-fähige Client oder Agent, der sich mit einem MCP-Schlüssel des Performance Hub verbindetIndividuelle Software, externe Agentenplattformen, skriptgesteuerte Integrationen

Der Weg über den KI-Agent wird bevorzugt, weil Ereignisse ihn erreichen, sobald sie eintreten – eine Personenerkennung, ein Gerät, das offline geht –, sodass dort erstellte Integrationen reaktiv sind, statt regelmäßig abzufragen. Wie Sie einen KI-Agent verbinden, erfahren Sie unter Verbindung mit dem Performance Hub.

Authentifizierung und Geltungsbereich

Der direkte MCP-Zugriff authentifiziert sich mit einem persönlichen MCP-Schlüssel (einem phk_…-Token), den Sie in Ihrem Performance Hub-Profil erzeugen. Für jeden Tool-Aufruf gelten dieselben Regeln wie in der Oberfläche:

  • Sie können nur Einrichtungen abfragen, auf die Ihr Konto Zugriff hat.
  • Tools sind an Module gebunden: Die Vision- und Personentools setzen voraus, dass die Einrichtung die Videoüberwachung und die Personenfunktionen aktiviert hat; Gerätetools setzen die Geräteverwaltung voraus.
  • Aufrufe unterliegen denselben Prüf- und Protokollierungsregeln wie der Rest der Plattform.

Behandeln Sie MCP-Schlüssel wie Passwörter – ordnen Sie sie nach Möglichkeit Dienstkonten zu und erneuern Sie sie, wenn sich das Personal ändert.

Die verfügbaren Tools

Der vollständige, stets aktuelle Katalog der MCP-Tools – Namen, Parameter und was jedes Tool zurückgibt – befindet sich in der MCP-Dokumentation unter Mit KI verwenden, damit es eine einzige verbindliche Quelle gibt. Für dieses Modul sind folgende Kategorien relevant:

  • Tools der Videoüberwachung – Kameras und Edge Processors sowie die Suche in aufgezeichnetem Videomaterial nach Bedeutung, dieselbe Suche, die die Seite der Videoüberwachung ausführt.
  • Tools für AI Insights & People – der Zugang zu Personendaten: Durchsuchen der Erkennungszeitachse, Nachschlagen von Personen und ihrer Besuchsaktivität, Check-in-Verlauf und Momentaufnahmen von Einrichtungsberichten.
  • Tools der Geräteverwaltung – Auflisten von Edge Processors und Kameras mit ihrem Status und Senden von Remote-Befehlen an Geräte.

Dieselbe MCP-Schnittstelle umfasst auch den Rest des Performance Hub – Tür- und Torsteuerung, Abfrage von Benutzerprofilen und Einrichtungen und mehr –, sodass eine Integration mehrere Module umfassen kann: "Wenn nach Geschäftsschluss eine unbekannte Person erkannt wird, die Türprotokolle prüfen und die Leitung benachrichtigen" ist eine einzige KI-Agent-Automatisierung, nicht drei Systeme.

Bewährte Muster

  • Überwachung außerhalb der Öffnungszeiten – eine KI-Agent-Automatisierung für Erkennungsereignisse außerhalb der Öffnungszeiten, die das Personal mit Kamera und Zeitstempel benachrichtigt.
  • Tägliche Zusammenfassung – eine geplante Automatisierung, die den Vortag zusammenfasst: Besuche, stärkste Stunden, Kamerazustand, Upload-Rückstand.
  • Überwachung des Gerätebestands im großen Maßstab – Betreiber mehrerer Einrichtungen fragen die Tools zur Geräteauflistung über alle Einrichtungen hinweg aus ihren NOC-Tools ab oder lassen einen KI-Agent überwachen und eskalieren.
  • Assistent für Untersuchungen – "Zeig mir alle, die zwischen 17 und 18 Uhr hereingekommen sind" wird im Dialog über die Suchtools der Erkennungszeitachse beantwortet, statt manuell durchzuspulen.

Was Integrationen nicht können

Die MCP-Schnittstelle bietet Zugriff auf Daten und die Steuerungsebene. Das Video selbst – Live-Streams und die Wiedergabe von Aufzeichnungen – wird Browsern über das Modul und Gastfreigabelinks bereitgestellt, nicht über MCP. Um Videomaterial an Dritte weiterzugeben, erstellen Sie einen Freigabelink.