# MCP

Usa Happ desde Claude Code, Cursor, ChatGPT y otras herramientas de IA: servidor MCP, llms.txt, OpenAPI

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Todo en este sitio es legible por máquina. Apunta tu herramienta de IA a él en lugar de leerlo a mano.

## Servidor MCP [#mcp-server]

El servidor [`@happ-ai/platform-mcp`](https://www.npmjs.com/package/@happ-ai/platform-mcp) expone la plataforma Happ como herramientas: gestiona empresas, agentes, canales, chats, conocimiento y más, directamente desde tu asistente de IA.

### Claude Code [#claude-code]

```bash
claude mcp add -s user happ -- npx -y @happ-ai/platform-mcp@latest
```

Mantén el sufijo `@latest`: sin él, npx fija la primera versión que descargó y nunca recoge una nueva.

### Cursor / Windsurf / cualquier cliente MCP [#cursor--windsurf--any-mcp-client]

```json
{
  "mcpServers": {
    "happ": {
      "command": "npx",
      "args": ["-y", "@happ-ai/platform-mcp@latest"]
    }
  }
}
```

### OpenAI Agents SDK [#openai-agents-sdk]

```python
from agents.mcp import MCPServerStdio

happ = MCPServerStdio(params={
    "command": "npx",
    "args": ["-y", "@happ-ai/platform-mcp@latest"],
})
```

Después inicia sesión con la herramienta `happ_login`, o proporciona un token de acceso de [my.happ.tools](https://my.happ.tools).

## La documentación en Markdown [#docs-as-markdown]

| Qué                                 | URL                                                                                                                                                                           |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Índice de todas las páginas         | [/llms.txt](https://docs.happ.tools/llms.txt)                                                                                                                                 |
| Toda la documentación en un archivo | [/llms-full.txt](https://docs.happ.tools/llms-full.txt)                                                                                                                       |
| Cualquier página en Markdown        | antepón `/llms.mdx` a la ruta y añade `.md`, p. ej. [/llms.mdx/en/docs/getting-started/quickstart.md](https://docs.happ.tools/llms.mdx/en/docs/getting-started/quickstart.md) |

Cada página de la documentación también tiene los botones **Copy Markdown**, **Open in Claude** y **Open in ChatGPT**.

## API para generar código [#api-for-code-generation]

| Qué                                  | URL                                                                        |
| ------------------------------------ | -------------------------------------------------------------------------- |
| Especificación OpenAPI 3.0           | [api.happ.tools/api/swagger-json](https://api.happ.tools/api/swagger-json) |
| Referencia de la API (documentación) | [/en/api](/api)                                                            |
| Cliente interactivo                  | [api.happ.tools/reference](https://api.happ.tools/reference)               |

Pasa la especificación OpenAPI a tu herramienta y pídele que genere la integración:

```text
Read https://api.happ.tools/api/swagger-json and write a client that
creates an assistant, uploads knowledge, and connects a Telegram bot.
Authenticate with the X-Access-Token header.
```