Installer un MCP sous Linux
Un guide pensé pour les utilisateurs Linux. Évitez les pièges des dépôts obsolètes, installez le bon socle technique et lancez votre premier serveur.
À quoi sert ce guide ?
Bienvenue dans la pratique. Sur Linux, l'environnement est naturellement propice au développement, mais il y a un piège majeur : les versions des logiciels proposés par défaut sont souvent trop anciennes pour faire tourner les serveurs MCP modernes.
À la fin de cette page, vous aurez un moteur parfaitement à jour et vous aurez lancé avec succès votre premier serveur MCP local.
Les prérequis avant de démarrer
Assurez-vous d'avoir :
- Une distribution Linux (Ubuntu, Debian, Linux Mint, Pop!_OS, Fedora ou Arch).
- Une connexion Internet active.
- Claude Code installé sur votre système.
Ouvrir le Terminal
En tant qu'utilisateur Linux, vous connaissez certainement déjà cet outil. Le Terminal est le cœur de votre système.
Sur la plupart des distributions (notamment celles basées sur GNOME comme Ubuntu), le raccourci universel pour l'ouvrir est Ctrl + Alt + T.
Étape 1 : Le moteur Node.js
Rappelez-vous : les serveurs MCP sont majoritairement écrits en JavaScript. Votre distribution Linux a besoin d'un traducteur appelé Node.js pour les faire fonctionner.
1. Vérifier si vous l'avez déjà
Tapez cette commande et appuyez sur Entrée :
Si vous voyez une version supérieure ou égale à v18, vous pouvez passer directement à l'Étape 2.
Si la commande est introuvable, ou si le numéro de version est trop ancien (ex: v10.x ou v12.x), vous devez installer une version moderne.
2. Installer une version moderne de Node.js
Voici la méthode recommandée aujourd'hui selon votre distribution. Ne copiez pas les commandes au hasard, choisissez celle qui correspond à votre système.
Il ne faut pas utiliser le paquet nodejs par défaut, qui est souvent périmé. Nous utilisons le dépôt officiel "NodeSource" pour obtenir la version 20 (LTS) :
Les dépôts Fedora sont généralement très à jour. La commande native suffit :
Sur Arch, Node et npm sont séparés dans les dépôts. Installez les deux :
Étape 2 : Comprendre npm et npx
Node.js arrive (presque) toujours avec ses deux outils indispensables.
Le catalogue : npm
npm (Node Package Manager) est le dépôt mondial où sont publiés les serveurs MCP. Vérifions sa présence :
L'exécuteur : npx
npx est une commande magique. Au lieu d'utiliser apt ou npm pour télécharger un logiciel lourd, l'installer, le configurer puis le lancer, npx télécharge le serveur MCP temporairement et l'exécute directement. Il ne pollue pas votre système de fichiers racine.
Si node -v vous affiche une version récente (v18 ou +) et npm -v affiche un numéro, votre système Linux est parfaitement configuré pour le monde des MCP.
Étape 3 : Installer votre premier serveur MCP
Passons à l'action. Nous allons utiliser le serveur officiel "Filesystem" (qui permettra plus tard à l'IA de lire vos dossiers).
Tapez la commande suivante (remplacez votre_nom par votre véritable nom d'utilisateur Linux) :
Décortiquons chaque mot pour comprendre ce que vous faites :
npx: "Exécute ce programme à la volée."-y: "Accepte automatiquement de le télécharger si je ne l'ai pas encore."@modelcontextprotocol/server-filesystem: Le nom officiel du paquet sur le catalogue npm./home/votre_nom/Documents: Le périmètre de sécurité. Le serveur aura interdiction formelle de fouiller ailleurs que dans ce dossier.
Vérifier que tout fonctionne
Une fois validée, la commande mettra quelques secondes à télécharger le serveur. Puis... votre Terminal va sembler figé.
Pas de panique, c'est une excellente nouvelle ! Un serveur MCP n'a pas d'interface graphique et ne discute pas avec l'humain. Il écoute en silence. S'il ne renvoie aucune erreur rouge, c'est qu'il est allumé et prêt à servir.
Pour l'éteindre et retrouver la main sur votre Terminal, utilisez le raccourci classique de Linux : Ctrl + C.
Les erreurs les plus fréquentes
| Symptôme / Message d'erreur | Explication & Résolution |
|---|---|
| SyntaxError: Unexpected token '?=' | C'est l'erreur typique d'une version de Node.js trop ancienne. Vérifiez votre version avec node -v. Si elle est inférieure à 18, désinstallez-la et utilisez la méthode NodeSource de ce guide. |
| EACCES: permission denied | Vous essayez d'exécuter le serveur MCP dans un dossier où votre utilisateur n'a pas le droit d'écrire (ex: /var/www ou /root). Utilisez un dossier dans /home/votre_nom. |
| curl: command not found | L'outil de téléchargement curl n'est pas installé. Tapez sudo apt install curl pour l'ajouter avant de retenter l'installation de Node.js. |
À retenir
Sur Debian et Ubuntu, fuyez le paquet Node.js par défaut. Utilisez toujours NodeSource pour avoir une version moderne (v20+).
L'utilisation de la commande npx ne requiert jamais de droits sudo.
Si votre terminal semble bloqué après avoir lancé le serveur, c'est que l'installation a parfaitement fonctionné.
Foire aux questions (FAQ)
Votre distribution Linux est prête. La prochaine étape consiste à expliquer à Claude Code comment lancer ce serveur automatiquement en arrière-plan, sans que vous n'ayez besoin de taper cette commande npx vous-même.