Plataforma · Para desarrolladores

Conecta tu agente de IA a NorthBound Sentinel

El servidor MCP de NorthBound Sentinel es un servidor remoto del Model Context Protocol (MCP). Conecta tu agente de IA para programar y el asistente que escribe tu código también podrá leer tu superficie de ataque y tus hallazgos, e iniciar una evaluación en un dominio tuyo. Está abierto a todos los planes y se mide por créditos.

01 Capacidades

Qué puede hacer tu agente

Los nombres exactos de las herramientas y sus parámetros los publica el propio servidor (tools/list), así que tu cliente siempre muestra el conjunto vigente. En términos simples:

  • Ver tu inventario

    Lista tus proyectos y dominios, con el estado de verificación de propiedad de cada dominio y la cantidad de hallazgos abiertos.

  • Ver tu superficie expuesta

    Para un dominio, obtiene el mapa de la aplicación que descubrió la plataforma, sus endpoints y las tecnologías que usa, junto con alertas de vulnerabilidades conocidas.

  • Leer hallazgos

    Busca y filtra hallazgos por proyecto, dominio, severidad, estado o palabra clave, y abre uno para ver su evidencia, nivel de prueba, puntuación de severidad y guía de remediación.

  • Obtener un resumen de postura

    Hallazgos abiertos por severidad, qué parte de tu inventario tiene la propiedad verificada, plazos de remediación que se están atrasando y lo más importante para corregir a continuación.

  • Seguir y lanzar evaluaciones

    Lista evaluaciones pasadas y en curso, consulta el estado de una o lanza una evaluación en un dominio tuyo, con las salvaguardas que se describen más abajo.

  • Generar reportes

    Produce un reporte de un proyecto o de un solo dominio como resumen estructurado, documento HTML independiente o PDF con firma digital.

02 Conexión

Conéctate en tres pasos

Úsalo desde Claude Code, Cursor, VS Code o cualquier otro cliente MCP que admita servidores HTTP remotos con encabezados personalizados.

  1. Crea una clave de API

    En la aplicación, abre Settings > API Credentials y crea una credencial. Elige solo los permisos (scopes) que necesitas y, si quieres, limita la clave a una lista de IP permitidas. La clave empieza con nbk_live_ y se muestra una sola vez, así que cópiala de inmediato. Si la pierdes, rótala o crea una nueva.

  2. Agrega el servidor a tu cliente

    Agrega el servidor a Claude Code, Cursor, VS Code o cualquier otro cliente MCP (configuración más abajo). Usa la URL del servidor y envía la clave en el encabezado Authorization: la palabra Bearer, un espacio y luego la clave. Guarda la clave en una variable de entorno o en un gestor de secretos, nunca en un repositorio.

  3. Pídeselo a tu agente

    Por ejemplo: “Lista mis activos de NorthBound y dime cuáles tienen hallazgos abiertos de severidad alta o crítica”. O: “Muéstrame la evidencia y la guía de corrección de ese hallazgo y propón un parche”. O: “Inicia una evaluación pasiva en staging.acme.example y avísame cuando termine”.

03 Datos del servidor

Datos del servidor

Datos del servidor
ElementoValor
URL del servidorhttps://app.northboundintelligence.com/api/mcp
TransporteHTTP con streaming (streamable HTTP): JSON-RPC 2.0 sobre POST, con respuestas JSON
AutenticaciónClave de API en el encabezado Authorization: Bearer nbk_live_.... El servidor también acepta la clave en un encabezado X-API-Token.
HandshakeEl handshake (initialize y tools/list) es público, así que un cliente puede ver qué hay disponible. Para llamar a una herramienta hace falta una clave válida.
Inicio de sesiónSolo clave de API. El inicio de sesión con OAuth todavía no está disponible.
Versiones del protocolo2025-03-26 y 2024-11-05
04 Configuración

Configura tu cliente

Guarda la clave en una variable de entorno llamada NORTHBOUND_API_KEY y luego agrega el servidor a tu cliente. El valor del encabezado es la palabra Bearer, un espacio y luego la clave. Los nombres de las claves varían un poco entre clientes; estas son las configuraciones que funcionan en los tres más comunes.

Define tu clave en el entorno

export NORTHBOUND_API_KEY="nbk_live_..."

Claude Code: un solo comando

claude mcp add --transport http northbound-sentinel \
  https://app.northboundintelligence.com/api/mcp \
  --header "Authorization: Bearer $NORTHBOUND_API_KEY"

Claude Code: .mcp.json en la raíz del proyecto

{
  "mcpServers": {
    "northbound-sentinel": {
      "type": "http",
      "url": "https://app.northboundintelligence.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${NORTHBOUND_API_KEY}"
      }
    }
  }
}

Cursor: ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (este proyecto)

{
  "mcpServers": {
    "northbound-sentinel": {
      "url": "https://app.northboundintelligence.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NORTHBOUND_API_KEY}"
      }
    }
  }
}

VS Code: .vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "northbound-api-key",
      "description": "NorthBound API key (nbk_live_...)",
      "password": true
    }
  ],
  "servers": {
    "northbound-sentinel": {
      "type": "http",
      "url": "https://app.northboundintelligence.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:northbound-api-key}"
      }
    }
  }
}

Lista las herramientas desde una terminal

curl -sS https://app.northboundintelligence.com/api/mcp \
  -H "Authorization: Bearer $NORTHBOUND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Claude Code: la opción de un solo comando guarda la clave ya expandida en tu configuración local de Claude Code, mientras que la opción .mcp.json guarda solo una referencia, así que es seguro subirla al repositorio. Cursor resuelve ${env:NAME} y necesita que el proceso de Cursor vea la variable; reinícialo después de cambiarla. VS Code usa servers como clave raíz, no mcpServers, y puede pedirte la clave para que nunca quede escrita en el archivo. Después confirma que el servidor aparece como conectado: claude mcp list (o /mcp dentro de Claude Code), la sección MCP en los ajustes de Cursor, o MCP: List Servers en VS Code.

05 Permisos

Scopes: dale a la clave solo lo que necesita

Scopes: dale a la clave solo lo que necesita
ScopeQué permite hacer al agente
read_assetsLeer tus proyectos, activos, superficie descubierta y ejecuciones de evaluaciones
read_findingsLeer hallazgos y tu resumen de postura, y generar reportes
launch_scansIniciar evaluaciones. Déjalo desactivado si solo quieres acceso de lectura.

Una clave de solo lectura no puede iniciar una evaluación.

06 Planes y créditos

En todos los planes, medido por créditos

El acceso por MCP no está reservado a un plan en particular. Todos los planes incluyen una cuota mensual de créditos de API, y las llamadas a herramientas los consumen.

En todos los planes, medido por créditos
PlanCréditos de API por mes
Gratuito50
Prueba gratuita500
Pro500
Business1000
Elite2000
CorporativoA medida para tu organización

Si tu plan o tu cuota restante no cubren una llamada, el servidor responde 402. Consulta los planes.

07 Salvaguardas

Salvaguardas incorporadas en el servidor

Tu agente trabaja bajo las mismas reglas que el resto de la plataforma.

  • Solo tus datos

    Cada llamada se limita a tu propia cuenta. Los resultados nunca incluyen datos de otro cliente.

  • Mínimo privilegio

    Las claves llevan scopes. Una clave de solo lectura no puede iniciar una evaluación.

  • Primero la propiedad

    Todo lo que sea más activo que la observación pasiva exige propiedad verificada del dominio. Los dominios sin verificar solo admiten evaluaciones pasivas.

  • Una persona confirma la autorización

    Lanzar una evaluación exige confirmar de forma explícita que estás legalmente autorizado a probar el objetivo, y queda registrado en la auditoría. Tu agente debe preguntarte; no debe confirmarlo por su cuenta.

  • De una en una y con límite de frecuencia

    Las evaluaciones se ejecutan una tras otra por usuario, con un lanzamiento por solicitud, y las llamadas tienen límite de frecuencia por clave.

  • Salida apta para clientes

    Los resultados usan el mismo lenguaje orientado al cliente que la aplicación y los reportes de NorthBound.

08 Solución de problemas

Si una llamada falla

Si una llamada falla
SíntomaCausa probable
401Falta la clave, está mal escrita, venció o fue revocada; la solicitud viene de una IP fuera de la lista permitida de la clave; o el encabezado no es Authorization: Bearer <clave>.
402Tu plan actual o tu cuota de uso no cubre la llamada. Revisa tu plan y tus créditos en la aplicación.
Insufficient scopeLa clave no tiene el scope que necesita esa herramienta. Crea o edita una clave que lo incluya.
429 o límite de frecuenciaDemasiadas llamadas o lanzamientos en poco tiempo. Espera y vuelve a intentar.
El nombre de la variable se envía tal cualLa variable de entorno no está definida en el proceso que inició tu cliente. Claude Code lo advierte y envía el texto literal, que el servidor rechaza con 401.
09 Lo que no es

Qué es esto y qué no es

NorthBound es un equipo de seguridad dirigido por personas y asistido por IA. Este servidor da a tu agente acceso gobernado a tus propios resultados y a las evaluaciones que estás autorizado a ejecutar. Apoya tu revisión; no la reemplaza, y no es una certificación de cumplimiento ni una afirmación de que un sistema sea seguro.

Las evaluaciones se ejecutan solo en dominios que son tuyos o que estás autorizado a probar. Para reportar una vulnerabilidad en NorthBound, consulta cómo reportarla.

Crea una clave y conecta tu agente.

Inicia sesión en la aplicación, abre Settings y luego API Credentials. ¿Dudas sobre el acceso o los planes? Escribe a contact@northboundintelligence.com.

Datos de esta página verificados el 11 de noviembre de 2026.