Intégration Claude Code

Ce guide vous accompagne dans la configuration de Distill avec Claude Code.

Prérequis

• Claude Code installé (npm install -g @anthropic-ai/claude-code ou télécharger)
• Node.js 20+ installé

Configuration rapide (30 secondes)

npm install -g distill-mcp
distill-mcp setup

Terminé ! Redémarrez Claude Code et vous êtes prêt.

Configuration manuelle

Si la configuration automatique n'a pas fonctionné :

Option 1 : Via CLI (recommandé)

claude mcp add distill -- npx distill-mcp serve

Option 2 : Via fichier de configuration

Éditez ~/.claude.json (global) ou .mcp.json (par projet) :

{
  "mcpServers": {
    "distill": {
      "command": "distill-mcp",
      "args": ["serve"]
    }
  }
}

Ou avec npx (sans installation globale) :

{
  "mcpServers": {
    "distill": {
      "command": "npx",
      "args": ["distill-mcp", "serve"]
    }
  }
}

Vérifier l'installation

Vérifiez que le serveur est bien configuré :

claude mcp list

Ou dans Claude Code, utilisez la commande /mcp pour voir les serveurs connectés.

Puis demandez à Claude de lire un fichier source avec smart_file_read pour vérifier que les outils Distill sont disponibles.

Utilisation des outils Distill

Lecture intelligente de fichiers

Au lieu de lire des fichiers entiers, utilisez smart_file_read :

Utilise smart_file_read pour obtenir la structure de src/server.ts

Compression des sorties de build

Quand vous avez des erreurs de build :

Utilise auto_optimize pour compresser cette sortie de build : [collez la sortie]

Configuration CLAUDE.md recommandée

Ajoutez ceci au CLAUDE.md de votre projet pour imposer l'utilisation de Distill :

## Utilisation des outils MCP

Lors de la lecture de fichiers source pour exploration, utilisez :
- `smart_file_read` au lieu de `Read` pour les fichiers .ts/.js/.py

Quand vous voyez une sortie de commande volumineuse (>500 caractères) :
- Utilisez `auto_optimize` pour la compresser

Installation des hooks de projet

Distill peut installer des hooks qui vous rappellent d'utiliser les outils d'optimisation :

distill-mcp setup --hooks

Cela ajoute des hooks à votre projet qui :

• Suggèrent smart_file_read lors de la lecture de fichiers de code
• Suggèrent auto_optimize pour les sorties bash volumineuses
• Rappellent les outils MCP à chaque prompt

Dépannage

Le serveur MCP ne démarre pas

1. Vérifiez la version Node.js : node --version (nécessite 20+)
2. Exécutez doctor : distill-mcp doctor
3. Vérifiez les logs dans le panneau de sortie de Claude Code

Les outils n'apparaissent pas

1. Vérifiez la configuration : claude mcp list
2. Vérifiez que la syntaxe JSON est valide dans ~/.claude.json
3. Essayez d'exécuter npx distill-mcp serve manuellement pour vérifier les erreurs
4. Utilisez /mcp dans Claude Code pour voir le statut des serveurs

Problèmes de permissions

Sur macOS/Linux, vous devrez peut-être rendre la commande exécutable :

chmod +x $(which distill-mcp)