Qmd Init

qmd collection add . --name [nom-projet] --mask "**/*.md"
qmd context add qmd://[nom-projet] "Plans, specs, handoffs, reviews, bug reports"

Étape 4 — Indexer

qmd embed
qmd status

Étape 5 — Configurer le MCP

Ajouter dans .claude/settings.json :

{
  "mcpServers": {
    "qmd": {
      "command": "qmd",
      "args": ["mcp"]
    }
  }
}

Mettre à jour §0 de CLAUDE.md : MCPs actifs | qmd.

Étape 6 — Test

qmd query "test" --files -n 3

Si des résultats → QMD fonctionne.

"QMD installé et indexé. [N] fichiers markdown indexés. Pour chercher : qmd query 'ton sujet' --files Guide complet : docs/qmd-user-guide.md"

Règles

• Ne proposer que si ≥ 5 fichiers .md dans le projet
• Ne pas forcer l'installation
• Guide complet → docs/qmd-user-guide.md (déjà dans le repo)
• Voir aussi src/fr/ecosystem/qmd-integration.md pour les règles d'utilisation par Claude

Après l'installation

L'indexation peut prendre 30-60 secondes et faire tourner le ventilateur (téléchargement et calcul des embeddings localement). C'est normal — les embeddings sont calculés localement.

Important — redémarrage obligatoire :

Redémarrer le chat dans VS Code ne suffit pas. Le MCP est chargé au démarrage du processus Claude Code, pas du chat.

Pour forcer le rechargement des MCP servers :

• Option A (VS Code) : Cmd+Shift+P → Claude Code: Restart (ou Claude Code: Restart Server) → tue et relance le processus
• Option B : fermer et rouvrir VS Code complètement

QMD via Bash (qmd query "...") fonctionne immédiatement sans redémarrage. C'est le MCP natif (outil intégré directement dans Claude) qui nécessite le redémarrage.

"QMD installé. ⚠️ Redémarre le processus Claude Code (Cmd+Shift+P → Claude Code: Restart) pour activer le MCP. En attendant, qmd query via Bash fonctionne déjà."