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.
NotHoly tiene dos superficies, y cada una hace un trabajo distinto.
- La API en
https://api.notholy.com/v1es 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/mcpes 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 /v1 | MCP /mcp | |
|---|---|---|
| Inferencia (chat, completions, mensajes de Anthropic) | Sí | No, no es un endpoint de inferencia |
| Compatible con OpenAI y Anthropic | Sí | — |
Base de conocimiento CKE 2.0 (kb_search, kb_read) | No | Sí |
| Registros y búsqueda de CVE | No | Sí |
| Advisories de paquetes (OSV) | No | Sí |
| Búsqueda web y lectura de páginas | No | Sí |
| Análisis estático de archivos | No | Sí |
| Inteligencia de red pasiva (IP, DNS, WHOIS, ASN, sitio, filtraciones) | No | Sí |
| Búsqueda en índices de la dark web | No | Sí |
| Registro de skills | No | Sí |
| Transporte | HTTP (REST, SSE para streams) | Streamable HTTP (MCP, JSON-RPC) |
| Autenticación | Authorization: Bearer o x-api-key | Authorization: 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.
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.