Integraciones: Asistentes de IA

Agent DVR puede utilizarse directamente desde asistentes de IA como Claude, ChatGPT, Cursor y VS Code Copilot. Haga preguntas en lenguaje natural - "¿qué alertas tuve anoche?", "muéstrame qué ocurrió en la cámara del camino de entrada esta mañana", "desactiva las cámaras del garaje" - y el asistente responde desde sus cámaras en directo, grabaciones y registro de alertas, incluyendo imágenes.

Esto funciona a través del Protocolo de Contexto de Modelo (MCP), el estándar abierto que utilizan los asistentes para conectarse a herramientas externas. Agent DVR proporciona un servidor MCP en dos lugares, y conecta su asistente al que mejor le convenga:

• Integrado en Agent DVR (Punto final local): servido por su propio servidor en su red local. No se necesita cuenta ni suscripción. Para asistentes que se ejecutan en el mismo equipo o LAN.
• A través de iSpyConnect.com (Punto final en la nube): accede a sus servidores mediante el mismo acceso remoto que utilizan el portal web y las aplicaciones móviles, desde cualquier lugar, sin necesidad de redirección de puertos. Requiere una suscripción a iSpyConnect. Este es el que debe usar para claude.ai, ChatGPT y teléfonos.

Ambos exponen el mismo conjunto de herramientas. Requiere Agent DVR 8.0.3 o posterior.

Cada servidor de Agent DVR sirve MCP en /mcp en su servidor web local, así que si abre la interfaz de Agent DVR en http://localhost:8090 el punto final es http://localhost:8090/mcp (use la dirección y puerto del servidor desde otro equipo de la LAN, por ejemplo http://192.168.1.10:8090/mcp). Está activado de forma predeterminada y puede desactivarse con Asistente de IA (punto final MCP) en Configuración del servidor - Servidor local.

El acceso sigue exactamente las mismas reglas que el resto de la API local: desde su propia red no se necesita iniciar sesión, a menos que Proteger API esté activado, en cuyo caso el asistente debe enviar el nombre de usuario y la contraseña de un usuario administrador (la mayoría de los clientes MCP le permiten añadir un encabezado de autorización). Las conexiones desde fuera de su red también requieren una licencia, igual que el acceso con redirección de puertos a la interfaz.

Claude Code

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

Cursor

Añada a .cursor/mcp.json (o a través de Ajustes - MCP):

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

VS Code (Copilot)

Añada a .vscode/mcp.json:

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

Claude Desktop

La aplicación de escritorio de Claude no puede llamar directamente a un servidor en su propio equipo, así que utiliza una pequeña extensión que lo hace por usted. Descargue AgentDVR.mcpb, luego en Claude Desktop abra Ajustes - Extensiones y arrastre el archivo a la página. Se instala Activado y se conecta a http://localhost:8090/mcp; haga clic en Configurar solo si su servidor está en otro equipo o tiene Proteger API Activado. Claude solicita permiso la primera vez que se utiliza cada herramienta - elija "Permitir siempre" para detener los mensajes.

Otros asistentes

Cualquier cliente que admita MCP sobre HTTP ("HTTP transmisible") puede usar la misma URL. Busque "servidores MCP", "conectores" o "herramientas" en los ajustes del asistente.

La aplicación web de Claude y las aplicaciones móviles, y ChatGPT, no pueden alcanzar un servidor en su propia red en absoluto; utilizan el Punto de conexión de Nube.

Con una suscripción de iSpyConnect, sus servidores también son accesibles en:

https://www.ispyconnect.com/mcp

Añada esa URL como conector personalizado o servidor MCP en su asistente (por ejemplo Ajustes - Conectores en claude.ai y las aplicaciones de Claude, o el equivalente en ChatGPT y Cursor). El asistente abre una página de inicio de sesión de iSpyConnect; inicie sesión, elija si desea permitir también el control además de la visualización, y haga clic en Permitir. No es necesario configurar nada más: todos los servidores de Agent DVR conectados a su cuenta con acceso remoto activado están disponibles, y el asistente le preguntará cuál quiere decir si tiene más de uno.

Las solicitudes viajan a través del mismo relé que utiliza el portal web, por lo que no se necesita redirección de puertos y su servidor nunca se expone a internet. El acceso se detiene cuando vence su suscripción, y el acceso de cada asistente puede eliminarse en cualquier momento desde los ajustes del conector del propio asistente.

Su servidor debe estar ejecutándose y conectado a iSpyConnect (el icono de candado en la interfaz local muestra el estado de la conexión remota). Bloquear acceso externo en Configuración del servidor también bloquea este punto de conexión.

Los asistentes ven un pequeño conjunto de herramientas diseñadas especialmente en lugar de la API sin procesar, así que las respuestas son rápidas y económicas:

• Visualización: enumerar los servidores y dispositivos (con ubicación y estado), obtener un resumen de actividad (grabaciones y alertas por cámara por hora, con lo que se detectó), enumerar grabaciones en una ventana de tiempo, ver una ventana completa de un vistazo como cuadrícula de fotogramas, ver una cámara durante un día como línea de tiempo de fotogramas, muestrear fotogramas de una grabación, tomar una instantánea en directo de una cámara, leer el registro de alertas, y obtener un enlace para abrir una grabación en la interfaz web.
• Control: activar y desactivar el servidor, aplicar perfiles, habilitar o deshabilitar dispositivos, cambiar modos de grabación, cambiar alertas y detectores entre activado y desactivado, mover cámaras PTZ a preestablecidos y otros cambios de estado desde la API.
• Todo lo demás: un catálogo de más comandos de lectura y control que el asistente puede invocar cuando ninguna herramienta dedicada se ajusta (estadísticas del sistema, estado completo de un dispositivo, preestablecidos PTZ y así sucesivamente).

El asistente no puede eliminar grabaciones o fotos, cambiar la configuración de dispositivos o servidores, agregar o quitar dispositivos ni reiniciar el servidor: esos comandos deliberadamente no se ofrecen, sea cual sea el punto de acceso utilizado. En el punto de acceso de Nube, la visualización y el control son permisos separados que se otorgan en la página de inicio de sesión, y el uso está limitado por velocidad para proteger el relé.

Indicaciones de ejemplo

• "¿Ha habido alguien en la puerta delantera en las últimas 24 horas? Muéstramelo."
• "¿Qué pájaros visitaron el comedero esta mañana?"
• "¿Cuán concurrida estuvo la entrada hoy, y cuándo?"
• "Muéstrame el jardín trasero durante el día. ¿Cuándo comenzó a llover?"
• "¿Qué alertas tuve ayer, y alguna fue sobre personas?"
• "¿Quién está en la puerta delantera ahora mismo?"
• "¿Qué cámaras están desconectadas?"
• "Nos vamos - activa todo con el perfil Ausente."
• "Deshabilita todas las cámaras en la ubicación de inicio."
• "Envíame un enlace al vídeo del mensajero."

Flujos de trabajo predefinidos

El servidor también ofrece plantillas de indicación que los asistentes con soporte de indicación (Claude Desktop, Claude Code, Cursor y otros) muestran como comandos de barra o en un menú. Cada una ejecuta un flujo de trabajo completo de varios pasos e informa del resultado:

• morning_briefing - qué vieron las cámaras desde la tarde anterior: actividad, alertas, personas, vehículos y animales notables, y estado de las cámaras.
• door_report - quién llegó a una cámara de puerta, con horas, qué hizo cada visitante y un enlace a cada vídeo.
• wildlife_report - qué animales y pájaros capturó una cámara, identificados con la precisión que permite el metraje.
• camera_health - cada servidor y cámara verificados para desconexión, desactivación, errores y cámaras que han dejado de transmitir.
• day_in_review - una cámara durante un día completo como línea de tiempo de fotogramas, con una narrativa de cómo cambió la escena.

• El asistente no puede conectar con el punto de conexión local: comprueba la URL en un navegador - http://localhost:8090/mcp debe responder (un mensaje de error está bien; "conexión rechazada" no). Asegúrate de que el puerto coincide con Configuración del servidor - Servidor local y de que el punto de conexión está activado allí.
• 401 No autorizado: Proteger API está activado, por lo que el asistente debe enviar las credenciales de un usuario administrador, o estás conectando desde fuera de tu red.
• 403 Prohibido: conexión desde fuera de tu red sin licencia. Usa el Punto de conexión en la nube en su lugar.
• 404 No encontrado: el punto de conexión está desactivado en Configuración del servidor, o el servidor es anterior a la versión 8.0.3.
• El punto de conexión en la nube dice que el servidor está desconectado: el servidor no está conectado a iSpyConnect. Comprueba el icono de candado en la interfaz local y que Bloquear acceso externo está desactivado.
• Ver qué está haciendo el asistente: establezca el "Registro de eventos" en Debug en "Configuración del servidor" y abra los registros desde el menú del servidor. En el punto de conexión local, cada solicitud y llamada de herramienta se registra con un prefijo "MCP", incluidos los argumentos y cuánto tiempo tardó. A través del punto de conexión en la nube, las herramientas se ejecutan en iSpyConnect.com y el servidor solo ve los comandos individuales que envían, registrados con un prefijo "RelayApi".