# Configurer le serveur MCP

> Brancher le serveur MCP de la documentation Wakastart dans Claude Code, Claude Desktop, Cursor ou VS Code, puis vérifier qu'il répond.

Le serveur MCP de la documentation permet à votre assistant IA de chercher dans ces pages au fil de la conversation. Il est public : aucune clé ni aucun compte n'est nécessaire.

## Avant de commencer

- [ ] Un assistant compatible avec les serveurs MCP distants en HTTP : Claude Code, Claude Desktop, Cursor ou VS Code avec GitHub Copilot.
- [ ] Un accès sortant vers `https://docs.wakastart.app`.

L'adresse du serveur est `https://docs.wakastart.app/api/mcp`.

## Ajouter le serveur

::::tabs{sync="client"}
:::tab{label="Claude Code"}
Dans un terminal, à la racine de votre projet, exécutez :

```bash
claude mcp add --transport http wakastart-docs https://docs.wakastart.app/api/mcp
```

Pour partager la configuration avec votre équipe, ajoutez plutôt le serveur dans le fichier `.mcp.json` à la racine du dépôt :

```json title=".mcp.json"
{
  "mcpServers": {
    "wakastart-docs": {
      "type": "http",
      "url": "https://docs.wakastart.app/api/mcp"
    }
  }
}
```

Résultat : `claude mcp list` affiche `wakastart-docs`.
:::
:::tab{label="Claude Desktop"}
1. Dans Claude Desktop, ouvrez **Paramètres**, puis **Connecteurs**.
2. Cliquez sur **Ajouter un connecteur personnalisé**.
3. Saisissez le nom `Wakastart Docs` et l'URL `https://docs.wakastart.app/api/mcp`, puis validez.

Résultat : le connecteur apparaît dans la liste et ses outils sont proposés dans les conversations.
:::
:::tab{label="Cursor"}
Ajoutez le serveur dans `.cursor/mcp.json` à la racine du projet, ou dans `~/.cursor/mcp.json` pour tous vos projets :

```json title=".cursor/mcp.json"
{
  "mcpServers": {
    "wakastart-docs": {
      "url": "https://docs.wakastart.app/api/mcp"
    }
  }
}
```

Résultat : dans **Settings > MCP**, `wakastart-docs` apparaît avec ses outils.
:::
:::tab{label="VS Code"}
Ajoutez le serveur dans `.vscode/mcp.json` à la racine du projet :

```json title=".vscode/mcp.json"
{
  "servers": {
    "wakastart-docs": {
      "type": "http",
      "url": "https://docs.wakastart.app/api/mcp"
    }
  }
}
```

Résultat : le serveur apparaît dans la liste des outils du mode agent de Copilot.
:::
::::

## Vérifier le résultat

1. Dans un terminal, demandez la liste des outils au serveur :

   ```bash
   curl -s https://docs.wakastart.app/api/mcp \
     -H 'Content-Type: application/json' \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
   ```

   La réponse contient les cinq outils `list_endpoints`, `get_endpoint_spec`, `search_docs`, `get_auth_flow` et `get_error_code`.

2. Dans votre assistant, posez une question sur Wakastart, par exemple : « D'après la documentation Wakastart, comment ma wakapp obtient-elle l'adresse de connexion Keycloak ? ».

   L'assistant appelle l'outil `search_docs` et cite la page [Discovery](/v1.0/reference-api/discovery).

## Exemples de questions

| Question | Outil appelé |
|---|---|
| « Comment fonctionne la connexion d'une wakapp avec PKCE ? » | `get_auth_flow`, `search_docs` |
| « Quel corps attend `POST /api/invitations` ? » | `get_endpoint_spec` |
| « Pourquoi l'API me répond `403` `Droit applicatif requis` ? » | `get_error_code`, `search_docs` |
| « Quelle est la limite de débit de l'API publique ? » | `search_docs` |

## Dépannage

- **L'assistant ne voit pas les outils** : vérifiez l'adresse, terminée par `/api/mcp`, puis redémarrez l'assistant ou rechargez sa configuration.
- **La réponse semble ancienne ou imprécise** : demandez à l'assistant d'utiliser `search_docs` ou de lire la page Markdown correspondante, puis vérifiez sur ce site.

## Voir aussi

- [Référence du serveur MCP](/v1.0/outils-ia/reference-mcp)
- [Outils pour assistants IA](/v1.0/outils-ia) : `llms.txt` et pages Markdown
