Logotipo do Performance HubPerformance Hub
Seção do site: Documentação

Integrações e MCP

Nesta página

O CCTV / VSaaS expõe seus dados de forma programática por meio do MCP (Model Context Protocol) — a mesma interface de integração usada em todo o Performance Hub. A forma preferencial de desenvolver sobre a plataforma é por meio do appliance do Agente de IA, que fala MCP nativamente, mantém o contexto da instalação e pode reagir a eventos em tempo real.

Duas formas de acesso

CaminhoO que éQuando usar
O appliance do Agente de IA (preferencial)O Agente de IA da sua instalação se conecta ao Performance Hub por MCP desde o início. Faça perguntas a ele ("quem estava na instalação às 6 da manhã de hoje?"), crie automações que reagem a eventos e deixe que ele correlacione os dados do CFTV com tudo o mais que ele sabeQuase tudo — sem código, em tempo real e de forma conversacional
MCP diretoQualquer cliente ou agente compatível com MCP que se conecte com uma chave MCP do Performance HubSoftware personalizado, plataformas de agentes externas, integrações por script

O caminho do Agente de IA é o preferencial porque os eventos chegam a ele à medida que acontecem — uma detecção de pessoa, um dispositivo ficando off-line —, então as integrações criadas nele são reativas, e não baseadas em consultas periódicas. Os detalhes sobre como conectar um Agente de IA estão em Como se conectar ao Performance Hub.

Autenticação e escopo

O acesso MCP direto é autenticado com uma chave MCP pessoal (um token phk_…) gerada no seu perfil do Performance Hub. Todas as chamadas de ferramentas têm o escopo definido pelas mesmas regras da interface:

  • Você só pode consultar as instalações que sua conta pode acessar.
  • As ferramentas são liberadas por módulo: as ferramentas de visão e de pessoas exigem que a instalação tenha o CFTV e os recursos de pessoas ativados; as ferramentas de dispositivos exigem o Gerenciamento de dispositivos.
  • As chamadas estão sujeitas à mesma política de auditoria que o restante da plataforma.

Trate as chaves MCP como senhas — atribua-as a contas de serviço sempre que possível e faça a rotação delas quando houver mudanças na equipe.

O conjunto de ferramentas

O catálogo completo e sempre atualizado de ferramentas MCP — nomes, parâmetros e o que cada uma retorna — fica na documentação do MCP em Usar com IA, para que haja uma única fonte de referência a consultar. Para este módulo, as categorias relevantes são:

  • Ferramentas de CFTV — câmeras e Edge Processors, e pesquisa nas imagens gravadas por significado, a mesma pesquisa que a página do CFTV executa.
  • Ferramentas do AI Insights & People — a interface de dados de pessoas: pesquisa na linha do tempo de detecções, consulta de pessoas e da atividade de visitas delas, histórico de check-ins e instantâneos de relatórios da instalação.
  • Ferramentas do Gerenciamento de dispositivos — listagem de Edge Processors e câmeras com o status deles e envio de comandos remotos aos dispositivos.

A mesma interface MCP abrange o restante do Performance Hub — controle de portas e portões, consulta de perfis de usuário e de instalações e muito mais —, então uma integração pode abranger vários módulos: "quando uma pessoa desconhecida for detectada fora do horário de funcionamento, verifique os registros de portas e avise o gerente" é uma única automação do Agente de IA, e não três sistemas.

Padrões que funcionam bem

  • Monitoramento fora do horário de funcionamento — uma automação do Agente de IA acionada por eventos de detecção fora do horário de abertura, avisando a equipe com a câmera e o carimbo de data/hora.
  • Resumo diário — uma automação agendada que resume o dia anterior: visitas, horários de maior movimento, integridade das câmeras, envios pendentes.
  • Monitoramento da frota em escala — operadores com várias instalações consultando as ferramentas de listagem de dispositivos em todas as instalações a partir das ferramentas do NOC deles, ou deixando um Agente de IA monitorar e escalar.
  • Assistente de investigação — "mostre todas as pessoas que entraram entre 17h e 18h", respondido de forma conversacional por meio das ferramentas de pesquisa na linha do tempo de detecções, em vez de navegação manual.

O que as integrações não podem fazer

A interface MCP oferece acesso a dados e ao plano de controle. O vídeo em si — transmissões ao vivo e reprodução de gravações — é fornecido aos navegadores pelo módulo e por links de compartilhamento para convidados, e não pelo MCP. Para entregar imagens a terceiros, gere um link de compartilhamento.