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

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 esse URL como um conector personalizado ou servidor MCP em seu assistente (por exemplo, Configurações - Conectores em claude.ai e nos aplicativos Claude, ou o equivalente em ChatGPT e 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. Nenhuma outra configuração é necessária: cada servidor Agent DVR conectado à sua conta com acesso remoto ativado está disponível, e o assistente perguntará qual você quer dizer se tiver mais de um.

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: ativar e desativar o servidor, aplicar perfis, ativar ou desativar dispositivos, alterar modos de gravação, ativar ou desativar alertas e detectores, mover câmeras PTZ para predefinições e outras alterações de estado da API.
• 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 pode excluir gravações ou fotos, alterar configuração de dispositivo ou servidor, adicionar ou remover dispositivos, ou reiniciar o servidor: esses comandos são deliberadamente não oferecidos, qualquer que seja o endpoint usado. No endpoint da nuvem, visualização e controle são permissões separadas que você concede na página de entrada, e o uso é limitado para proteger o retransmissor.

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."

Fluxos de trabalho prontos

O Servidor também oferece modelos de prompt que assistentes com suporte a prompt (Claude Desktop, Claude Code, Cursor e outros) mostram como Comandos de barra ou em um menu. Cada um executa um fluxo de trabalho multi-etapas completo 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.

• 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".