Saltar al contenido
NotHolyDocs

MCP

API vs MCP

La API te da el modelo en bruto. El servidor MCP le da a ese modelo CKE 2.0 y las herramientas de investigación. Conecta las dos.

Ver en Markdown

NotHoly tiene dos superficies, y cada una hace un trabajo distinto.

  • La API en https://api.notholy.com/v1 es inferencia en bruto. Envías mensajes y recibes la respuesta del modelo. Es compatible con OpenAI y Anthropic, así que cualquier cliente que hable esas APIs habla NotHoly. Aquí el modelo no tiene recuperación de información ni herramientas propias.
  • El servidor MCP en https://api.notholy.com/mcp es la capa de inteligencia. Le da a un modelo Cybersecurity Knowledge Engine 2.0 (CKE 2.0) y las herramientas de investigación: registros de CVE, advisories de paquetes, lectura de web y de páginas, análisis de archivos, inteligencia de red pasiva y el registro de skills. Son las mismas herramientas que usa el chat de investigación.

Si conectas solo la API, obtienes el modelo y nada más. CKE 2.0 y las herramientas están detrás del servidor MCP. Para tenerlos, conecta el MCP.

Qué te da cada uno

API /v1MCP /mcp
Inferencia (chat, completions, mensajes de Anthropic)SíNo, no es un endpoint de inferencia
Compatible con OpenAI y AnthropicSí—
Base de conocimiento CKE 2.0 (kb_search, kb_read)NoSí
Registros y búsqueda de CVENoSí
Advisories de paquetes (OSV)NoSí
Búsqueda web y lectura de páginasNoSí
Análisis estático de archivosNoSí
Inteligencia de red pasiva (IP, DNS, WHOIS, ASN, sitio, filtraciones)NoSí
Búsqueda en índices de la dark webNoSí
Registro de skillsNoSí
TransporteHTTP (REST, SSE para streams)Streamable HTTP (MCP, JSON-RPC)
AutenticaciónAuthorization: Bearer o x-api-keyAuthorization: Bearer

Los endpoints del modelo en bruto, POST /v1/chat/completions, /v1/responses y /v1/messages, no traen ninguna de estas herramientas. El modelo solo recibe las herramientas de función que tú defines y envías, y tu propio código las ejecuta. El servidor MCP es la forma de darle a un modelo las herramientas de NotHoly sin escribir ese código de enlace.

¿Quieres CKE 2.0 y las herramientas? Conecta el MCP

Apunta tu cliente MCP a https://api.notholy.com/mcp y envía tu clave de API en la cabecera Authorization: Bearer. La misma clave sirve para la API y para el servidor MCP.

Shell
claude mcp add --transport http notholy https://api.notholy.com/mcp --header "Authorization: Bearer $NOTHOLY_API_KEY"

La guía de punta a punta explica cómo conseguir una clave, llamar a /v1 para inferencia, conectar el MCP en los clientes más comunes y usar cada herramienta con ejemplos de entrada y salida.

¿Qué camino necesito?

  • Solo quieres respuestas del modelo desde tu código o tu cliente: usa la API. No hay nada más que configurar.
  • Quieres que un modelo (en Claude Code, Cursor, tu propio agente) consulte CVEs, busque en CKE 2.0, lea páginas o analice archivos: conecta el servidor MCP.
  • Quieres estos datos en tu propio código, sin agente, como HTTP simple: la API de investigación expone rutas de CKE 2.0, CVE, advisories, web y archivos bajo /v1.

Siguientes pasos