GitScrum / Docs

NoteVault

Gestion de NoteVault via MCP. Créez, organisez et partagez des notes personnelles et d'équipe avec une organisation par dossiers et un suivi des révisions.

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.

NoteVault est votre espace de travail personnel et d'équipe pour les notes — résumés de réunions, rétrospectives de sprint, journaux de recherche, brouillons d'architecture et tout ce qui n'a pas encore sa place dans la documentation au niveau du projet. Deux outils fonctionnent ensemble pour gérer NoteVault : l'outil note pour créer et partager des notes, et l'outil note_folder pour organiser les notes en dossiers.

Contrairement aux pages Wiki, qui sont de la documentation à portée projet, les notes NoteVault vous appartiennent. Elles vivent dans votre workspace, peuvent être organisées en dossiers personnels et partagées avec des membres spécifiques de l'équipe lorsqu'elles sont prêtes. Le suivi des révisions vous permet de consulter les versions précédentes de n'importe quelle note.


Outil Note — Aperçu des actions

L'outil note fournit 6 actions pour le cycle de vie complet des notes :

ActionObjectifParamètres requis
listLister toutes vos notescompany_slug
getObtenir le contenu complet d'une noteuuid, company_slug
createCréer une nouvelle notecompany_slug, title, content
updateModifier une note existanteuuid, company_slug
sharePartager une note avec des membres de l'équipeuuid, company_slug
revisionsConsulter l'historique des révisions d'une noteuuid, company_slug

Outil Note Folder — Aperçu des actions

L'outil note_folder fournit 4 actions pour la gestion des dossiers :

ActionObjectifParamètres requis
listLister tous les dossiers de notescompany_slug
createCréer un nouveau dossiercompany_slug, name
updateRenommer un dossieruuid, company_slug, name
moveDéplacer une note dans ou hors d'un dossiernoteuuid, companyslug

Lister les notes

L'action list retourne toutes les notes de votre workspace. Chaque note de la réponse inclut son uuid, titre, assignation de dossier, date de création et statut de partage.

Paramètres requis

ParamètreTypeDescription
company_slugstringIdentifiant du workspace (depuis l'outil workspace)
You:  "Montre toutes mes notes"
AI:   Appelle note action=list → retourne votre inventaire complet de notes

You:  "Liste mes notes dans le workspace Acme"
AI:   Appelle note action=list avec company_slug → retourne les notes du workspace

You:  "Quelles notes ai-je ?"
AI:   Appelle note action=list → résume vos notes par dossier et date

Créer des notes

L'action create construit une nouvelle note avec un titre et du contenu Markdown. Les notes sont créées dans votre espace personnel — elles sont privées tant qu'elles ne sont pas explicitement partagées.

Paramètres requis

ParamètreTypeDescription
company_slugstringIdentifiant du workspace
titlestringTitre de la note
contentstringCorps de la note au format Markdown

Exemples de prompts

You:  "Crée une note 'Sprint 14 Retrospective' avec les notes de la réunion d'aujourd'hui"
AI:   Appelle note action=create avec le titre et le contenu Markdown

You:  "Crée une note sur la recherche de migration de base de données que j'ai menée"
AI:   Appelle note action=create avec les notes de recherche formatées en Markdown

You:  "Prends une note : 'Réunion avec le client — accord sur la roadmap Q2,
       priorité au lancement de l'application mobile avant mars'"
AI:   Appelle note action=create avec les notes de réunion

You:  "Crée une note résumant les options d'architecture que nous avons discutées"
AI:   Appelle note action=create avec une comparaison structurée en Markdown

Mettre à jour les notes

L'action update modifie le titre ou le contenu d'une note. Seuls les champs que vous spécifiez sont modifiés.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID de la note (depuis la réponse list ou get)
company_slugstringIdentifiant du workspace

Paramètres optionnels

ParamètreTypeDescription
titlestringTitre de la note mis à jour
contentstringCorps de la note mis à jour au format Markdown
You:  "Mets à jour ma note de rétrospective avec les actions décidées"
AI:   Trouve la note → appelle note action=update avec le contenu révisé

You:  "Ajoute une section de suivi à mes notes de réunion client"
AI:   Obtient le contenu actuel → ajoute le suivi → appelle note action=update

You:  "Renomme ma note de recherche en 'Database Migration — Recommandation finale'"
AI:   Appelle note action=update avec le titre

Partager des notes

L'action share rend une note visible à des membres spécifiques de l'équipe par nom d'utilisateur. Les notes partagées apparaissent dans la liste de notes du destinataire, permettant une revue collaborative.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID de la note
company_slugstringIdentifiant du workspace

Paramètres

ParamètreTypeDescription
usernamesarray of stringsNoms d'utilisateur des membres de l'équipe avec qui partager la note
You:  "Partage ma note de rétrospective avec @sarah et @john"
AI:   Appelle note action=share avec usernames=["sarah", "john"]

You:  "Partage la note de recherche d'architecture avec l'équipe backend"
AI:   Résout les membres de l'équipe → appelle note action=share avec leurs noms d'utilisateur

You:  "Partage mes notes de réunion avec le chef de projet"
AI:   Identifie le PM → appelle note action=share avec son nom d'utilisateur

Historique des révisions

L'action revisions retourne l'historique des versions d'une note — chaque mise à jour du contenu est enregistrée comme révision. Cela vous permet de suivre l'évolution d'une note dans le temps et de référencer les versions précédentes.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID de la note
company_slugstringIdentifiant du workspace
You:  "Montre l'historique des révisions de ma note d'architecture"
AI:   Appelle note action=revisions → retourne la liste des révisions avec horodatages

You:  "Combien de fois la note d'onboarding a-t-elle été mise à jour ?"
AI:   Appelle note action=revisions → compte les révisions

You:  "À quoi ressemblaient les notes de réunion avant la dernière modification ?"
AI:   Appelle note action=revisions → retourne le contenu de la version précédente

Gérer les dossiers

Les dossiers de notes organisent vos notes en groupes logiques. L'outil note_folder gère la création, le renommage et le déplacement de notes entre dossiers.

Lister les dossiers

Retourne tous les dossiers de votre workspace, chacun avec son uuid et name.

ParamètreTypeDescription
company_slugstringIdentifiant du workspace (requis)
You:  "Montre mes dossiers de notes"
AI:   Appelle note_folder action=list → retourne la liste des dossiers avec les UUID

You:  "Comment sont organisées mes notes ?"
AI:   Appelle note_folder action=list + note action=list → affiche la structure des dossiers

Créer des dossiers

Crée un nouveau dossier pour organiser les notes.

ParamètreTypeDescription
company_slugstringIdentifiant du workspace (requis)
namestringNom du dossier (requis)
You:  "Crée un dossier appelé 'Meeting Notes'"
AI:   Appelle note_folder action=create avec name="Meeting Notes"

You:  "Crée des dossiers pour 'Sprint Retros', 'Research' et 'Client Meetings'"
AI:   Appelle note_folder action=create trois fois avec chaque nom

Renommer des dossiers

Met à jour le nom d'un dossier existant.

ParamètreTypeDescription
uuidstringUUID du dossier (requis)
company_slugstringIdentifiant du workspace (requis)
namestringNouveau nom du dossier (requis)
You:  "Renomme le dossier 'Meeting Notes' en 'Team Meetings'"
AI:   Trouve le dossier → appelle note_folder action=update avec name="Team Meetings"

Déplacer des notes

Déplace une note dans un dossier, ou la retire d'un dossier (la déclasse). Omettez folder_uuid pour retirer une note de son dossier actuel.

ParamètreTypeDescription
note_uuidstringUUID de la note (requis)
company_slugstringIdentifiant du workspace (requis)
folder_uuidstringUUID du dossier cible. Omettez pour retirer la note de son dossier.
You:  "Déplace ma note de rétrospective dans le dossier Sprint Retros"
AI:   Trouve la note + le dossier → appelle note_folder action=move avec les deux UUID

You:  "Retire la note d'architecture de son dossier"
AI:   Appelle note_folder action=move avec note_uuid uniquement (pas de folder_uuid)

You:  "Déplace toutes les notes de réunion vers le dossier Team Meetings"
AI:   Liste les notes → identifie les notes de réunion → appelle move pour chacune

Workflow d'organisation des dossiers

Construisez un espace de travail personnel structuré pour une gestion efficace des notes :

1. Configurer la structure des dossiers

Créez des dossiers qui correspondent à vos patterns de travail.

You:  "Crée les dossiers de notes : 'Sprint Retros', 'Client Meetings',
       'Research', 'Architecture Decisions'"
AI:   Crée quatre dossiers séquentiellement

2. Créer et organiser les notes

Créez des notes et classez-les immédiatement, ou organisez les notes existantes.

You:  "Crée une note 'Sprint 14 Retro' avec les retours de la rétrospective d'aujourd'hui
       et mets-la dans le dossier Sprint Retros"
AI:   Crée la note → la déplace dans le dossier Sprint Retros

You:  "Déplace toutes mes notes non classées de cette semaine dans les dossiers appropriés"
AI:   Liste les notes → catégorise par contenu → déplace chacune vers le dossier correspondant

3. Partager quand c'est prêt

Partagez les notes finalisées avec les membres de l'équipe pour revue ou référence.

You:  "Partage la note Sprint 14 Retro avec toute l'équipe backend"
AI:   Résout les membres de l'équipe → partage la note avec tous les noms d'utilisateur

4. Suivre l'évolution

Utilisez l'historique des révisions pour voir comment les notes ont évolué au fil des itérations.

You:  "Montre comment ma note de décision d'architecture a changé dans le temps"
AI:   Appelle note action=revisions → affiche la chronologie des révisions

NoteVault vs Wiki vs Discussions

Choisissez le bon outil de collaboration :

AspectNoteVault (cet outil)WikiDiscussions
PropriétéPersonnelle, optionnellement partagéePropriété du projetPropriété du projet
OrganisationPar dossiersPages hiérarchiquesCommentaires en fil
VisibilitéPrivée tant que non partagéeTous les membres du projetTous les membres du projet
VersioningHistorique des révisionsMises à jour des pagesFil de commentaires
Idéal pourNotes de réunion, recherche, brouillonsRunbooks, guides, référencesDécisions, propositions, débats

Flux typique : Commencez par une note NoteVault pour les brouillons et les comptes rendus de réunion. Lorsque le contenu mûrit, déplacez-le vers une page Wiki pour l'équipe. Si un sujet nécessite une discussion, créez un fil de Discussion.


Résolution automatique du contexte

Les outils note et note_folder supportent la résolution automatique du contexte. Si votre assistant IA connaît le workspace depuis un appel précédent, vous pouvez dire « crée une note » sans spécifier le workspace à chaque fois.


Prochaines étapes

  • Wiki : Créez de la documentation au niveau du projet à partir de vos notes finalisées.
  • Discussions : Lancez des fils de discussion au niveau du projet.
  • Recherche : Trouvez du contenu dans toutes les entités GitScrum.
  • Démarrage rapide : Configurez le serveur MCP si ce n'est pas déjà fait.