Configurer un MCP dans Claude Code

Pourquoi un fichier de configuration ?

Rappelez-vous de l'analogie de l'entreprise : Claude Code est l'Assistant de Direction. Mais pour qu'il puisse contacter l'Expert-Comptable (le serveur MCP), il lui faut un annuaire téléphonique.

Cet annuaire, c'est le fichier de configuration. Il indique à Claude Code :

• Quels sont les serveurs disponibles.
• Comment les démarrer automatiquement (la commande exacte).
• Quels droits et dossiers spécifiques leur accorder.

Où Claude Code stocke-t-il cette configuration ?

Claude Code est très respectueux de vos projets. Au lieu de modifier les paramètres généraux de votre ordinateur, il crée un petit fichier invisible à la racine de votre dossier de travail actuel.

Ce fichier s'appelle .claude.json.

Si vous êtes dans le dossier C:\Users\Vous\Documents\MonProjet et que vous lancez Claude Code, il lira ou créera le fichier C:\Users\Vous\Documents\MonProjet\.claude.json.

Ajouter le serveur (La méthode sûre)

Nous allons configurer le serveur "Filesystem" (qui permet à Claude Code de lire vos fichiers).

Ouvrez le fichier .claude.json avec votre éditeur de texte préféré (comme VS Code ou même le Bloc-notes de Windows).

Si le fichier est vide, ou si vous le créez vous-même, copiez exactement ce bloc de texte. Attention, le format doit être respecté à la virgule près !

{
  "mcpServers": {
    "mon-premier-serveur": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\Vous\\Documents"
      ]
    }
  }
}

Décryptage ligne par ligne

Voici l'explication précise de ce que vous venez de coller. Il ne faut jamais copier du code sans le comprendre :

• "mcpServers": C'est le grand tiroir. Tout ce qui se trouve entre les accolades de cette section représente vos serveurs connectés.
• "mon-premier-serveur": C'est le nom choisi par vous. Vous pouvez l'appeler "fichiers-locaux" ou "lecture-disque", cela sert uniquement à le reconnaître dans Claude Code.
• "command": "npx" L'outil que Claude Code doit utiliser. Rappelez-vous le chapitre précédent : npx est le téléchargeur/exécuteur de Node.js.
• "args": [...] Les arguments, c'est-à-dire la suite de la commande, mais découpée mot par mot. Au lieu d'écrire une longue ligne, le JSON oblige à mettre chaque mot entre guillemets, séparé par une virgule.
  • "-y" empêche Node.js de demander l'autorisation de téléchargement (indispensable pour que ça fonctionne en arrière-plan).
  • "@modelcontextprotocol/server-filesystem" est le nom officiel du serveur sur le magasin.
  • "C:\\Users\\Vous\\Documents" est la permission stricte accordée au serveur. Il ne pourra lire que ce dossier et rien d'autre.

Enregistrez votre fichier (Ctrl+S).

Vérifier que tout fonctionne (La Victoire)

C'est le moment de vérité. Nous allons vérifier que Claude Code a bien lu votre annuaire téléphonique et connecté le serveur.

1. Ouvrez votre terminal et lancez Claude Code en tapant : claude
2. Une fois l'interface de discussion chargée, tapez cette commande interne magique : /mcp

Si la configuration est réussie, Claude Code affichera un petit tableau listant vos serveurs. Vous y verrez apparaître : mon-premier-serveur.

Les erreurs les plus fréquentes

L'informatique n'est pas toujours tendre avec les virgules. Si ça ne marche pas du premier coup, voici où chercher :

À retenir

Foire aux questions (FAQ)