Integrações: Assistentes de IA

Agent DVR pode ser utilizado diretamente de assistentes de IA como Claude, ChatGPT, Cursor e VS Code Copilot. Faça perguntas em linguagem natural - "quais alertas tive ontem à noite?", "mostre-me o que aconteceu na câmera da entrada esta manhã", "desabilite as câmeras da garagem" - e o assistente responde com base em suas câmeras ao vivo, gravações e registro de alertas, incluindo imagens.

Isso funciona através do Model Context Protocol (MCP), o padrão aberto que assistentes utilizam para conectar a ferramentas externas. Agent DVR fornece um servidor MCP em dois locais, e você conecta seu assistente ao que melhor se adequa:

• Integrado ao Agent DVR (Ponto de extremidade local): fornecido por seu próprio servidor na sua rede local. Nenhuma conta ou assinatura necessária. Para assistentes executados no mesmo computador ou LAN.
• Através do iSpyConnect.com (Ponto de extremidade em nuvem): alcança seus servidores pela mesma via de acesso remoto que o portal web e aplicativos móveis usam, de qualquer lugar, sem necessidade de encaminhamento de porta. Requer uma assinatura iSpyConnect. Esta é a opção a usar para claude.ai, ChatGPT e telefones.

Ambos expõem o mesmo conjunto de ferramentas. Requer Agent DVR 8.0.3 ou posterior.

Cada servidor Agent DVR oferece MCP em /mcp no seu servidor web local, portanto, se você abrir a interface do Agent DVR em http://localhost:8090, o ponto de extremidade será http://localhost:8090/mcp (use o endereço e porta do seu servidor de outro computador na LAN, por exemplo, http://192.168.1.10:8090/mcp). Ele está ativado por padrão e pode ser desativado com Ponto de extremidade do assistente de IA (MCP) em Configurações do servidor - Servidor Local.

O acesso segue exatamente as mesmas regras que o resto da API local: da sua própria rede, nenhuma entrada é necessária, a menos que Proteger API esteja ativado, caso em que o assistente deve enviar o nome de usuário e a senha de um usuário administrador (a maioria dos clientes MCP permite adicionar um cabeçalho de autorização). As conexões de fora da sua rede adicionalmente exigem uma licença, a mesma do acesso com porta redirecionada à interface.

Claude Code

claude mcp add --transport http agentdvr http://localhost:8090/mcp

Gemini CLI

gemini mcp add -s user --transport http agentdvr http://localhost:8090/mcp

Então digite /mcp dentro do Gemini CLI para confirmar que as ferramentas foram carregadas. A parte -s user armazena o servidor nas suas configurações de usuário para que fique disponível em qualquer pasta.

Cursor

Adicione a .cursor/mcp.json (ou por meio de Configurações - MCP):

{ "mcpServers": { "agentdvr": { "url": "http://localhost:8090/mcp" } } }

VS Code (Copilot)

Adicione a .vscode/mcp.json:

{ "servers": { "agentdvr": { "type": "http", "url": "http://localhost:8090/mcp" } } }

Claude Desktop

O aplicativo de desktop Claude não consegue chamar um servidor no seu próprio computador diretamente, portanto usa uma pequena extensão que faz isso para você. Baixe AgentDVR.mcpb, depois no Claude Desktop abra Configurações - Extensões e arraste o arquivo para a página. Instala-se ativado e conecta-se em http://localhost:8090/mcp; clique em Configurar apenas se seu servidor está em outro computador ou tem Proteger API ativado. Claude solicita permissão a primeira vez que cada ferramenta é usada - escolha "Sempre permitir" para parar os avisos.

Outros assistentes

Qualquer cliente que suporte MCP sobre HTTP ("Streamable HTTP") pode usar a mesma URL. Procure por "servidores MCP", "conectores" ou "ferramentas" nas configurações do assistente.

O aplicativo web Claude e aplicativos móveis, e ChatGPT, não conseguem acessar um servidor em sua própria rede de jeito nenhum; eles usam o Ponto de Extremidade de Nuvem.

Com uma assinatura iSpyConnect, seus servidores também são alcançáveis em:

https://www.ispyconnect.com/mcp

Adicione essa URL como um conector personalizado ou servidor MCP no seu assistente (por exemplo, Configurações - Conectores no claude.ai e nos aplicativos Claude, ou o equivalente no Cursor). O assistente abre uma página de entrada iSpyConnect; entre, escolha se deseja permitir controle além de visualização e clique em Permitir. Nada mais precisa ser configurado: todos os servidores Agent DVR conectados à sua conta com acesso remoto ativado estão disponíveis, e o assistente perguntará qual você quer dizer se tiver mais de um.

No ChatGPT (Plus ou Pro), as etapas são: Configurações - Segurança e entrada - ativar Modo de desenvolvedor; então Configurações - Plugins - Procurar plugins - Adicionar. Nomeie como Agent DVR, insira a URL acima, escolha OAuth e deixe a ID do cliente e o segredo vazios, depois entre e clique em Permitir. Se a página do plugin disser "Nenhuma ação de aplicativo disponível ainda", clique em Atualizar nessa página.

De um assistente de linha de comando, como Gemini CLI ou Claude Code, o acesso é em duas etapas: adicione o servidor, autorize-o e o navegador abre na mesma página.

gemini mcp add -s user --transport http agentdvr-cloud https://www.ispyconnect.com/mcp
gemini
/mcp auth agentdvr-cloud

As solicitações viajam pelo mesmo relé que o portal da Web usa, portanto nenhum encaminhamento de porta é necessário e seu servidor nunca é exposto à internet. O acesso para quando sua assinatura expira, e o acesso de cada assistente pode ser removido das configurações do conector do próprio assistente a qualquer momento.

Seu servidor deve estar em execução e conectado ao iSpyConnect (o ícone de cadeado na IU local mostra o estado da conexão remota). Bloquear acesso externo nas Configurações do servidor também bloqueia este ponto de extremidade.

Os assistentes veem um pequeno conjunto de ferramentas desenvolvidas para fins específicos em vez da API bruta, portanto as respostas permanecem rápidas e econômicas:

• Visualização: liste seus Servidores e Dispositivos (com Localização e estado), obtenha um resumo de Atividade (Gravações e Alertas por Câmera por hora, com o que foi Detectado), liste Gravações em uma janela de tempo, veja uma janela inteira em relance como uma grade de quadros, veja uma Câmera ao longo de um dia como uma Linha do tempo de quadros, extraia quadros de uma Gravação, tire uma captura instantânea AO VIVO de uma Câmera, leia o registro de Alertas e obtenha um link para abrir uma Gravação na interface web.
• Controle: armar e desarmar o servidor, aplicar perfis, ativar ou desativar dispositivos, alterar modos de gravação, alternar alertas, detectores de movimento, detecção de objetos, reconhecimento facial e reconhecimento de placas, adicionar objetos à lista que uma câmera procura, colocar dispositivos em grupos, mover câmeras PTZ para predefinições e outras alterações de estado a partir da API.
• Regras: configure uma regra em linguagem clara - "avise-me se um carro vermelho aparecer nas próximas 6 horas", "alerte-me se Dave estiver na porta entre 2 e 4 na terça-feira". O assistente seleciona o evento do detector de movimento (objeto, rosto, placa, som, movimento) e, apenas para detalhes que um detector não consegue ver, como cor ou modelo, adiciona uma pergunta para a IA de visão cuja resposta confirma a correspondência. A regra é armazenada como ações ordinárias na câmera, marcadas como feitas pelo assistente com a frase que você usou, e expira automaticamente; você pode excluí-la lá a qualquer momento. Veja Regras do Assistente e os Exemplos de Regras. Requer Agent DVR 8.0.7 ou posterior.
• Todo o resto: um catálogo de comandos adicionais de leitura e controle que o assistente pode chamar quando nenhuma ferramenta dedicada se aplica (estatísticas do sistema, status completo de um dispositivo, predefinições de PTZ e assim por diante).

O assistente não consegue excluir gravações ou fotos, alterar configuração de dispositivo ou servidor, adicionar ou remover dispositivos ou reiniciar o servidor: esses comandos não são oferecidos deliberadamente, qualquer que seja o ponto de extremidade usado. Regras são a única coisa que ele consegue criar, e todas estão listadas em Configurações do servidor - Regras do Assistente. No ponto de extremidade na nuvem, visualização, controle e regras são permissões separadas que você concede na página de entrada, e o uso é limitado por taxa para proteger o relé. Uma regra que faz uma pergunta à IA de visão custa uma chamada de IA cada vez que seu disparador é acionado (limitado por hora); o assistente informará quando a configurar.

Prompts de exemplo

• "Alguém foi até a porta da frente nas últimas 24 horas? Mostre-me."
• "Que pássaros visitaram o comedouro esta manhã?"
• "Qual era a movimentação na garagem hoje, e quando?"
• "Mostre-me o jardim de trás ao longo do dia. Quando começou a chover?"
• "Que Alertas tive ontem, e algum deles era de Pessoas?"
• "Quem está na porta da frente agora?"
• "Quais câmeras estão offline?"
• "Vamos sair - ative tudo com o Perfil Ausência."
• "Desative todas as câmeras na localização casa."
• "Envie-me um link do clipe do entregador."
• "Avise-me se alguém chegar à porta da frente nos próximos 6 horas."
• "Alerte-me se um carro vermelho aparecer na entrada hoje."
• "Deixe-me saber a primeira vez que Dave está na porta na terça-feira entre 2 e 4."
• "Envie-me um e-mail se a câmera do portão traseiro ficar offline esta semana."
• "Quando alguém entrar no estacionamento esta manhã, diga-lhe que o escritório fica atrás."
• "Se alguém está no portão lateral esta noite, toque um latido de cachorro e grave a câmera do jardim também."
• "Se as lixeiras não estiverem na beira da rua no domingo às 18h, envie um e-mail para [email protected]."
• "De segunda a sexta, das 9 às 17, avise-me se uma van de entrega para do lado da loja."
• "Avise-me se alguém está carregando um pacote na porta da frente hoje."
• "Tire uma foto do jardim todos os dias ao meio-dia."
• "Coloque as câmeras da garagem, jardim e portão em um grupo chamado Outside."
• "Avise-me sempre que houver uma pessoa em qualquer uma das câmeras externas entre 23h e 6h."
• "Arme o sistema às 22h todas as noites e avise-me quando ele for desarmado."
• "Quais câmeras conseguem detectar cães? Quem você reconhece? A câmera da porta consegue falar?"
• "O que você configurou para mim e cada um está funcionando corretamente agora?"
• "Faça a entrada enviar um e-mail para mim em vez disso."
• "Quais regras você configurou? Pause a entrada e delete o resto."

Fluxos de trabalho prontos

O servidor também oferece modelos de aviso que assistentes com suporte a aviso (Claude Desktop, Claude Code, Gemini CLI, Cursor e outros) exibem como comandos barra ou em um menu. Cada um executa um fluxo de trabalho completo de várias etapas e relata o resultado:

• morning_briefing - o que as Câmeras viram desde a noite passada: Atividade, Alertas, Pessoas notáveis, veículos e animais, e estado de Câmeras.
• door_report - quem chegou a uma Câmera de porta, com horários, o que cada visitante fez e um link para cada clipe.
• wildlife_report - quais animais e pássaros uma Câmera capturou, identificados tão de perto quanto o material permite.
• camera_health - cada Servidor e Câmera verificados para desconexão, Desativado, erros e Câmeras que ficaram silenciosas.
• day_in_review - uma Câmera ao longo de um dia inteiro como uma Linha do tempo de quadros, com uma narrativa de como a cena mudou.
• set_up_a_rule - configure uma regra a partir de uma frase: verifica o que suas câmeras conseguem fazer, mostra o que a regra fará e depois a cria quando você diz sim.

Com a permissão de regras, um assistente pode configurar uma regra para você a partir de uma frase: "me avise se alguém chegar à porta da frente nas próximas 6 horas". Agent DVR a transforma em ações ordinárias na câmera, para que seja executada no seu servidor como uma regra que você criou manualmente. Nenhum assistente fica envolvido após a regra ser criada.

• Onde fica: a lista de Ações da câmera, marcada como Regra do Assistente com a data em que termina e, para regras que disparam um número limitado de vezes, quantas vezes já disparou. Passe o cursor sobre a marca para ver a frase de origem. Edite ou delete ali como qualquer outra ação, ou peça ao assistente para listar, pausar ou deletar suas regras. Todas as regras do servidor também aparecem em um único local, Configurações do servidor - Regras do Assistente, com a frase de origem, o que abrange, se está ativa, aguardando, pausada ou concluída, e um botão de deletar. Regras para um grupo de câmeras ou para o próprio sistema aparecem apenas ali. Usuários que não têm permissão para alterar as configurações do servidor podem ver a lista, mas não podem deletar a partir dela.
• O que pode monitorar: qualquer coisa que a câmera já detecte - movimento, objetos (pessoa, carro, cachorro e assim por diante), rostos reconhecidos, placas de matrícula, sons ou a câmera ficando offline. Você também pode fazer perguntas: "quais câmeras conseguem detectar cachorro?", "quem você reconhece?", "a câmera da porta consegue falar?".
• O que pode fazer quando acontece: avisar você por notificação push, email ou SMS; dizer uma mensagem em voz alta através da câmera ("quando alguém entra no estacionamento, diga-lhe que o escritório fica para trás") ou tocar um som através dela (um latido de cachorro); gravar em outra câmera; mover uma câmera PTZ para uma predefinição; chamar uma URL (um webhook, uma tomada inteligente); marcar a gravação; aplicar um perfil. Falar e tocar sons precisam de uma câmera com áudio bidirecional configurado, fala e SMS precisam de uma conta conectada, e email precisa de mensagens ativadas na câmera - o assistente verifica isso e informa quais câmeras se qualificam.
• Mais de uma câmera ou o próprio sistema: nomeie um grupo, uma localização ou "todas as câmeras" e você obtém uma regra que o segue - "me avise sempre que houver uma pessoa em qualquer uma das câmeras Outside durante a noite" também cobre uma câmera que você adicionar ao grupo Outside no próximo mês. Câmeras no grupo que não conseguem detectar o que você pediu simplesmente não são uma fonte, e o assistente informa quantas conseguem. Se o grupo ainda não existir, um assistente com permissão de controle pode criá-lo: "coloque as câmeras da garagem, jardim e portão em um grupo chamado Outside" (requer Agent DVR 8.0.7 ou posterior). Os grupos são os mesmos que você configura na aba Geral de um dispositivo, e também determinam quais dispositivos uma conta de usuário restrito pode ver; portanto, uma câmera que você coloca em um grupo fica oculta dos usuários restritos cuja conta não inclui esse grupo. Uma regra também pode pertencer ao servidor em vez de uma câmera: "arme o sistema às 22h todas as noites", "aplique o perfil Night ao anoitecer nos dias de semana", "me avise quando o sistema for desarmado". As regras do sistema funcionam em seu próprio cronograma, então nenhum agendamento de câmera as afeta; elas não conseguem analisar uma imagem ou falar através de uma câmera.
• Quando: nas próximas horas, até uma data e hora, numa janela semanal ("terças-feiras entre as 2 e as 4"), num único dia, ou a intervalos regulares ("tirar uma foto do jardim a cada hora", "verificar se o portão está fechado a cada 15 minutos" - dentro de uma janela de tempo se preferir). Os horários podem acompanhar o sol: "após o anoitecer", "do pôr do sol ao nascer do sol", "meia hora antes do nascer do sol" são calculados novamente todos os dias com base nas coordenadas da localização da câmara (uma localização sem latitude e longitude definidas usa as 6 da manhã e as 6 da tarde). "Avisa-me quando..." notifica-o uma vez e a regra faz uma pausa; diga "sempre" ou "sempre que" se pretender ser notificado cada vez que acontece. Sempre significa a cada visita, não a cada segundo que alguém está lá: uma regra espera um minuto antes de poder notificar novamente (meio minuto para regras que falam, tocam um som ou gravam), e pode pedir mais tempo ("no máximo uma vez por hora"). Com uma janela repetida ("dias de trabalho das 9 às 17, avisa-me se uma carrinha para fora"), uma vez significa uma vez cada dia em que a janela abre. Pergunte "o que configurou e está a funcionar?" para ver cada regra e se está ativa, à espera da sua janela, em pausa ou terminada. "Envia-me um email em vez disso" altera uma regra. Uma regra com limite de tempo remove-se quando o tempo passa.
• Detalhes que um detector não consegue ver: para cor, marca, roupa e similares ("um carro vermelho") a regra faz uma pergunta de sim ou não ao seu provedor de IA (Configurações do servidor - Configurações de IA) sobre a imagem cada vez que o detector dispara, e só age quando a resposta é sim. O mesmo funciona para coisas que nenhum detector conhece ("um canguru no jardim"), usando movimento como gatilho. Também pode analisar em um horário definido: "se as latas não estiverem na rua no domingo às 20h, envie mensagem para Max" verifica a câmera todos os domingos às 20h e só envia mensagem quando a resposta é não. Se a IA não conseguir determinar (escuro, visão bloqueada) nada é enviado; portanto, escolha um horário quando a câmera conseguir enxergar. Isso é uma chamada de IA por gatilho, limitada a 30 por hora por regra por padrão, e o assistente informa quando uma regra funciona dessa maneira. Se nenhum provedor de IA estiver configurado, o assistente dirá isso e como adicionar um (Google Gemini tem uma camada gratuita) - não consegue fazer essa etapa para você, porque é uma chave API - e oferece a regra sem a pergunta: todo carro em vez de carros vermelhos, o que consegue analisar com você depois. Detalhes finos, como o modelo exato de um carro ou cor à noite quando a câmera mudou para sua imagem de visão noturna em preto e branco, não é confiável.
• Por que uma regra é recusada: Agent DVR não criará uma regra que nunca poderia funcionar, e diz tudo o que está errado de uma vez. Se nenhum rosto está inscrito sob o nome que você deu, se a câmera através da qual você quer falar não tem canal de áudio bidirecional, se a detecção de objetos está desligada naquela câmera, se o que você pediu não está na sua lista Buscar, ou se você pediu uma janela de tempo em uma câmera cujo cronograma está desligado, o assistente é informado exatamente o que precisa ser alterado. Com a permissão de controle, pode fazer a alteração para você e tentar novamente: ligar o detector ou o cronograma, ou adicionar o objeto à lista Buscar da câmera ("cachorro" em uma câmera que só procura pessoas e carros). Só pode adicionar objetos que o modelo de IA da câmera conhece. Para qualquer outra coisa, usa um objeto mais amplo e pede ao seu provedor de IA para verificar o detalhe. Sons são a exceção: adicione-os à lista do microfone você mesmo.
• Não suportado ainda: contagem ("a segunda vez hoje"), coisas que não aconteceram ("sem entrega até 18h"), e sequências em várias câmeras.

Requer Agent DVR 8.0.7 ou posterior. No ponto de extremidade da nuvem, as regras são uma permissão separada na página de entrada, portanto um assistente que estava conectado antes perguntará para você aprovar o acesso novamente.

As coisas comuns que as pessoas querem das suas câmaras, como a frase para dizer a um assistente conectado, o que o Agent DVR configura e o que precisa. Todas estas são Regras do Assistente: funcionam no seu servidor e continuam sem qualquer assistente conectado. Precisa do Agent DVR 8.0.7 ou posterior e da permissão de regras.

• Receba um alerta quando um automóvel de uma cor particular chega. Diga: "Diga-me se um automóvel vermelho aparecer na entrada nas próximas 6 horas." A detecção de objectos da câmara dispara em cada automóvel, o seu fornecedor de IA é questionado se o automóvel é vermelho, e você recebe uma notificação push a primeira vez que a resposta é sim. A regra remove-se após 6 horas. Precisa de detecção de objectos activada com "automóvel" na lista Buscar da câmara (o assistente pode fazer ambas com a permissão de controlo) e um fornecedor de IA em Configurações do servidor - Configurações de IA.
• Saiba quando uma pessoa particular chega. Diga: "Avise-me a primeira vez que Dave está na porta na terça entre as 2 e as 4." O reconhecimento facial dispara no nome e é-lhe comunicado uma vez. Precisa de reconhecimento facial activado para a câmara e um rosto inscrito sob esse nome - a regra é recusada, com os nomes inscritos, se não existir um Dave.
• Descubra se algo foi feito até uma hora definida. Diga: "Se os caixotes não estiverem fora no passeio no domingo às 18h, envie-me uma mensagem." Cada domingo às 18h a imagem da câmara é enviada ao seu fornecedor de IA com uma pergunta sim ou não, e você recebe a mensagem apenas quando a resposta é não. Se a IA não consegue determinar (muito escuro, vista bloqueada) nada é enviado, então escolha uma hora em que a câmara consegue ver. Precisa de um fornecedor de IA e uma conta conectada para SMS.
• Observe entregas durante o horário de abertura. Diga: "De segunda a sexta das 9 às 17h, diga-me se uma carrinha de entrega para à frente da loja." Uma vez cada dia a janela abre, não uma vez para todo o tempo. Diga "cada vez" se quiser cada uma. Precisa de agendamento da câmara ligado.
• Detecção de algo que nenhum detector conhece. Diga: "Diga-me se há um canguru no jardim hoje." ou "Diga-me se alguém está a carregar uma encomenda na porta da frente." O movimento ou uma pessoa dispara a regra e o fornecedor de IA responde a pergunta sobre a imagem. Uma chamada de IA por disparo, limitada a 30 por hora para cada regra.
• Fale com quem aparecer. Diga: "Quando alguém entra no parque de estacionamento esta manhã, diga-lhes que o escritório está atrás." A mensagem é falada através do altifalante da câmara por texto para fala. Precisa de uma câmara com falar configurado e uma conta conectada.
• Afaste um visitante nocturno. Diga: "Se alguém está no portão lateral esta noite, toque um cão a latir e grave também a câmara do jardim." Toca um ficheiro de som através da câmara e inicia gravação de outra câmara, no máximo uma vez a cada 30 segundos. Precisa de uma câmara com falar configurado.
• Cubra todas as câmaras exteriores durante a noite. Diga: "Coloque as câmaras da entrada, jardim e portão num grupo chamado Exterior." depois "Diga-me sempre que há uma pessoa em qualquer das câmaras do Exterior do pôr do sol ao nascer do sol." Uma regra segue o grupo, incluindo câmaras que adiciona mais tarde, e o pôr do sol é calculado todos os dias a partir das coordenadas da localização. No máximo uma notificação por minuto de cada câmara.
• Saiba quando uma câmara deixa de funcionar. Diga: "Envie-me um e-mail se a câmara do portão de trás ficar desligada esta semana." Precisa de mensagens activadas na câmara.
• Armar e desarmar num horário e saber quando muda. Diga: "Arme o sistema às 22h cada noite, e diga-me quando for desarmado." Estas são regras do próprio servidor, portanto o agendamento de nenhuma câmara as afecta.
• Grave uma foto diária. Diga: "Tire uma foto do jardim todos os dias ao meio-dia."

Para ver ou alterar o que foi configurado, pergunte "que regras tem configuradas, e cada uma está a funcionar?", "faça da entrada uma envie-me um e-mail em vez disso", "pause a regra da carrinha", ou abra Configurações do servidor - Regras do Assistente. Se um pedido não consegue funcionar o assistente diz porquê e o que alterar; veja Regras do Assistente para os limites.

• O assistente não consegue conectar ao ponto de extremidade local: verifique a URL em um navegador - http://localhost:8090/mcp deve responder (uma mensagem de erro é aceitável; "conexão recusada" não é). Certifique-se de que a porta corresponde às Configurações do servidor - Servidor Local e que o ponto de extremidade está ativado lá.
• 401 Não autorizado: Proteger API está ativado, então o assistente deve enviar as credenciais de um usuário administrador, ou você está se conectando de fora da sua rede.
• 403 Proibido: conectando de fora da sua rede sem uma licença. Use o Ponto de extremidade da nuvem em vez disso.
• 404 Não encontrado: o ponto de extremidade está desligado nas Configurações do servidor, ou o servidor é mais antigo que a versão 8.0.3.
• O ponto de extremidade da nuvem diz que o servidor está offline: o servidor não está conectado ao iSpyConnect. Verifique o ícone de cadeado na interface local e que Bloquear acesso externo está desligado.
• Ver o que o assistente está fazendo: defina Registro de logs como Depuração em Configurações do servidor e abra os Registros do Menu do Servidor. No ponto de extremidade local, cada solicitação e chamada de ferramenta é registrada com um prefixo "MCP", incluindo os Argumentos e quanto tempo levou. Por meio do ponto de extremidade da Nuvem, as ferramentas são executadas em iSpyConnect.com e o Servidor vê apenas os Comandos individuais que enviam, registrados com um prefixo "RelayApi".