# Outils pour assistants IA

> Donner à votre assistant IA un accès direct à cette documentation par le serveur MCP, llms.txt, llms-full.txt et la version Markdown de chaque page.

Cette documentation est lisible par les assistants IA, comme Claude, Cursor ou GitHub Copilot, sans copier-coller. Votre assistant peut l'interroger pendant qu'il écrit du code pour votre wakapp : chercher comment fonctionne Discovery, retrouver le corps d'un endpoint ou la cause d'une erreur.

## Comment ça marche

```mermaid
flowchart LR
  A[Votre assistant IA] -- "JSON-RPC (MCP)" --> M["Serveur MCP"]
  A -- "HTTP GET" --> L["llms.txt et llms-full.txt"]
  A -- "HTTP GET" --> P["Page en Markdown (.md)"]
  M --> C[(Pages de la documentation)]
  L --> C
  P --> C
```

Les quatre accès lisent les mêmes pages, celles que vous consultez sur ce site. Aucun ne demande de compte ni de jeton.

## Choisissez votre approche

| Accès | Adresse | Quand l'utiliser |
|---|---|---|
| Serveur MCP | `https://docs.wakastart.app/api/mcp` | Votre assistant gère les serveurs MCP (Claude Code, Claude Desktop, Cursor, VS Code) : il cherche lui-même dans la documentation au fil de la conversation |
| `llms.txt` | `https://docs.wakastart.app/llms.txt` | Donner à un assistant l'index de la documentation : une ligne par page, avec son lien Markdown et sa description |
| `llms-full.txt` | `https://docs.wakastart.app/llms-full.txt` | Charger toute la documentation d'un coup dans le contexte d'un assistant |
| Page en Markdown | Ajoutez `.md` à l'URL d'une page | Donner une page précise, sans la mise en forme du site |

## Version Markdown d'une page

Chaque page de cette documentation existe en Markdown brut. Ajoutez `.md` à son adresse :

```bash
curl -s https://docs.wakastart.app/v1.0/reference-api/discovery.md
```

La page d'accueil d'une section s'obtient de la même façon : `https://docs.wakastart.app/v1.0/reference-api.md`. Sur chaque page du site, le bouton **Voir en Markdown** ouvre cette version, et **Copier la page** la place dans votre presse-papiers. Les versions anglaises sont sous `/en/` : `https://docs.wakastart.app/en/v1.0/reference-api/discovery.md`.

## llms.txt et llms-full.txt

Ces deux fichiers suivent la convention [llmstxt.org](https://llmstxt.org) :

- `llms.txt` liste les pages par famille et par section, avec le lien de leur version Markdown et leur description ;
- `llms-full.txt` contient le texte de toutes les pages, séparées par leur URL.

```bash
curl -s https://docs.wakastart.app/llms.txt | head -20
```

Leurs équivalents anglais sont `https://docs.wakastart.app/en/llms.txt` et `https://docs.wakastart.app/en/llms-full.txt`.

## Commencer

::::cards{cols=2}
:::card{title="Configurer le serveur MCP" href="/v1.0/outils-ia/configurer-le-serveur-mcp" icon="Plug"}
Brancher la documentation dans Claude Code, Claude Desktop, Cursor ou VS Code.
:::
:::card{title="Référence du serveur MCP" href="/v1.0/outils-ia/reference-mcp" icon="Braces"}
Outils exposés, paramètres et ressources.
:::
::::

## Bonnes pratiques

- Demandez à votre assistant de **citer la page** sur laquelle il s'appuie, et vérifiez-la avant de mettre son code en production.
- Pour un endpoint, la page de la [Référence API](/v1.0/reference-api) fait foi : elle décrit les droits requis, les champs et les erreurs.
- N'envoyez jamais un jeton, une clé API ou un secret dans une conversation avec un assistant.
