Comment Créer Votre Propre FAQ avec Docusaurus et MCP
Créez un site de documentation professionnel en quelques minutes, puis laissez Claude AI écrire et gérer votre contenu via le Model Context Protocol (MCP).
Ce Que Vous Allez Construire
À la fin de ce guide, vous aurez :
- Un site de documentation Docusaurus fonctionnant sur votre serveur Yundera
- Docusaurus MCP connecté pour que Claude puisse lire, écrire, rechercher et reconstruire vos docs
- Votre première page FAQ publiée et en ligne
Prérequis
- Un Serveur Cloud Personnel Yundera (PCS)
- Accès à Claude ou Claude Code CLI
Étape 1 : Installer Docusaurus sur Yundera
- Ouvrez votre tableau de bord Yundera
- Allez dans l'App Store
- Trouvez Docusaurus et cliquez sur Installer
- Attendez que l'initialisation se termine. Cela crée un projet Docusaurus avec le template classique.
Votre site de docs est maintenant en ligne à https://docusaurus-<votre-domaine>.
La première installation prend une minute car elle exécute npx create-docusaurus et construit le site. Les redémarrages suivants sont rapides.
Étape 2 : Connecter Docusaurus MCP
Docusaurus MCP est automatiquement inclus avec l'application Docusaurus. Il expose votre dossier docs à Claude via le Model Context Protocol.
Option A : Claude.ai (Beacon)
Si votre serveur a Beacon configuré, Docusaurus MCP est auto-découvert. Ouvrez simplement Claude.ai et il apparaîtra dans vos outils disponibles.
Option B : Claude Code CLI
Ajoutez le serveur MCP manuellement :
claude mcp add docusaurus-mcp \
--transport http \
"https://beacon-<votre-serveur>.nsl.sh/mcp?hash=<votre-hash>"
Démarrez une nouvelle session Claude Code et vérifiez avec /mcp. Vous devriez voir docusaurus-mcp listé.
Étape 3 : Les 5 Outils MCP
Docusaurus MCP fournit cinq outils que Claude peut utiliser :
| Outil | Fonction |
|---|---|
list_docs | Liste tous les fichiers .md et .mdx dans votre dossier docs avec chemin, taille et date de modification |
read_doc | Lit le contenu complet d'un fichier doc spécifique |
write_doc | Crée ou écrase un fichier doc (les répertoires parents sont créés automatiquement) |
search_docs | Recherche plein texte insensible à la casse dans tous les docs |
rebuild | Exécute npm run build et copie la sortie vers le serveur web. Vos changements sont immédiatement en ligne |
Tous les chemins sont relatifs au répertoire docs/. Par exemple, guides/my-guide.md fait référence à docs/guides/my-guide.md dans le projet Docusaurus.
Étape 4 : Écrire Votre Première FAQ
Demandez maintenant à Claude de créer votre première page FAQ. Vous pouvez simplement dire :
"Crée une page FAQ pour mon projet. Inclus des questions sur le démarrage, la tarification et le dépannage."
Claude utilisera write_doc pour créer le fichier, puis rebuild pour le publier.
Exemple : Approche Manuelle
Si vous préférez être spécifique, demandez à Claude :
"Utilise docusaurus-mcp pour écrire un fichier à faq/general.md avec le contenu suivant, puis reconstruis le site."
Claude va :
- Appeler
write_doc("faq/general.md", "...")pour créer le fichier - Appeler
rebuild()pour construire et déployer
Exemple de Contenu FAQ
Voici un exemple de ce que Claude pourrait générer :
---
title: FAQ Générale
sidebar_label: Général
sidebar_position: 1
---
# FAQ Générale
## Qu'est-ce que ce projet ?
Une brève description de votre projet et ce qu'il fait.
## Comment démarrer ?
1. Inscrivez-vous sur notre site
2. Suivez le guide de démarrage
3. Rejoignez notre communauté pour de l'aide
## Y a-t-il un plan gratuit ?
Oui ! Nous offrons un niveau gratuit qui inclut...
Étape 5 : Bonnes Pratiques SEO
Chaque page de doc devrait inclure un frontmatter pour l'optimisation des moteurs de recherche :
---
title: "Titre de Votre Page"
description: "Une description de 150-160 caractères pour les résultats de recherche Google"
keywords:
- mot-clé1
- mot-clé2
- mot-clé3
image: /img/yundera-social-card.png
---
Pourquoi C'est Important
- title : Apparaît dans les onglets du navigateur et les résultats Google
- description : Affiché comme extrait sous le titre dans les résultats de recherche
- keywords : Aide les moteurs de recherche à comprendre votre contenu
- image : Aperçu sur les réseaux sociaux quand quelqu'un partage votre lien
Vous pouvez demander à Claude : "Révise tous mes docs et ajoute le frontmatter SEO aux pages qui en manquent." Claude utilisera list_docs et read_doc pour vérifier chaque fichier, puis write_doc pour ajouter les métadonnées manquantes.
Étape 6 : Organiser Vos Docs
Docusaurus utilise la structure de dossiers à l'intérieur de docs/ pour créer la navigation de la barre latérale :
docs/
intro.md
getting-started/
what-is-a-pcs.md
how-it-works.md
guides/
installing-apps.md
custom-domain.md
faq/
general.md
troubleshooting.md
reference/
glossary.md
Ordre de la Barre Latérale
Utilisez sidebar_position dans le frontmatter pour contrôler l'ordre :
---
sidebar_position: 1
---
Les numéros plus bas apparaissent en premier.
Demander à Claude de Réorganiser
Vous pouvez demander à Claude de restructurer vos docs :
"Liste tous mes docs et suggère une meilleure structure de dossiers. Puis déplace les fichiers."
Claude utilisera list_docs pour voir la disposition actuelle, proposer des changements, et utiliser write_doc pour créer les fichiers aux nouveaux emplacements.
Et Ensuite ?
Maintenant que votre site FAQ fonctionne et que MCP est connecté, vous pouvez :
- Ajouter plus de contenu : Dites simplement à Claude quoi écrire
- Personnaliser le thème : Éditez le CSS dans votre
src/css/custom.cssDocusaurus - Configurer un domaine personnalisé : Voir notre Guide Domaine Personnalisé
- Rechercher dans vos docs : Demandez à Claude de trouver du contenu spécifique
Avec Docusaurus MCP, votre documentation n'est jamais qu'à une conversation. Besoin de mettre à jour une page ? Demandez simplement. Envie d'ajouter une toute nouvelle section ? Décrivez-la et Claude s'occupe du reste — écrire le contenu, organiser les fichiers et reconstruire le site.