> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nippy.la/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Cómo conectarte directamente al servidor MCP de Nippy

## Servidor MCP

Todo el acceso a Nippy vía IA pasa por un solo endpoint:

```
https://ms.nippy.la/cognitive-layer/mcp
```

Este endpoint implementa el **Model Context Protocol (MCP) sobre HTTP streamable** (JSON-RPC 2.0). Cualquier cliente MCP compatible — Claude Desktop, Cursor, OpenClaw, Hermes Agent — se conecta aquí.

## Autenticación

Cada request debe incluir tu API key en el header:

```http theme={null}
X-API-Key: npk_tu_api_key_aqui
```

<Note>
  Tu API key determina a qué negocio perteneces. No necesitas pasar IDs de negocio en ninguna llamada — el servidor los resuelve automáticamente.
</Note>

## Endpoints disponibles

| Endpoint                       | Método | Uso                                      |
| ------------------------------ | ------ | ---------------------------------------- |
| `/cognitive-layer/mcp`         | `POST` | Servidor MCP principal — todas las tools |
| `/cognitive-layer/oauth/token` | `POST` | OAuth 2.0 para clientes que lo requieran |
| `/cognitive-layer/health`      | `GET`  | Estado del servidor (sin autenticación)  |

## ¿Por dónde empiezo?

Si quieres conectar tu cliente MCP, el quickstart es el lugar correcto.

<Card title="Conecta tu cliente en 3 pasos" icon="rocket" href="/quickstart" horizontal>
  Claude Desktop, Cursor, OpenClaw y Hermes Agent — todo en un solo lugar.
</Card>