# MCP

Utilisez Happ depuis Claude Code, Cursor, ChatGPT et d'autres outils IA — serveur MCP, llms.txt, OpenAPI

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

Tout ce site est lisible par machine. Pointez votre outil IA dessus au lieu de lire manuellement.

## Serveur MCP [#mcp-server]

Le serveur [`@happ-ai/platform-mcp`](https://www.npmjs.com/package/@happ-ai/platform-mcp) expose la plateforme Happ sous forme d'outils : gérez entreprises, assistants, canaux, conversations, connaissances et plus encore — directement depuis votre assistant IA.

### Claude Code [#claude-code]

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

Conservez le suffixe `@latest` : sans lui, npx fige la première version téléchargée et ne récupère jamais les nouvelles.

### Cursor / Windsurf / tout client 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"],
})
```

Connectez-vous ensuite avec l'outil `happ_login`, ou fournissez un jeton d'accès depuis [my.happ.tools](https://my.happ.tools).

## La documentation en Markdown [#docs-as-markdown]

| Quoi                                 | URL                                                                                                                                                                                  |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Index de toutes les pages            | [/llms.txt](https://docs.happ.tools/llms.txt)                                                                                                                                        |
| Toute la documentation en un fichier | [/llms-full.txt](https://docs.happ.tools/llms-full.txt)                                                                                                                              |
| N'importe quelle page en Markdown    | préfixez le chemin par `/llms.mdx`, ajoutez `.md` — p. ex. [/llms.mdx/en/docs/getting-started/quickstart.md](https://docs.happ.tools/llms.mdx/en/docs/getting-started/quickstart.md) |

Chaque page de la documentation a aussi les boutons **Copier en Markdown**, **Ouvrir dans Claude** et **Ouvrir dans ChatGPT**.

## API pour la génération de code [#api-for-code-generation]

| Quoi                      | URL                                                                        |
| ------------------------- | -------------------------------------------------------------------------- |
| Spécification OpenAPI 3.0 | [api.happ.tools/api/swagger-json](https://api.happ.tools/api/swagger-json) |
| Référence de l'API (docs) | [/en/api](/api)                                                            |
| Client interactif         | [api.happ.tools/reference](https://api.happ.tools/reference)               |

Donnez la spécification OpenAPI à votre outil et demandez-lui de générer l'intégration :

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