Serveur MCP Filesystem : guide complet et exemples

Par Amir N., éditeur de serveurmcp.com · Mis à jour le 9 octobre 2026

Le serveur MCP Filesystem est le point de départ de la plupart des personnes qui découvrent le Model Context Protocol. Il donne à votre assistant IA un accès contrôlé à vos fichiers et dossiers locaux : lire, écrire, chercher, organiser. Ce guide explique à quoi il sert, comment l’installer en toute sécurité dans Claude Desktop et Claude Code, et comment l’utiliser au quotidien.

À quoi sert le serveur MCP Filesystem ?

Le serveur Filesystem permet à votre assistant d’agir directement sur les fichiers de votre ordinateur, dans les limites que vous fixez. C’est un serveur de référence, maintenu dans le dépôt officiel du protocole, et beaucoup d’usages en découlent.

Parmi les actions possibles :

• lire le contenu d’un ou de plusieurs fichiers ;
• créer un fichier ou modifier une partie de son contenu ;
• rechercher des fichiers dans un dossier et ses sous-dossiers ;
• lister un dossier ou afficher son arborescence ;
• déplacer ou renommer des fichiers, créer des dossiers.

Que vous soyez développeur, rédacteur ou simplement désireux de mettre de l’ordre dans vos documents, ce serveur ouvre beaucoup de possibilités.

Installation et configuration

Le serveur est publié sur npm sous le nom @modelcontextprotocol/server-filesystem. Il vous faut Node.js installé sur votre machine.

1. Choisir les dossiers autorisés

C’est l’étape la plus importante. Le serveur n’accède qu’aux dossiers que vous lui passez en argument, et à rien d’autre. Ne lui donnez jamais accès à votre disque entier : choisissez un dossier de projet précis ou un dossier de documents dédié.

2. Déclarer le serveur dans Claude Desktop

Ouvrez le fichier claude_desktop_config.json (menu Réglages, Développeur, Modifier la configuration) et ajoutez le serveur avec le ou les chemins autorisés :

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

Sous Windows, écrivez les chemins avec des doubles barres obliques inverses, par exemple C:\\Users\\vous\\Documents\\projet. Vous pouvez lister plusieurs dossiers à la suite dans args.

3. Ou l’ajouter à Claude Code

Dans Claude Code, une seule commande suffit :

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/Documents/projet

4. Redémarrer et tester

Redémarrez Claude Desktop. Le serveur apparaît dans la liste des outils. Testez avec une demande simple : « liste les fichiers de mon dossier de projet ». En cas d’erreur, passez votre configuration dans notre validateur de configuration MCP.

Exemples concrets

Vous avez un dossier rempli de notes en vrac ? Demandez à votre assistant : « parcours mes notes et regroupe-les par thème dans un résumé ». Il lit chaque fichier via le serveur, en extrait l’essentiel et produit une synthèse organisée.

Côté développement, demandez-lui de trouver tous les fichiers qui utilisent une fonction donnée et d’expliquer comment elle est appelée. Le serveur cherche dans le dossier, l’assistant répond en contexte. Pour aller plus loin sur l’ajout de serveurs, voyez notre guide ajouter un serveur MCP à Claude.

Bonnes pratiques de sécurité

Ce serveur touche à vos fichiers : la prudence s’impose. Limitez toujours l’accès aux seuls dossiers nécessaires, n’incluez jamais de dossiers système, de clés SSH ou de fichiers .env, et relisez ce que l’assistant propose avant de valider une écriture importante. Si votre client le permet, laissez activée la confirmation avant chaque modification. Notre checklist de sécurité MCP résume ces réflexes.

En résumé

Le serveur MCP Filesystem est la porte d’entrée idéale dans l’univers MCP : simple à installer et immédiatement utile. Bien configuré, avec un périmètre de dossiers réduit, c’est un outil aussi puissant que sûr. Parcourez ensuite notre annuaire des serveurs MCP pour aller plus loin.