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 :
| Action | Objectif | Paramètres requis |
|---|---|---|
list | Lister toutes vos notes | company_slug |
get | Obtenir le contenu complet d'une note | uuid, company_slug |
create | Créer une nouvelle note | company_slug, title, content |
update | Modifier une note existante | uuid, company_slug |
share | Partager une note avec des membres de l'équipe | uuid, company_slug |
revisions | Consulter l'historique des révisions d'une note | uuid, company_slug |
Outil Note Folder — Aperçu des actions
L'outil note_folder fournit 4 actions pour la gestion des dossiers :
| Action | Objectif | Paramètres requis |
|---|---|---|
list | Lister tous les dossiers de notes | company_slug |
create | Créer un nouveau dossier | company_slug, name |
update | Renommer un dossier | uuid, company_slug, name |
move | Déplacer une note dans ou hors d'un dossier | noteuuid, 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ètre | Type | Description |
|---|---|---|
company_slug | string | Identifiant 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 dateCré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ètre | Type | Description |
|---|---|---|
company_slug | string | Identifiant du workspace |
title | string | Titre de la note |
content | string | Corps 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 MarkdownMettre à 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ètre | Type | Description |
|---|---|---|
uuid | string | UUID de la note (depuis la réponse list ou get) |
company_slug | string | Identifiant du workspace |
Paramètres optionnels
| Paramètre | Type | Description |
|---|---|---|
title | string | Titre de la note mis à jour |
content | string | Corps 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 titrePartager 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ètre | Type | Description |
|---|---|---|
uuid | string | UUID de la note |
company_slug | string | Identifiant du workspace |
Paramètres
| Paramètre | Type | Description |
|---|---|---|
usernames | array of strings | Noms 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'utilisateurHistorique 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ètre | Type | Description |
|---|---|---|
uuid | string | UUID de la note |
company_slug | string | Identifiant 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édenteGé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ètre | Type | Description |
|---|---|---|
company_slug | string | Identifiant 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 dossiersCréer des dossiers
Crée un nouveau dossier pour organiser les notes.
| Paramètre | Type | Description |
|---|---|---|
company_slug | string | Identifiant du workspace (requis) |
name | string | Nom 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 nomRenommer des dossiers
Met à jour le nom d'un dossier existant.
| Paramètre | Type | Description |
|---|---|---|
uuid | string | UUID du dossier (requis) |
company_slug | string | Identifiant du workspace (requis) |
name | string | Nouveau 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ètre | Type | Description |
|---|---|---|
note_uuid | string | UUID de la note (requis) |
company_slug | string | Identifiant du workspace (requis) |
folder_uuid | string | UUID 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 chacuneWorkflow 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équentiellement2. 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 correspondant3. 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'utilisateur4. 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évisionsNoteVault vs Wiki vs Discussions
Choisissez le bon outil de collaboration :
| Aspect | NoteVault (cet outil) | Wiki | Discussions |
|---|---|---|---|
| Propriété | Personnelle, optionnellement partagée | Propriété du projet | Propriété du projet |
| Organisation | Par dossiers | Pages hiérarchiques | Commentaires en fil |
| Visibilité | Privée tant que non partagée | Tous les membres du projet | Tous les membres du projet |
| Versioning | Historique des révisions | Mises à jour des pages | Fil de commentaires |
| Idéal pour | Notes de réunion, recherche, brouillons | Runbooks, guides, références | Dé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.