API ou MCP para consumir as detecções das câmeras da loja, no Visio OS

por Lorenzo Lopez Head of Content, Visio 29 de out. de 2026

No Visio OS, a resposta são as duas portas, cada uma no seu trabalho: o MCP é a porta da sua IA e a API é a porta do seu aplicativo. A camada de Sensores serve as detecções das câmeras que a loja já tem pelos dois caminhos. Pelo MCP, a IA que você já usa acessa o catálogo de detecções e as detecções que rodam na operação, com o seu login e as suas permissões. Pela API, o seu aplicativo consome as mesmas detecções, estruturadas, no lugar onde você constrói.

Visio aqui é a Visio de operação de lojas (visio.ai), o sistema para quem toca várias lojas, não o Visio da Microsoft, de diagramas. Este guia é para quem constrói: o TI da franqueadora, o integrador e quem codifica para a própria rede. Ele não repete como conectar a sua IA nas câmeras da minha loja, que compara os caminhos para ligar uma IA às câmeras. Aqui a pergunta é uma só: com a detecção já existindo, por qual porta ela chega até você.

Por que a escolha entre API e MCP importa

Quem constrói com câmeras já instaladas tem duas necessidades sob o mesmo nome. A primeira é descobrir: o que dá para detectar, o que já roda numa operação e o que custaria rodar uma detecção nova. A segunda é consumir: ter a detecção chegando, estruturada e com horário, dentro de um aplicativo que alguém abre todos os dias. Tratar as duas como uma só leva a usar a porta errada nas duas.

Descobrir é uma conversa, e quem conversa é a sua IA. Consumir é uma rotina, e quem a executa é o seu código. A camada de Sensores do Visio OS desenha uma porta para cada uma, e o que as liga é a detecção, a mesma nos dois lados.

Sem uma camada servida, cada detecção nova nasce como projeto: filmagem, rótulos, modelo, integração com a câmera e um lugar para o dado cair. Com ela, quem constrói faz a ferramenta e não o conjunto de modelos por baixo. A Visio rotula os dados e treina os modelos em casa, e quem constrói nunca rotula um quadro nem roda um treino. A segunda ferramenta sobre o mesmo sensor custa uma fração da primeira, porque o hardware, o pipeline e o catálogo já estão lá.

Como avaliar a porta de acesso às detecções

Seis critérios separam as portas, e cada um vira uma linha do comparativo mais abaixo.

Quem pergunta. Uma pessoa, pela IA que já usa, ou um código que roda sozinho.
Quem define a detecção. Descrever o que observar em linguagem natural ou consumir uma detecção que já existe.
O que volta. O catálogo e a detecção, ou só a detecção estruturada e com horário.
De quem é a permissão. A de quem pergunta, por usuário, por loja e por app, aplicada no dado.
Onde o dado cai. Num console à parte ou junto com os outros dados da operação.
Quem mantém a detecção. Quem rotula, treina e mantém o pipeline, o fluxo que liga a câmera à resposta.

Principais opções para consumir as detecções das câmeras

Quatro portas existem, e as duas primeiras não são da Visio. Cada uma resolve algo de verdade, e o que as separa é de quem é a detecção que passa por ela.

1. A API do gravador ou do software de câmera

As documentações oficiais, lidas em 11 de outubro de 2026, descrevem portas abertas e documentadas:

O Shinobi descreve uma API REST em que tudo o que o painel oficial faz passa pela API, com chaves geradas pela interface ou pela própria API.
O ZoneMinder oferece um serviço REST para monitores, eventos, quadros e zonas, com tokens JWT na versão 2.0 da API.
O Agent DVR diz ter uma API HTTP REST completa para controlar câmeras, gravação e o resto do sistema.
O Frigate publica uma API HTTP documentada, com grupos para eventos, gravações, exportação e revisão.
A Axis documenta o VAPIX, uma interface de programação aberta que dá acesso e controle diretos aos dispositivos Axis, com documentação pública sem login.

Para quem constrói, é uma boa porta para aprender o domínio. O que ela devolve é o que aquele software conhece: câmeras, gravações, eventos e o controle do aparelho. A detecção da sua pergunta, como a fila no balcão ou a loja abrindo no horário, é trabalho de quem constrói, com modelo, filtros e manutenção. Nas páginas lidas do Shinobi, do ZoneMinder e do Agent DVR, o MCP não aparece.

2. Um servidor MCP de terceiro

O Home Assistant traz uma integração oficial de servidor MCP que, segundo a documentação lida em 11 de outubro de 2026, deixa conectar um agente de IA ao sistema. Foi introduzida na versão 2025.2 e expõe só as entidades que a pessoa escolhe, em ferramentas, prompts e um recurso de contexto. A API REST do mesmo sistema devolve a imagem de uma câmera exposta e pede um token de acesso de longa duração.

É uma boa porta para quem já roda o Home Assistant: a sua IA conversa com o que você expôs. O que ela encontra são entidades e imagens, e a detecção da sua pergunta continua sendo sua.

3. O MCP da camada de Sensores do Visio OS

Pelo MCP, a IA que você já usa acessa o catálogo da camada e as detecções que rodam na sua operação. Ela descreve o que quer detectar, em linguagem natural, e o pipeline é montado a partir do catálogo. O custo de rodar é declarado antes de rodar. A pergunta segue o login e as permissões de quem pergunta, por usuário e por loja, e o que volta é a detecção, estruturada e com horário.

A sua IA tem acesso às câmeras. Ela lê primeiro os sinais detectados, junto com os outros dados da operação, e abre o vídeo no momento em que precisa de certeza para concluir. O motor por trás é o Visio Cortex, o motor da Camada de Sensores: conecta qualquer sensor, guarda o catálogo de detecções e monta o pipeline. A definição do catálogo está em o que é um catálogo de detecções, e a da camada, em o que é camada de sensores.

4. A API da camada de Sensores do Visio OS

Pela API, o seu aplicativo consome as mesmas detecções, estruturadas, no lugar onde você constrói. É a porta da rotina: a pergunta já foi feita, a detecção já roda, e o aplicativo precisa recebê-la estruturada e com horário. O dado também cai na camada de Dados, junto com os outros dados da operação, e vira tarefa pra pessoa certa pela Orquestração. Quem constrói recebe a detecção servida, sem montar nem manter o conjunto de modelos.

Como os dois caminhos da camada se combinam

A ordem natural é o MCP primeiro e a API depois. Primeiro vem a pergunta: você descreve na sua IA o que quer detectar e vê o que o motor já consegue rodar, onde ele precisa de treino e quanto custa rodar. Depois vem a rotina: com a detecção rodando nas câmeras da loja, o seu aplicativo consome o resultado pela API. São dois caminhos a partir de uma pergunta.

Contado uma vez: a pergunta é «quero contar as pessoas na fila do balcão». O MCP leva a descrição ao catálogo, que junta detecção de pessoa, acompanhamento e uma regra de zona na câmera que já está em cima do balcão. A contagem por loja e por hora cai na camada de Dados. Quando a fila passa do limite, uma tarefa chega ao gerente, e a mesma contagem aparece, pela API, no painel de quem constrói.

O custo de rodar vem declarado antes de a detecção rodar na sua loja, nas duas portas.

Comparativo entre as portas de acesso

A tabela aplica os seis critérios às quatro portas. As duas primeiras colunas resumem o que a documentação lida diz, e as duas últimas descrevem o desenho da camada de Sensores.

Critério	API do gravador ou do software de câmera	Servidor MCP de terceiro (Home Assistant)	MCP da camada de Sensores	API da camada de Sensores
Quem pergunta	O seu código	Uma IA conectada	A IA que você já usa, com o seu login	O seu aplicativo
O que volta	O que o software conhece: câmeras, gravações, eventos	As entidades que a pessoa expõe; a imagem de uma câmera pela API REST	O catálogo e as detecções, estruturadas e com horário	As mesmas detecções, estruturadas
Quem define a detecção	Quem constrói, com modelo e filtros próprios	Quem monta a automação	Você descreve em linguagem natural; o pipeline é montado a partir do catálogo	A detecção que já roda nas câmeras
De quem é a permissão	Chaves (Shinobi) ou tokens (ZoneMinder), conforme o software	Só as entidades expostas; token de longa duração na API REST	O login e as permissões de quem pergunta, por usuário e por loja	Por usuário, por loja e por app, aplicada no dado
Onde o dado cai	Onde o seu código decidir	Onde quem monta decidir	Lido junto com os outros dados da operação	No aplicativo que você constrói e junto com os outros dados da operação
Quem mantém a detecção	Você, no código e nos modelos	Você, nas entidades e nas detecções	A Visio rotula e treina; quem constrói nunca roda um treino	A Visio rotula e treina; quem constrói recebe a detecção servida

Cenários em que cada porta é a certa

Quando a pergunta ainda está sendo formada

Se você não sabe o que a câmera consegue responder, a porta é o MCP. A conversa com a sua IA mostra o que o catálogo já cobre, onde falta treino e o custo de rodar, antes de qualquer linha de código. Fale com um especialista e leve a pergunta que você gostaria de fazer à câmera.

Quando a pergunta virou rotina do aplicativo

Se a detecção já roda e o seu aplicativo precisa dela todos os dias, a porta é a API. A rotina não depende de uma conversa, e a detecção chega estruturada, com horário, do mesmo jeito em toda loja.

Quando quem conclui é a sua IA

Se a pergunta é «o que aconteceu ali?», a porta é o MCP. A sua IA lê os sinais detectados junto com os outros dados da operação e abre o vídeo só do minuto que precisa. A linha do tempo de sinais guarda, para cada evento, o quadro de onde ele veio. Por que o enxergar acontece uma vez e o concluir fica com a sua IA está em visão computacional entende o que aconteceu ou só detecta objetos.

Opinião do Head of Content

Lorenzo Lopez, Head of Content da Visio, observa que «API ou MCP» é, no fundo, uma pergunta sobre quem faz a pergunta. Para ele, uma pessoa que conversa com a sua IA precisa de uma porta que explique o que existe e quanto custa rodar, e um aplicativo que roda sozinho precisa de uma porta feita para a rotina. A posição dele é que escolher uma só das duas é o erro mais fácil de cometer: o MCP sem a API deixa a rotina sem lugar para morar, e a API sem o MCP deixa a descoberta sem conversa. Na leitura dele, o que importa é que a detecção seja a mesma nos dois lados.

Perguntas frequentes

API ou MCP: qual escolher para consumir as detecções?

Os dois, para trabalhos diferentes. O MCP é a porta da sua IA: ela descreve o que detectar, vê o catálogo e o custo de rodar e lê as detecções com o seu login. A API é a porta do seu aplicativo: ele consome as mesmas detecções, estruturadas, no lugar onde você constrói. A detecção é a mesma nos dois lados.

O MCP substitui a API?

Não. O MCP serve a conversa com a sua IA, e a API serve a rotina do aplicativo. A ordem natural é perguntar pelo MCP e consumir pela API, e os dois chegam às mesmas detecções, estruturadas e com horário.

A minha IA vê o vídeo das câmeras pelo MCP?

A sua IA tem acesso às câmeras. A ordem é o que a torna eficiente: ela lê primeiro os sinais detectados, junto com os outros dados da operação, e abre o vídeo no momento específico em que precisa de certeza para concluir. Cada evento aponta para o quadro de onde veio.

Preciso rotular dados ou treinar um modelo para consumir uma detecção?

Não. A Visio rotula os dados e treina os modelos em casa, e quando o catálogo não responde a uma pergunta, o treino acontece do lado da Visio. Quem constrói nunca rotula um quadro nem roda um treino: constrói a ferramenta, não o conjunto de modelos.

Quem vê o quê quando a IA ou o aplicativo consulta?

A permissão segue quem pergunta, por usuário, por loja e por app, aplicada no dado, para a pessoa e para a IA que ela conecta. A IA responde com o login e as permissões de quem pergunta, o franqueado vê a dele e a rede vê a rede. O que circula é a detecção, com horário.

Quanto custa consumir as detecções?

O preço se forma por fatores: quantas lojas e quantas câmeras ou sensores entram, quantas perguntas a mesma câmera responde, quando a detecção roda e o que o pipeline custa para rodar, declarado antes de rodar. O valor de cada operação é calculado depois do mapeamento, falando com um especialista.

Próximos passos

O próximo passo é o mapeamento de quais perguntas as câmeras que a loja já tem conseguem responder. Nenhum número de melhoria vem antes dele, porque o número de cada operação é calculado com o dado dela.

Escreva a pergunta que você quer fazer à câmera e onde a resposta deve chegar, na sua IA ou no seu aplicativo, e fale com um especialista.
Liste as câmeras e os gravadores de uma loja e o que cada um enxerga.

Conclusão

API ou MCP não é uma escolha entre duas portas concorrentes: o MCP é a porta da sua IA, para descobrir e perguntar, e a API é a porta do seu aplicativo, para consumir a rotina. As APIs dos gravadores e o servidor MCP do Home Assistant servem a quem monta a própria detecção, e a camada de Sensores do Visio OS serve a detecção pronta pelos dois caminhos, com o custo declarado antes de rodar e o dado junto com os outros dados da operação. Sensores criam o sinal. O Visio OS transforma em tarefa certa, pra pessoa certa, e na resposta que a sua IA dá. Fale com um especialista.