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.
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.
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.
-
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. -
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 palabraBearer, un espacio y luego la clave. Guarda la clave en una variable de entorno o en un gestor de secretos, nunca en un repositorio. -
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”.
Datos del servidor
| Elemento | Valor |
|---|---|
| URL del servidor | https://app.northboundintelligence.com/api/mcp |
| Transporte | HTTP con streaming (streamable HTTP): JSON-RPC 2.0 sobre POST, con respuestas JSON |
| Autenticación | Clave de API en el encabezado Authorization: Bearer nbk_live_.... El servidor también acepta la clave en un encabezado X-API-Token. |
| Handshake | El 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ón | Solo clave de API. El inicio de sesión con OAuth todavía no está disponible. |
| Versiones del protocolo | 2025-03-26 y 2024-11-05 |
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.
Scopes: dale a la clave solo lo que necesita
| Scope | Qué permite hacer al agente |
|---|---|
read_assets | Leer tus proyectos, activos, superficie descubierta y ejecuciones de evaluaciones |
read_findings | Leer hallazgos y tu resumen de postura, y generar reportes |
launch_scans | Iniciar evaluaciones. Déjalo desactivado si solo quieres acceso de lectura. |
Una clave de solo lectura no puede iniciar una evaluación.
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.
| Plan | Créditos de API por mes |
|---|---|
| Gratuito | 50 |
| Prueba gratuita | 500 |
| Pro | 500 |
| Business | 1000 |
| Elite | 2000 |
| Corporativo | A medida para tu organización |
Si tu plan o tu cuota restante no cubren una llamada, el servidor responde 402. Consulta los planes.
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.
Si una llamada falla
| Síntoma | Causa probable |
|---|---|
401 | Falta 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>. |
402 | Tu plan actual o tu cuota de uso no cubre la llamada. Revisa tu plan y tus créditos en la aplicación. |
| Insufficient scope | La clave no tiene el scope que necesita esa herramienta. Crea o edita una clave que lo incluya. |
429 o límite de frecuencia | Demasiadas llamadas o lanzamientos en poco tiempo. Espera y vuelve a intentar. |
| El nombre de la variable se envía tal cual | La 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. |
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.