GitScrum / Docs

Wiki

Gestion du wiki via MCP. Créez, organisez et recherchez les pages wiki de projet pour la documentation d'équipe et les bases de connaissances.

Open Source — GitScrum MCP Server est open source sous la licence MIT. Disponible sur npm et sur GitHub. Serveur Model Context Protocol pour GitScrum — Claude, GitHub Copilot, Cursor et tout client compatible MCP disposent d'un accès opérationnel complet à votre stack de gestion de projets.

L'outil wiki fournit 5 actions pour créer, organiser et rechercher les pages wiki de projet. Les wikis sont la documentation vivante de votre équipe — guides d'onboarding, décisions d'architecture, références API, runbooks et documentation de processus qui restent dans le contexte du projet et évoluent avec le codebase.

Les pages wiki supportent le contenu Markdown complet et l'organisation hiérarchique via des relations parent-enfant. Votre assistant IA peut créer des structures documentaires entières, mettre à jour des pages existantes et rechercher dans le contenu du wiki — le tout via une conversation en langage naturel.


Aperçu des actions

ActionObjectifParamètres requis
listLister toutes les pages wiki d'un projetcompanyslug, projectslug
getObtenir le contenu complet d'une page wikiuuid, companyslug, projectslug
createCréer une nouvelle page wikicompanyslug, projectslug, title, content
updateModifier le titre ou le contenu d'une page wiki existanteuuid, companyslug, projectslug
searchRechercher dans le contenu du wiki par mot-clécompanyslug, projectslug, q

Lister les pages wiki

L'action list retourne toutes les pages wiki d'un projet. Chaque page de la réponse inclut son uuid, titre, auteur, date de création et référence de page parente — vous donnant la structure complète de l'arborescence de pages.

Paramètres requis

ParamètreTypeDescription
company_slugstringIdentifiant du workspace (depuis l'outil workspace)
project_slugstringIdentifiant du projet (depuis l'outil project)
You:  "Liste toutes les pages wiki du projet Backend"
AI:   Appelle wiki action=list → retourne l'arborescence des pages avec titres et hiérarchie

You:  "Montre-moi la structure documentaire du projet Mobile App"
AI:   Appelle wiki action=list → affiche les pages organisées par relations parent-enfant

You:  "Quelle documentation existe dans ce projet ?"
AI:   Appelle wiki action=list → résume les pages wiki disponibles

Obtenir le contenu d'une page wiki

L'action get retourne la page wiki complète — titre, contenu en Markdown, auteur, horodatages et référence de page parente. C'est ainsi que vous lisez une page de documentation spécifique.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID de la page wiki (depuis la réponse list ou search)
company_slugstringIdentifiant du workspace
project_slugstringIdentifiant du projet
You:  "Montre-moi la page wiki du guide d'onboarding"
AI:   Trouve la page depuis la liste → appelle wiki action=get → retourne le contenu Markdown complet

You:  "Lis la documentation de référence API"
AI:   Appelle wiki action=get → retourne le contenu complet de la page

You:  "Que dit le runbook de déploiement ?"
AI:   Trouve la page → appelle wiki action=get → résume ou affiche le contenu

Créer des pages wiki

L'action create construit une nouvelle page wiki avec un titre et du contenu Markdown. Les pages peuvent être créées comme documentation de premier niveau ou imbriquées sous une page parente pour construire des structures hiérarchiques.

Paramètres requis

ParamètreTypeDescription
company_slugstringIdentifiant du workspace
project_slugstringIdentifiant du projet
titlestringTitre de la page — descriptif et scannable
contentstringCorps de la page au format Markdown

Paramètres optionnels

ParamètreTypeDescription
parent_uuidstringUUID de la page wiki parente pour imbriquer cette page. Omettez pour une page de premier niveau.

Exemples de prompts

You:  "Crée une page wiki 'Onboarding Guide' dans le projet Backend avec
       des instructions de configuration pour les nouveaux développeurs"
AI:   Appelle wiki action=create avec le titre et un contenu Markdown complet

You:  "Crée une page wiki 'REST API Reference' documentant nos endpoints"
AI:   Appelle wiki action=create avec le titre et une documentation API structurée

You:  "Ajoute une page enfant 'Authentication Flow' sous la section Architecture"
AI:   Trouve le UUID de la page Architecture → appelle wiki action=create avec parent_uuid

You:  "Crée un runbook de déploiement couvrant les procédures de staging et production"
AI:   Appelle wiki action=create avec un contenu Markdown détaillé étape par étape

Structures de pages imbriquées

Utilisez parent_uuid pour construire des hiérarchies documentaires. L'assistant IA peut créer des structures entières en une seule conversation :

You:  "Crée une section wiki Architecture avec des pages enfants pour
       Database Design, API Layer et Authentication"
AI:   1. Crée "Architecture" comme page de premier niveau
      2. Crée "Database Design" avec parent_uuid d'Architecture
      3. Crée "API Layer" avec parent_uuid d'Architecture
      4. Crée "Authentication" avec parent_uuid d'Architecture

Mettre à jour les pages wiki

L'action update modifie une page wiki existante. Seuls les champs que vous spécifiez sont modifiés — si vous mettez à jour uniquement le contenu, le titre reste inchangé, et vice versa.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID de la page wiki
company_slugstringIdentifiant du workspace
project_slugstringIdentifiant du projet

Paramètres optionnels

ParamètreTypeDescription
titlestringTitre de la page mis à jour
contentstringCorps de la page mis à jour au format Markdown
You:  "Mets à jour le guide d'onboarding avec les nouvelles instructions du pipeline CI/CD"
AI:   Trouve la page → appelle wiki action=update avec le contenu Markdown révisé

You:  "Renomme la page de documentation API en 'REST API v3 Reference'"
AI:   Appelle wiki action=update avec title="REST API v3 Reference"

You:  "Ajoute une section sur la gestion d'erreurs à la page wiki de référence API"
AI:   Obtient le contenu actuel → ajoute la nouvelle section → appelle wiki action=update

Rechercher dans le contenu du wiki

L'action search effectue une recherche par mot-clé dans toutes les pages wiki d'un projet. Les résultats incluent les pages correspondantes avec leurs UUID et titres, vous permettant de naviguer directement vers la documentation pertinente.

Paramètres requis

ParamètreTypeDescription
company_slugstringIdentifiant du workspace
project_slugstringIdentifiant du projet
qstringRequête de recherche (minimum 2 caractères)

Paramètres optionnels

ParamètreTypeDescription
limitnumberNombre maximum de résultats à retourner (1-50)
You:  "Recherche 'database migration' dans le wiki"
AI:   Appelle wiki action=search avec q="database migration" → retourne les pages correspondantes

You:  "Trouve les pages wiki sur l'authentification"
AI:   Appelle wiki action=search avec q="authentication" → liste la documentation pertinente

You:  "Y a-t-il de la documentation sur le processus de déploiement ?"
AI:   Appelle wiki action=search avec q="deployment" → retourne les pages correspondantes ou vide

You:  "Recherche 'API' dans la documentation du projet, montre les 5 premiers résultats"
AI:   Appelle wiki action=search avec q="API", limit=5

Patterns de base de connaissances

Les wikis sont plus efficaces lorsqu'ils sont organisés autour de patterns prévisibles. Voici des structures recommandées pour les projets techniques :

Structure documentaire de projet

📄 Overview
  📄 Architecture
    📄 Database Design
    📄 API Layer
    📄 Authentication
  📄 Getting Started
    📄 Local Setup
    📄 Environment Variables
    📄 Running Tests
  📄 Deployment
    📄 Staging Runbook
    📄 Production Runbook
    📄 Rollback Procedures
  📄 API Reference
    📄 Endpoints
    📄 Error Codes
    📄 Rate Limits

Construire la structure

Votre assistant IA peut scaffolder une structure documentaire complète en une seule conversation :

You:  "Crée un wiki de documentation complet pour le projet Backend. Inclus
       des sections pour Architecture, Getting Started, Deployment et API Reference.
       Chaque section doit avoir des pages enfants pertinentes."
AI:   Crée 10 à 15 pages wiki avec des relations parent_uuid hiérarchiques,
      en remplissant chacune avec du contenu initial

Maintenir la documentation à jour

Mettez à jour les pages au fur et à mesure que le codebase évolue. L'action search aide à trouver les pages qui nécessitent une révision :

You:  "Recherche dans le wiki les références à l'ancien endpoint d'authentification"
AI:   Appelle wiki action=search avec q="auth" → identifie les pages à mettre à jour

You:  "Mets à jour toutes les pages wiki qui référencent l'API v2 pour pointer vers la v3"
AI:   Recherche → lit chaque page → met à jour les références

Wiki vs Discussions vs NoteVault

Choisissez le bon outil pour le type de contenu :

AspectWiki (cet outil)DiscussionsNoteVault
PortéeDocumentation au niveau du projetConversations au niveau du projetNotes personnelles/partagées
StructurePages hiérarchiquesCommentaires en filNotes organisées en dossiers
Cycle de vieLongue durée, évolue dans le tempsOuvert → fermé une fois résoluEspace personnel
Idéal pourGuides d'onboarding, runbooks, référencesDécisions, propositions, débatsNotes de réunion, brouillons, notes rapides

Résolution automatique du contexte

L'outil wiki supporte la résolution automatique du contexte. Si votre assistant IA connaît déjà le workspace et le projet depuis un appel précédent dans la conversation, vous pouvez dire « crée une page wiki » sans spécifier le projet — le contexte est conservé.


Prochaines étapes

  • NoteVault : Gérez vos notes personnelles et partagées avec une organisation par dossiers.
  • Discussions : Créez des fils de discussion thématiques pour les décisions d'équipe.
  • Recherche : Recherchez dans toutes les entités GitScrum, y compris les pages wiki.
  • Démarrage rapide : Configurez le serveur MCP si ce n'est pas déjà fait.