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.
- Durée
- 5 min
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
Dans un terminal, à la racine de votre projet, exécutez :
claude mcp add --transport http wakastart-docs https://docs.wakastart.app/api/mcpPour partager la configuration avec votre équipe, ajoutez plutôt le serveur dans le fichier .mcp.json à la racine du dépôt :
{
"mcpServers": {
"wakastart-docs": {
"type": "http",
"url": "https://docs.wakastart.app/api/mcp"
}
}
}Résultat : claude mcp list affiche wakastart-docs.
- Dans Claude Desktop, ouvrez Paramètres, puis Connecteurs.
- Cliquez sur Ajouter un connecteur personnalisé.
- Saisissez le nom
Wakastart Docset l'URLhttps://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.
Ajoutez le serveur dans .cursor/mcp.json à la racine du projet, ou dans ~/.cursor/mcp.json pour tous vos projets :
{
"mcpServers": {
"wakastart-docs": {
"url": "https://docs.wakastart.app/api/mcp"
}
}
}Résultat : dans Settings > MCP, wakastart-docs apparaît avec ses outils.
Ajoutez le serveur dans .vscode/mcp.json à la racine du projet :
{
"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
-
Dans un terminal, demandez la liste des outils au serveur :
Bashcurl -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_flowetget_error_code. -
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_docset cite la page 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_docsou de lire la page Markdown correspondante, puis vérifiez sur ce site.
Voir aussi
- Référence du serveur MCP
- Outils pour assistants IA :
llms.txtet pages Markdown