Servidor MCP de Visual Sentinel

Servidor del Protocolo de Contexto de Modelo (MCP) para Visual Sentinel, la plataforma de monitoreo de sitios web de seis capas: tiempo de actividad, rendimiento, SSL, DNS, regresión visual y detección de cambios de contenido.

Conecte Claude Desktop, Claude Code, Cline, Continue o cualquier cliente compatible con MCP a su cuenta de Visual Sentinel para que un asistente de IA pueda listar monitores, crearlos, obtener el historial de incidentes, ejecutar verificaciones gratuitas de DNS / SSL / velocidad y confirmar alertas en su nombre.

• npm: @visualsentinel/mcp-server

• Especificación OpenAPI: https://github.com/VisualSentinel/openapi

• Obtener una clave API: https://visualsentinel.com/settings/api-keys

• Referencia de API alojada: https://visualsentinel.com/docs

Qué obtiene

16 herramientas que abarcan la API pública de Visual Sentinel:

Herramientas públicas (no se requiere clave API)

Herramientas autenticadas (requieren VS_API_KEY)

Instalación

Claude Desktop

Agregue a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "visualsentinel": {
      "command": "npx",
      "args": ["-y", "@visualsentinel/mcp-server"],
      "env": {
        "VS_API_KEY": "vs_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Reinicie Claude Desktop. Las 16 herramientas aparecerán en el menú de herramientas.

Claude Code (CLI)

claude mcp add visualsentinel \
  -- npx -y @visualsentinel/mcp-server

Luego exporte VS_API_KEY en el shell donde se ejecuta Claude Code.

Cline (extensión de VS Code)

En la configuración de MCP de Cline, agregue:

{
  "visualsentinel": {
    "command": "npx",
    "args": ["-y", "@visualsentinel/mcp-server"],
    "env": { "VS_API_KEY": "vs_live_..." }
  }
}

Continue

En ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "visualsentinel",
      "command": "npx",
      "args": ["-y", "@visualsentinel/mcp-server"],
      "env": { "VS_API_KEY": "vs_live_..." }
    }
  ]
}

Cliente MCP genérico (stdio)

VS_API_KEY=vs_live_xxx npx -y @visualsentinel/mcp-server

El servidor habla JSON-RPC sobre stdio según la especificación MCP (2025-06-18).

Configuración

Dos variables de entorno, ambas opcionales excepto en los casos indicados:

Si se llama a una herramienta que necesita autenticación sin VS_API_KEY, el servidor devuelve un error claro en lugar de fallar silenciosamente.

VISUALSENTINEL_API_KEY se acepta como alias de VS_API_KEY para clientes que prefieren el nombre más largo.

Ejemplos de uso

Después de la instalación, pídale al asistente de IA cosas como:

• "¿Cuál es la situación del certificado SSL en visualsentinel.com? ¿Cuándo caduca?"

• "Lista mis monitores de Visual Sentinel que están actualmente caídos."

• "Agrega un nuevo monitor HTTPS para https://shop.example.com verificando cada minuto."

• "Muéstrame los incidentes de las últimas 24 horas y confirma los del monitor-id clm123."

• "¿Cuál es el porcentaje de tiempo de actividad de mi página de destino en los últimos 30 días?"

• "Ejecuta una prueba de velocidad en https://example.com/checkout."

El asistente elige la herramienta adecuada, completa los argumentos de la conversación y muestra la respuesta JSON.

Notas de seguridad

• Su clave API nunca sale de la máquina que ejecuta este servidor MCP. Las solicitudes van directamente a https://visualsentinel.com a través de HTTPS.

• Las herramientas públicas (vs_health, vs_dns_check, vs_ssl_check, vs_speed_test, vs_website_check) funcionan sin una clave API, pero sus resultados son visibles para cualquiera que pueda leer sus registros de conversación. Trátelas como cualquier otro comando de shell.

• Revoque una clave API filtrada inmediatamente en https://visualsentinel.com/settings/api-keys. La revocación entra en vigor en segundos.

• Las herramientas que mutan el estado (vs_monitors_create, vs_monitors_check_now, vs_alerts_acknowledge) heredan los permisos basados en roles de su clave API. Una clave de solo lectura no puede crear monitores.

Desarrollo

git clone https://github.com/VisualSentinel/mcp-server.git
cd mcp-server
npm install
npm run build      # tsup, output to dist/
npm run lint       # tsc --noEmit
npm run dev        # tsup --watch

Para realizar pruebas de humo localmente contra la API de producción:

VS_API_KEY=vs_live_... node dist/index.js

El servidor habla JSON-RPC en stdin / stdout. Envíe una solicitud tools/list para ver las herramientas registradas.

Versionado

Versionado semántico. Los cambios importantes en los nombres de las herramientas o los argumentos requeridos obtienen un aumento de versión mayor. Agregar nuevas herramientas o nuevos argumentos opcionales es una versión menor o un parche.

La superficie de herramientas del servidor sigue la especificación de la API pública de Visual Sentinel en https://github.com/VisualSentinel/openapi. Cuando la API ascendente obtiene un endpoint útil, este repositorio generalmente se actualiza dentro de una versión.

Licencia

MIT. Consulte LICENSE.

El servicio de API de Visual Sentinel en sí se rige por https://visualsentinel.com/terms.