Comment configurer Claude Desktop avec MCP pour accéder à vos fichiers : Guide complet

Un tutoriel pas-à-pas pour connecter Claude Desktop à votre système de fichiers via le Model Context Protocol


Vous utilisez Claude Desktop et vous aimeriez que Claude puisse accéder directement à vos fichiers locaux ? C’est exactement ce que permet le Model Context Protocol (MCP) ! Dans cet article, je vais vous expliquer comment j’ai configuré Claude Desktop pour qu’il puisse lire, analyser et interagir avec mes fichiers de projets.

Qu’est-ce que MCP ?

Le Model Context Protocol est un standard ouvert qui permet aux IA comme Claude de se connecter à des outils et sources de données externes. Concrètement, cela signifie que Claude peut :

  • Lire vos fichiers de code
  • Analyser la structure de vos projets
  • Accéder à vos bases de données
  • Et bien plus encore !

Prérequis

Avant de commencer, vous aurez besoin de :

  • Claude Desktop installé (version récente avec support MCP)
  • Node.js installé sur votre machine
  • Un compte Claude Pro (recommandé)
  • Quelques minutes de patience 😊

Vérifier Node.js

Ouvrez votre invite de commande et tapez :

node --version

Si vous obtenez une erreur, téléchargez Node.js depuis nodejs.org.

Étape 1 : Vérifier la version de Claude Desktop

Important : Le support MCP n’est disponible que dans les versions récentes de Claude Desktop.

  1. Ouvrez Claude Desktop
  2. Menu → À propos (ou About)
  3. Vérifiez le numéro de version

Si vous avez une version ancienne (comme 0.9.3), mettez à jour via claude.ai/download.

Étape 2 : Accéder à la configuration MCP

  1. Ouvrez Claude Desktop
  2. MenuSettings (Paramètres)
  3. Cliquez sur « Developer » dans la barre de gauche
  4. Cliquez sur « Edit Config »

Cela ouvrira le fichier de configuration MCP dans votre éditeur de texte.

Étape 3 : Configuration du serveur filesystem

Remplacez tout le contenu du fichier par cette configuration :

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:/Users/VotreNom/Documents",
        "C:/Users/VotreNom/Desktop"
      ]
    }
  }
}

⚠️ Points importants

1. Chemins Windows : Utilisez des slashes normaux / ou doublez les backslashes \\

// ✅ Correct
"C:/Users/Jean/Documents"
// ✅ Correct aussi  
"C:\\Users\\Jean\\Documents"
// ❌ Incorrect
"C:\Users\Jean\Documents"

2. Remplacez les chemins : Adaptez les chemins à votre configuration :

  • C:/Users/VotreNom/Documents → votre dossier Documents
  • C:/Users/VotreNom/Desktop → votre Bureau
  • Ajoutez vos dossiers de projets

3. Plusieurs dossiers : Vous pouvez donner accès à plusieurs dossiers :

"args": [
  "-y",
  "@modelcontextprotocol/server-filesystem",
  "C:/Users/Jean/Documents/Projets",
  "C:/Users/Jean/Desktop",
  "C:/dev/mes-sites"
]

Étape 4 : Redémarrer et tester

  1. Sauvegardez le fichier de configuration
  2. Fermez complètement Claude Desktop
  3. Relancez Claude Desktop
  4. Nouvelle conversation

Étape 5 : Vérifier que ça fonctionne

Cherchez l’icône MCP :

  • Regardez en bas à droite de la zone de saisie
  • Vous devriez voir une icône « slider » ou curseur
  • Ce n’est PAS un marteau comme on pourrait s’y attendre !

Test simple : Tapez ce message dans Claude :

Peux-tu lister les fichiers présents dans mon dossier Documents ?

Si Claude vous répond avec une liste de fichiers, félicitations ! 🎉 MCP fonctionne parfaitement.

Exemple d’utilisation pratique

Une fois configuré, voici ce que vous pouvez faire avec Claude :

# Analyser un projet
"Analyse la structure de mon projet React dans le dossier /Projets/mon-app"

# Lire du code
"Lis le fichier package.json et explique-moi les dépendances"

# Comparer des fichiers
"Compare ces deux fichiers JavaScript et dis-moi les différences"

# Créer des fichiers
"Crée un fichier README.md pour mon projet avec une description appropriée"

Dépannage des problèmes courants

Pas d’icône slider visible

Solutions :

  • Vérifiez que Node.js est installé : node --version
  • Redémarrez complètement Claude Desktop
  • Vérifiez la syntaxe JSON (pas de virgules en trop)

Erreur de syntaxe JSON à la position X

Causes courantes :

  • Backslashes simples dans les chemins Windows
  • Virgule en trop à la fin d’une ligne
  • Guillemets mal fermés

Claude dit « je n’ai pas accès aux fichiers »

Vérifications :

  • Les chemins dans la config existent-ils vraiment ?
  • Avez-vous redémarré Claude Desktop après la modification ?
  • L’icône slider est-elle visible ?

Aller plus loin

Ajouter d’autres serveurs MCP

Une fois le filesystem configuré, vous pouvez ajouter d’autres serveurs populaires :

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:/Users/Jean/Projets"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "votre-cle-brave"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/dbname"]
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Serveurs MCP utiles :

  • Brave Search : Recherche web directement depuis Claude
  • PostgreSQL/SQLite : Accès aux bases de données
  • Memory : Claude peut « mémoriser » des informations entre sessions
  • Weather : Données météo en temps réel
  • Google Drive : Accès à vos documents Google

Sécurité

Important : MCP donne à Claude l’accès à vos fichiers locaux. Quelques bonnes pratiques :

  • Ne donnez accès qu’aux dossiers nécessaires
  • Évitez de donner accès à tout votre disque dur
  • Soyez prudent avec les dossiers système

Conclusion

Le Model Context Protocol transforme Claude Desktop en un véritable assistant de développement. Une fois configuré, Claude peut :

  • Comprendre vos projets dans leur globalité
  • Analyser votre code avec le contexte complet
  • Vous aider à déboguer en ayant accès aux fichiers
  • Générer de la documentation basée sur votre code réel

Cette configuration m’a personnellement fait gagner énormément de temps dans mes projets de développement. Claude peut maintenant comprendre la structure de mes applications, m’aider à refactoriser le code, et même détecter des incohérences entre différents fichiers.

Avez-vous réussi à configurer MCP avec Claude Desktop ? Partagez votre expérience en commentaire !


Cet article est basé sur une configuration testée sur Windows 10 avec Claude Desktop version récente. Les étapes peuvent légèrement varier selon votre système d’exploitation.

https://modelcontextprotocol.io/quickstart/user

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *