Logotipo de Performance HubPerformance Hub
Sección del sitio: Documentación

Integraciones y MCP

En esta página

CCTV / VSaaS expone sus datos de forma programática mediante MCP (Model Context Protocol), la misma interfaz de integración que se usa en todo Performance Hub. La forma preferida de crear integraciones sobre la plataforma es mediante el dispositivo de Agente de IA, que habla MCP de forma nativa, conoce el contexto de la instalación y puede reaccionar a los eventos en tiempo real.

Dos vías de acceso

VíaQué esCuándo
El dispositivo de Agente de IA (preferido)El Agente de IA de tu instalación se conecta a Performance Hub mediante MCP desde el primer momento. Hazle preguntas ("¿quién estaba en la instalación a las 6 de esta mañana?"), crea automatizaciones que reaccionen a eventos y deja que relacione los datos de CCTV con todo lo demás que sabeCasi todo: sin código, en tiempo real y conversacional
MCP directoCualquier cliente o agente compatible con MCP que se conecte con una clave MCP de Performance HubSoftware personalizado, plataformas de agentes externas, integraciones mediante scripts

Se prefiere la vía del Agente de IA porque los eventos le llegan a medida que ocurren (una detección de persona, un dispositivo que se desconecta), por lo que las integraciones creadas allí son reactivas, no basadas en consultas periódicas. Los detalles para conectar un Agente de IA están en Conectarse a Performance Hub.

Autenticación y alcance

El acceso MCP directo se autentica con una clave MCP personal (un token phk_…) generada desde tu perfil de Performance Hub. Cada llamada a una herramienta tiene el mismo alcance que la interfaz:

  • Solo puedes consultar las instalaciones a las que tu cuenta tiene acceso.
  • Las herramientas están restringidas por módulo: las herramientas de visión y de personas requieren que la instalación tenga habilitados CCTV y las funciones de personas; las herramientas de dispositivos requieren Gestión de dispositivos.
  • Las llamadas están sujetas a la misma auditoría que el resto de la plataforma.

Trata las claves MCP como contraseñas: asígnalas a cuentas de servicio siempre que sea posible y rótalas cuando cambie el personal.

Las herramientas disponibles

El catálogo completo y siempre actualizado de herramientas MCP (nombres, parámetros y lo que devuelve cada una) se encuentra en la documentación de MCP en Uso con IA, para que haya una única fuente de referencia. Para este módulo, las categorías relevantes son:

  • Herramientas de CCTV: cámaras y Edge Processor, y búsqueda de imágenes grabadas por significado, la misma búsqueda que ejecuta la página de CCTV.
  • Herramientas de AI Insights & People: los datos de personas: búsqueda en la cronología de detecciones, consulta de personas y de su actividad de visitas, historial de registros de entrada e instantáneas de informes de la instalación.
  • Herramientas de Gestión de dispositivos: listado de los Edge Processor y las cámaras con su estado, y envío de comandos remotos a los dispositivos.

La misma interfaz MCP abarca el resto de Performance Hub (control de puertas y portones, consulta de perfiles de usuario e instalaciones, y más), por lo que una integración puede abarcar varios módulos: "cuando se detecte a una persona desconocida fuera del horario, revisa los registros de las puertas y avisa al gerente" es una sola automatización del Agente de IA, no tres sistemas.

Patrones que funcionan bien

  • Supervisión fuera del horario: una automatización del Agente de IA sobre los eventos de detección fuera del horario de apertura, que avisa al personal con la cámara y la marca de tiempo.
  • Resumen diario: una automatización programada que resume el día anterior: visitas, horas de mayor actividad, estado de las cámaras, cargas pendientes.
  • Supervisión de flotas a escala: operadores con varias instalaciones que consultan las herramientas de listado de dispositivos en todas sus instalaciones desde las herramientas de su NOC, o que dejan que un Agente de IA vigile y escale los problemas.
  • Asistente de investigación: "muéstrame a todas las personas que entraron entre las 5 y las 6 pm", respondido de forma conversacional mediante las herramientas de búsqueda en la cronología de detecciones, en lugar de revisar manualmente.

Lo que no pueden hacer las integraciones

La interfaz MCP ofrece acceso a los datos y al plano de control. El video en sí (transmisiones en vivo y reproducción de grabaciones) se sirve a los navegadores a través del módulo y de los enlaces para compartir con invitados, no mediante MCP. Para entregar imágenes a un tercero, genera un enlace para compartir.