MCP y automatización

Cómo conectar Vexday a Claude, ChatGPT y otros asistentes de IA (MCP)

Pregunta a tu asistente de IA si una CVE tiene exploit público o afecta a un cliente y recibe la respuesta con los datos de Vexday y la fuente de cada uno. El paso a paso sirve para Claude, ChatGPT, Cursor, VS Code, n8n y otras aplicaciones.

  • Para quiénPara SOC, MSSP y quien usa IA en el día a día de la seguridad.
  • PlanPlanes SOC y MSSP
  • Tiempounos 5 min

Lo que necesitas

  • Una cuenta de Vexday con el plan SOC o MSSP.
  • Un asistente o editor compatible con MCP, como Claude, ChatGPT, Cursor o VS Code.

Consultas por día en los planes con el MCP: SOC, 5000 · MSSP, 20.000.

Paso a paso

  1. Elige cómo entrar

    Por el conector, sin clave: la aplicación abre la pantalla de Vexday, entras con el correo o Google y haces clic en Permitir. O por la clave de la API, en las aplicaciones que aceptan un encabezado. En la lista de abajo, cada aplicación dice cuál de los dos acepta.

  2. Genera la clave, si vas a usar una

    En el panel, abre Integraciones y haz clic en Nueva clave. Copia la clave en el momento: empieza con vx_live_ y solo aparece una vez. Quien entra por el conector se salta este paso.

  3. Agrega el servidor en la aplicación

    La dirección del servidor es https://api.vexday.io/mcp. Abre tu aplicación en la lista de abajo y sigue su paso a paso, con el archivo de configuración cuando lo haya.

  4. Haz la primera pregunta

    Pide, por ejemplo: "¿La CVE-2024-3400 tiene exploit público? ¿Afecta a alguna tecnología que monitoreo?". El asistente consulta Vexday y responde con la fuente de cada dato.

  5. Sigue el uso y desconecta cuando quieras

    Cada llamada a una herramienta cuenta una consulta en el límite de la cuenta, el mismo de la API. El conector aparece en Integraciones como la clave "Conector: nombre de la aplicación": para desconectar, revoca la clave.

Cada aplicación, paso a paso

Asistentes de conversación

Claude.ai e Claude DesktopConector, sin clave

En el plan Free cabe un conector personalizado. En Team y Enterprise, lo agrega el dueño de la organización (en Organization settings → Connectors) y cada miembro hace clic en Connect. Claude Desktop usa los mismos conectores de la cuenta.

  1. En Customize → Connectors, haz clic en + Add → Add custom connector.
  2. Ponle el nombre Vexday y pega la dirección https://api.vexday.io/mcp.
  3. En la autenticación, elige iniciar sesión ahora y deja el cliente OAuth en registro automático (sin llenar la configuración avanzada).
  4. Inicia sesión con tu cuenta de Vexday y autoriza.
  5. En una conversación, activa Vexday en + → Connectors.

Documentación oficial ↗

ChatGPTConector, sin clave

ChatGPT solo entra con el inicio de sesión: no envía clave de la API. El servidor MCP personalizado está en los planes Business y Enterprise (en Business lo crea el administrador) y, en Pro, en el modo desarrollador. En versiones anteriores, la ruta es Settings → Apps & Connectors → Advanced settings → Developer mode → Create.

  1. Abre chatgpt.com/plugins y haz clic en + → Add custom MCP server.
  2. Ponle el nombre Vexday y, en Server URL, pega https://api.vexday.io/mcp.
  3. En Authentication, elige OAuth y deja vacíos los campos del cliente.
  4. Acepta el aviso, haz clic en Create as a plugin, revisa las herramientas e inicia sesión con tu cuenta de Vexday.
  5. En una conversación, escribe @ y elige Vexday.

Documentación oficial ↗

Microsoft Copilot StudioConector o clave

Requiere la orquestación generativa activada en el agente. Después de conectar, revisa la lista de herramientas.

  1. En el agente, abre Tools → Add a tool → New tool → Model Context Protocol.
  2. Completa el nombre, la descripción (el agente la usa para decidir cuándo consultar a Vexday) y el Server URL https://api.vexday.io/mcp.
  3. Para el inicio de sesión: OAuth 2.0, tipo Dynamic discovery. Para la clave: API key, tipo Header, con el nombre Authorization.
  4. En Add tool, crea la conexión: con el inicio de sesión, entra con la cuenta de Vexday; con la clave, pega Bearer vx_live_SUA_CHAVE (con Bearer adelante).
  5. Haz clic en Add to agent.

Documentación oficial ↗

Le Chat (Mistral Vibe)Conector, sin clave

Le Chat pasó a llamarse Vibe; la dirección chat.mistral.ai sigue igual. Solo el administrador de la cuenta agrega conectores.

  1. Abre Connectors (en Context, en el menú) y haz clic en + Add Connector → Custom MCP Connector.
  2. Nombre: vexday (sin espacios); Server URL: https://api.vexday.io/mcp.
  3. Haz clic en Connect e inicia sesión con tu cuenta de Vexday.
  4. En My Connectors, abre Vexday y, en las funciones, elige Always allow para no confirmar cada consulta.

Documentación oficial ↗

5ireClave de la API

5ire no tiene inicio de sesión (OAuth): entra con la clave de la API.

  1. Genera la clave de la API en el panel de Vexday, en Integraciones.
  2. En Tools, abre la flecha del botón + Local y elige Remote.
  3. Nombre Vexday, URL https://api.vexday.io/mcp y, en Http Headers, Name Authorization y Value Bearer vx_live_SUA_CHAVE.
  4. Guarda y activa Vexday.

Documentación oficial ↗

Editores de código y terminales

Claude CodeConector o clave
  1. Genera la clave de la API en el panel de Vexday, en Integraciones.
  2. En la terminal, ejecuta el comando de abajo (con --scope user, vale para todos tus proyectos).
  3. Revisa con claude mcp list: vexday aparece como Connected. Sin --header, Claude Code ofrece el inicio de sesión de Vexday en /mcp.
claude mcp add --transport http --scope user vexday https://api.vexday.io/mcp \
  --header "Authorization: Bearer vx_live_SUA_CHAVE"

Documentación oficial ↗

CursorConector o clave
  1. Genera la clave de la API en el panel de Vexday, en Integraciones.
  2. Guarda la clave en la variable de entorno VEXDAY_API_KEY (en la terminal: export VEXDAY_API_KEY=vx_live_…) y abre el programa desde esa terminal.
  3. Pega el bloque de abajo en el archivo y revisa, en la configuración de MCP de Cursor, que vexday esté activado. Sin headers, Cursor abre el inicio de sesión de Vexday.

Archivo: ~/.cursor/mcp.json (o .cursor/mcp.json en el proyecto)

{
  "mcpServers": {
    "vexday": {
      "url": "https://api.vexday.io/mcp",
      "headers": { "Authorization": "Bearer ${env:VEXDAY_API_KEY}" }
    }
  }
}

Documentación oficial ↗

VS Code com GitHub CopilotConector o clave

Este es el formato nuevo, el mismo de GitHub Copilot CLI. El formato anterior (.vscode/mcp.json, con "servers" en lugar de "mcpServers" y ${env:VEXDAY_API_KEY}) sigue funcionando.

  1. Genera la clave de la API en el panel de Vexday, en Integraciones.
  2. Guarda la clave en la variable de entorno VEXDAY_API_KEY (en la terminal: export VEXDAY_API_KEY=vx_live_…) y abre el programa desde esa terminal.
  3. Pega el bloque de abajo en el archivo. En MCP: List Servers, elige vexday para ver su estado y su salida. Sin headers, VS Code abre el inicio de sesión de Vexday.

Archivo: ~/.copilot/mcp-config.json (o .mcp.json en la raíz del proyecto)

{
  "mcpServers": {
    "vexday": {
      "type": "http",
      "url": "https://api.vexday.io/mcp",
      "headers": { "Authorization": "Bearer ${VEXDAY_API_KEY}" },
      "tools": ["*"]
    }
  }
}

Documentación oficial ↗

Windsurf (Devin Desktop)Conector o clave

Windsurf pasó a llamarse Devin Desktop en junio de 2026. En las versiones con el nombre anterior, el archivo es ~/.codeium/windsurf/mcp_config.json y la dirección va en "serverUrl".

  1. Genera la clave de la API en el panel de Vexday, en Integraciones.
  2. Pega el bloque de abajo en el archivo. En el .local.json del proyecto, la clave queda fuera de git.
  3. En Customize → MCPs, actualiza y revisa que vexday esté activado. Sin headers, pide el inicio de sesión de Vexday (Authenticate).

Archivo: .devin/mcp_config.local.json en el proyecto (o ~/.config/devin/mcp_config.json)

{
  "mcpServers": {
    "vexday": {
      "url": "https://api.vexday.io/mcp",
      "headers": { "Authorization": "Bearer vx_live_SUA_CHAVE" }
    }
  }
}

Documentación oficial ↗

ZedConector o clave

En Zed, prefiere el inicio de sesión: no lee variables de entorno en el encabezado. Si usas la clave, agrega "headers": { "Authorization": "Bearer vx_live_SUA_CHAVE" } solo en la configuración del usuario, nunca en el .zed/settings.json del proyecto.

  1. Pega el bloque de abajo en la configuración del usuario (o en Settings → AI → MCP Servers → Add Server → Add Remote Server).
  2. Haz clic en Authenticate e inicia sesión con tu cuenta de Vexday.
  3. En Settings → AI → MCP Servers, el punto de vexday queda verde.

Archivo: ~/.config/zed/settings.json (en Windows, %APPDATA%\Zed\settings.json)

{
  "context_servers": {
    "vexday": {
      "url": "https://api.vexday.io/mcp"
    }
  }
}

Documentación oficial ↗

OpenCodeConector o clave
  1. Genera la clave de la API en el panel de Vexday, en Integraciones.
  2. Guarda la clave en la variable de entorno VEXDAY_API_KEY (en la terminal: export VEXDAY_API_KEY=vx_live_…) y abre el programa desde esa terminal.
  3. Pega el bloque de abajo en el archivo y revisa con opencode mcp list (o opencode mcp debug vexday). Para el inicio de sesión, quita "oauth" y "headers" y ejecuta opencode mcp auth vexday.

Archivo: ~/.config/opencode/opencode.json (o opencode.json en el proyecto)

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "vexday": {
      "type": "remote",
      "url": "https://api.vexday.io/mcp",
      "oauth": false,
      "headers": { "Authorization": "Bearer {env:VEXDAY_API_KEY}" }
    }
  }
}

Documentación oficial ↗

Otras terminales y automatización

Gemini CLIConector o clave

En versiones antiguas de Gemini CLI, cambia "url" y "type" por "httpUrl": "https://api.vexday.io/mcp".

  1. Genera la clave de la API en el panel de Vexday, en Integraciones.
  2. Guarda la clave en la variable de entorno VEXDAY_API_KEY (en la terminal: export VEXDAY_API_KEY=vx_live_…) y abre el programa desde esa terminal.
  3. Pega el bloque de abajo en el archivo y revisa con gemini mcp list (Connected) o /mcp en la conversación. Para entrar con la cuenta de Vexday en lugar de la clave, quita "headers" y ejecuta /mcp auth vexday en la conversación.

Archivo: ~/.gemini/settings.json (o .gemini/settings.json en el proyecto)

{
  "mcpServers": {
    "vexday": {
      "url": "https://api.vexday.io/mcp",
      "type": "http",
      "headers": { "Authorization": "Bearer ${VEXDAY_API_KEY}" }
    }
  }
}

Documentación oficial ↗

Codex CLI (OpenAI)Conector o clave

La misma configuración vale para la extensión de Codex en el editor.

  1. Genera la clave de la API en el panel de Vexday, en Integraciones.
  2. Guarda la clave en la variable de entorno VEXDAY_API_KEY (en la terminal: export VEXDAY_API_KEY=vx_live_…) y abre el programa desde esa terminal.
  3. Pega el bloque de abajo en el archivo y revisa con codex mcp list o /mcp. Sin la línea de la clave, codex mcp login vexday abre el inicio de sesión de Vexday.

Archivo: ~/.codex/config.toml

[mcp_servers.vexday]
url = "https://api.vexday.io/mcp"
bearer_token_env_var = "VEXDAY_API_KEY"

Documentación oficial ↗

n8nConector o clave

Requiere n8n 1.104 o más reciente (HTTP Streamable). Para el inicio de sesión, usa Authentication: MCP OAuth2.

  1. Genera la clave de la API en el panel de Vexday, en Integraciones.
  2. En el nodo AI Agent, en Tool, agrega MCP Client Tool.
  3. Endpoint: https://api.vexday.io/mcp; Server Transport: HTTP Streamable.
  4. Authentication: Bearer Auth, con una credencial nueva. En Bearer Token, pega solo la clave (vx_live_…), sin Bearer: n8n lo agrega solo.
  5. En Tools to Include, elige Selected: si las herramientas de Vexday aparecen en la lista, la conexión funciona.

Documentación oficial ↗

¿Algo salió mal?

La aplicación dice que la clave no es válida (401)La clave fue revocada o se pegó con un espacio. Genera otra en Integraciones y pégala de nuevo. En n8n, pega solo la clave: agrega el Bearer solo.
Aparece que el plan no incluye el MCP (403)El MCP es de los planes SOC y MSSP. Revisa el plan de la cuenta en Cuenta y plan.
Demasiadas peticiones por minutoEl asistente llamó muchas herramientas seguidas. Espera un minuto: el límite por minuto se restablece solo.
El conector no abre la pantalla de inicio de sesiónRevisa que la dirección termine en /mcp y que la aplicación esté en el modo de inicio de sesión (OAuth), no en el de clave.

Preguntas frecuentes

¿Necesito instalar algo?

No. El servidor está en Vexday: solo registras la dirección en la aplicación.

¿Funciona con una aplicación que no está en la lista?

Sí, con cualquier cliente MCP que use HTTP: registra la dirección y envía la clave en el encabezado Authorization.

¿Qué ve el asistente de mi cuenta?

El stack monitoreado, las alertas y la exposición de la cuenta conectada, solo en lectura. Ninguna herramienta cambia la cuenta.

Sigue