Skip to content

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.

GuideDeveloper
Duration
5 min

This page has not been translated yet and is shown in French.

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 :

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 :

.mcp.jsonJSON
{
  "mcpServers": {
    "wakastart-docs": {
      "type": "http",
      "url": "https://docs.wakastart.app/api/mcp"
    }
  }
}

Résultat : claude mcp list affiche wakastart-docs.

  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.

Ajoutez le serveur dans .cursor/mcp.json à la racine du projet, ou dans ~/.cursor/mcp.json pour tous vos projets :

.cursor/mcp.jsonJSON
{
  "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 :

.vscode/mcp.jsonJSON
{
  "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.

Exemples de questions

QuestionOutil 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