# 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/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](https://notholy.com/chat).

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` |

> [!NOTE]
> 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.

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

La [guía de punta a punta](/es/mcp/connect) 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](/es/api/chat-completions). 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](/es/mcp/remote).
- Quieres estos datos en tu propio código, sin agente, como HTTP simple: la [API de investigación](/es/api/research) expone rutas de CKE 2.0, CVE, advisories, web y archivos bajo `/v1`.

## Siguientes pasos

- [Usa la API con CKE 2.0 y herramientas](/es/mcp/connect)
- [Servidor MCP remoto](/es/mcp/remote)
- [Servidor MCP local](/es/mcp/local)
