Installer un MCP sous macOS
Un guide pas-à-pas conçu pour les utilisateurs Mac. Apprivoisez le Terminal, installez les prérequis et lancez votre premier serveur.
À quoi sert ce guide ?
Bienvenue dans la pratique. Si vous utilisez un Mac et que vous n'avez pas l'habitude de manipuler le Terminal ou d'installer des outils pour développeurs, ce guide est fait pour vous.
Nous allons avancer doucement. À la fin de cette page, votre Mac possédera le moteur nécessaire pour exécuter la quasi-totalité des serveurs MCP du marché, et vous aurez testé votre premier serveur local avec succès.
Les prérequis avant de démarrer
Vérifions que vous avez le nécessaire :
- Un Mac (à processeur Intel ou Apple Silicon M1/M2/M3).
- Une connexion Internet active.
- Claude Code installé sur votre machine.
Ouvrir le Terminal
Oubliez la souris quelques instants. Sur macOS, toutes les interactions avancées se font via le Terminal. C'est simplement une fenêtre qui vous permet de discuter directement avec le cœur de votre Mac par écrit.
Pour l'ouvrir, rien de plus simple :
- Appuyez simultanément sur
Cmd (⌘)+Espacepour ouvrir la recherche Spotlight. - Tapez le mot
Terminal. - Appuyez sur Entrée.
Une petite fenêtre avec du texte s'ouvre. N'ayez pas peur, c'est ici que la magie opère.
Étape 1 : Le moteur Node.js
Comme expliqué précédemment, les serveurs MCP sont très souvent écrits en JavaScript. macOS ne comprend pas le JavaScript de base. Il a besoin d'un traducteur : Node.js.
1. Vérifier si vous l'avez déjà
Dans votre Terminal, tapez cette commande et appuyez sur Entrée :
Si un numéro s'affiche (comme v20.x.x), passez directement à l'Étape 2.
Si le Mac répond command not found: node, vous devez l'installer.
2. Installer Node.js
Il existe deux grandes méthodes sur Mac. La méthode "Développeur" (qui utilise un outil appelé Homebrew) et la méthode "Classique". Nous vous recommandons fortement la méthode classique si vous débutez.
- Allez sur nodejs.org.
- Cliquez sur le gros bouton vert indiquant la version LTS (Long Term Support). Le Mac téléchargera un fichier
.pkg. - Double-cliquez sur ce fichier téléchargé.
- Suivez l'assistant d'installation (cliquez sur "Continuer", acceptez les conditions, et entrez le mot de passe de votre Mac quand il vous le demande).
Étape cruciale : Une fois l'installation finie, vous devez quitter le Terminal (Cmd + Q) et le rouvrir. Sans ce redémarrage, le Terminal ignorera l'existence de Node.js.
Si vous êtes familier avec le Terminal, vous avez peut-être déjà installé le gestionnaire de paquets Homebrew. Dans ce cas, une simple commande suffit : brew install node. Mais si vous ne savez pas ce qu'est Homebrew, restez sur la méthode du fichier .pkg décrite au-dessus !
Étape 2 : Comprendre npm et npx
L'installation de Node.js a secrètement installé deux outils fantastiques sur votre Mac.
Le catalogue : npm
npm (Node Package Manager) est une sorte d'App Store géant pour les développeurs. C'est là que sont rangés tous les serveurs MCP. Pour vérifier qu'il est bien là, tapez :
L'exécuteur : npx
npx est l'outil que vous allez utiliser en permanence. D'ordinaire, il faut télécharger un logiciel, l'installer, puis l'ouvrir. Avec npx, vous faites tout en une seconde : l'outil va chercher le serveur MCP dans le catalogue, le télécharge temporairement en mémoire, et l'exécute, sans jamais polluer votre disque dur avec des dossiers inutiles.
Si les commandes node -v et npm -v vous renvoient toutes les deux un numéro, votre Mac est parfaitement prêt. Vous pouvez passer à la suite.
Étape 3 : Installer votre premier serveur MCP
Plutôt que de faire de la théorie, lançons notre premier serveur local. Nous allons utiliser le serveur officiel "Filesystem" (qui permet de lire les dossiers du Mac).
Tapez exactement cette commande dans votre Terminal (remplacez VotreNom par le nom de votre session Mac) :
Avant d'appuyer sur Entrée, comprenez ce que vous demandez à votre Mac :
npx: "Va chercher sur internet et exécute immédiatement."-y: "Accepte automatiquement le téléchargement pour que ça se fasse en arrière-plan sans me poser de question."@modelcontextprotocol/server-filesystem: Le nom officiel du serveur./Users/VotreNom/Documents: Vous définissez une limite stricte. Le serveur ne pourra lire que le dossier Documents. Sur Mac, les chemins utilisent toujours des barres obliques simples (/).
Vérifier que tout fonctionne
Appuyez sur Entrée. Après quelques secondes de téléchargement, il ne se passera rien. Votre curseur va simplement clignoter dans le vide.
C'est une victoire totale ! Contrairement à un logiciel classique, un serveur n'affiche rien. Il s'allume de manière invisible et écoute. S'il clignote sans faire d'erreur, c'est qu'il est prêt à recevoir des ordres de Claude Code.
Pour éteindre le serveur et libérer votre Terminal, appuyez sur les touches Ctrl + C.
Les erreurs les plus fréquentes
| Symptôme / Message d'erreur | Explication & Résolution |
|---|---|
| command not found: node | Node.js n'est pas installé, ou le Terminal n'a pas été redémarré. Fermez complètement le Terminal (Cmd + Q) et rouvrez-le. |
| brew: command not found (Homebrew absent) | Vous essayez d'utiliser une commande Homebrew sans l'avoir installé. Si vous êtes débutant, utilisez l'installateur classique via le site nodejs.org comme expliqué plus haut. |
| EACCES: permission denied | Vous essayez d'exécuter le MCP dans un dossier système protégé de macOS. Utilisez un dossier qui vous appartient, comme /Users/VotreNom/Documents. |
À retenir
Tout se passe dans l'application Terminal du Mac.
Le Mac a besoin de l'outil Node.js pour faire fonctionner les serveurs. Vous devez l'installer une seule fois dans votre vie.
N'oubliez pas de quitter complètement le Terminal (Cmd + Q) après l'installation de Node.
La commande magique npx télécharge et lance le serveur en une seule ligne.
Foire aux questions (FAQ)
Vous avez préparé votre Mac avec brio. La prochaine étape consiste à apprendre à Claude Code comment lancer ce serveur de manière automatique sans que vous n'ayez à ouvrir le Terminal !