Tu as installé Claude Code, il lit ton projet, il écrit du code. Mais quand tu lui demandes l'état de ton dernier déploiement ou le contenu d'un ticket, il ne peut pas répondre : il ne voit que les fichiers de ton dossier. Le MCP (Model Context Protocol) règle exactement ce problème. C'est un standard ouvert publié par Anthropic fin 2024, une sorte de prise universelle qui permet à un assistant IA de parler à tes outils : GitHub, Sentry, Notion, une base de données, un navigateur, ton système de fichiers. Tu branches un serveur MCP une fois, et Claude Code sait s'en servir dans toutes tes sessions suivantes.
Ce tutoriel te donne trois chemins pour y arriver : un parcours guidé si tu pars vraiment de zéro, la commande native de Claude Code (deux minutes, incluse dans l'outil), et le fichier de configuration partagé quand tu travailles en équipe. Aucun prérequis technique lourd, chaque terme est expliqué au passage.
Le MCP, c'est quoi exactement ?
Le MCP est un standard ouvert qui permet à Claude Code d'utiliser des outils extérieurs (API, bases de données, applications) grâce à de petits programmes appelés serveurs MCP.
L'analogie la plus simple : avant l'USB, chaque appareil avait son propre câble. Avec le MCP, chaque outil expose ses capacités dans un format unique, et n'importe quel assistant compatible peut s'y brancher. Anthropic a publié le protocole en open source en novembre 2024 ; il a depuis été adopté par d'autres éditeurs, ce qui veut dire qu'un serveur MCP écrit aujourd'hui fonctionne au-delà de Claude Code.
Quatre mots de vocabulaire suffisent pour comprendre la suite :
- Serveur MCP : le petit programme qui expose un outil. Exemple : le serveur Sentry sait lire tes erreurs de production.
- Client MCP : le logiciel qui consomme ces serveurs. Ici, c'est Claude Code.
- Outils (tools) : les actions que le serveur autorise (créer un ticket, lancer une requête SQL, ouvrir une page web).
- Ressources (resources) : les données que le serveur met à disposition en lecture, que tu peux appeler dans un message avec la syntaxe arobase, par exemple @sentry:issue.
À cela s'ajoute la notion de transport, c'est-à-dire la façon dont Claude Code parle au serveur. Trois options existent : stdio (le serveur tourne sur ta machine), SSE et HTTP (le serveur est hébergé à distance par l'éditeur de l'outil). Tu n'as pas à choisir au hasard : chaque service indique dans sa documentation le transport et l'adresse à utiliser.
Concrètement, une fois un serveur branché, tu peux écrire à Claude Code : « regarde les trois dernières erreurs Sentry sur l'app, trouve la cause dans le code et propose un correctif ». Il va chercher l'information lui-même au lieu d'attendre que tu fasses des copier-coller.
Méthode 1 : apprendre le MCP dans un environnement déjà prêt avec Skilzy
Si tu n'as jamais ouvert un terminal, le plus rapide est de pratiquer dans un cadre guidé, avec les outils déjà installés, plutôt que de configurer ton poste à l'aveugle.
C'est la logique de Skilzy, une plateforme e-learning française qui couvre plus de 15 programmes pour apprendre et utiliser l'IA : créer des images, des vidéos (UGC, publicités, chaînes faceless, avatars, voix off), de la musique, automatiser avec n8n, écrire de bons prompts, coder avec l'IA. Le programme Claude Code et le terminal est celui qui t'intéresse ici : il part de l'installation, passe par les commandes de base, le fichier d'instructions du projet, les hooks, puis la connexion de serveurs MCP.
L'intérêt principal pour un débutant, c'est le Lab IA intégré : tu utilises les vrais outils directement dans la plateforme, avec les crédits inclus, sans empiler cinq abonnements à 20 euros par mois pour tester. Tu apprends la logique du protocole et tu reproduis les manipulations pendant que quelqu'un t'explique ce que chaque ligne fait.
À savoir aussi :
- Deux certifications reconnues par l'État et finançables sont disponibles : RS7439 (marketing de contenus par l'IA) et RS6792 (IA et vente). Tu peux vérifier leur existence sur le répertoire public de France Compétences.
- Une offre B2B existe pour les organismes de formation qui veulent intégrer ces parcours.
Sois lucide sur une chose : une formation ne configure pas ta machine à ta place. À un moment, tu taperas les commandes toi-même. Les deux méthodes suivantes les détaillent entièrement, et elles sont gratuites.
Méthode 2 : la commande claude mcp add (la fonction native de Claude Code)
C'est la façon officielle et la plus rapide : une seule commande dans ton terminal suffit pour brancher un serveur, sans logiciel supplémentaire.
Deux prérequis. D'abord, Claude Code doit être installé sur ton poste ; si ce n'est pas encore fait, suis le guide pour installer Claude Code sur macOS ou son équivalent Windows. Ensuite, beaucoup de serveurs locaux sont distribués en paquets Node.js, donc Node.js version 18 ou supérieure doit être présent (tape node --version pour vérifier).
Brancher un serveur local (stdio)
Le serveur tourne sur ta machine. Le double tiret sépare les options de Claude Code de la commande à exécuter :
claude mcp add fichiers -- npx -y @modelcontextprotocol/server-filesystem ~/projets
Brancher un serveur distant (HTTP ou SSE)
Là, tu ne fournis pas une commande mais une adresse, donnée par l'éditeur du service :
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
claude mcp add --transport sse linear https://mcp.linear.app/sse
La plupart de ces serveurs distants demandent une authentification. Lance Claude Code, tape la commande /mcp dans la session, choisis le serveur et suis la procédure de connexion dans ton navigateur. Le jeton est stocké par Claude Code, tu ne le recopies nulle part.
Choisir la portée (scope)
C'est le point que les débutants ratent le plus souvent. Un serveur n'est pas forcément disponible partout.
| Portée | Commande | Disponible où | Pour quoi |
|---|---|---|---|
| local (par défaut) | claude mcp add ... | Uniquement dans le projet courant, pour toi | Tests, serveurs expérimentaux |
| project | claude mcp add --scope project ... | Pour toute personne qui clone le dépôt | Outils communs à l'équipe |
| user | claude mcp add --scope user ... | Dans tous tes projets, pour toi seul | Tes outils personnels du quotidien |
Exemple d'un serveur que tu veux partout :
claude mcp add --scope user notion --transport http https://mcp.notion.com/mcp
Gérer ce que tu as branché
claude mcp list
claude mcp get sentry
claude mcp remove sentry
La première commande affiche l'état de connexion de chaque serveur, la deuxième donne le détail d'un serveur, la troisième le supprime. Ces trois commandes rejoignent naturellement les commandes Claude Code à connaître absolument dans ton usage quotidien.
Méthode 3 : le fichier .mcp.json pour toute l'équipe
Quand plusieurs personnes travaillent sur le même dépôt, tu déclares les serveurs dans un fichier .mcp.json versionné avec le code, et chacun les récupère automatiquement.
Ce fichier se place à la racine du projet. C'est exactement ce que la commande avec la portée project génère, mais l'écrire à la main te donne plus de contrôle :
{
"mcpServers": {
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/ma_base"],
"env": {}
},
"sentry": {
"type": "http",
"url": "https://mcp.sentry.dev/mcp"
}
}
}
Règle de sécurité non négociable : aucune clé d'API, aucun mot de passe en clair dans ce fichier, puisqu'il part dans Git. Claude Code sait lire les variables d'environnement de ta machine avec la syntaxe à accolades :
"env": { "API_KEY": "${MON_API_KEY}" }
Chaque développeur définit alors MON_API_KEY de son côté, et le dépôt reste propre. Pense aussi à vérifier que ton .gitignore couvre bien tes fichiers d'environnement.
Quand quelqu'un ouvre le projet pour la première fois, Claude Code demande une validation avant d'activer les serveurs déclarés : c'est une protection contre un dépôt malveillant. Si tu t'es trompé en répondant, la commande claude mcp reset-project-choices remet ces approbations à zéro.
Ce fichier fonctionne bien en binôme avec ton fichier d'instructions projet et tes automatisations : si tu veux aller plus loin, le tutoriel sur les hooks de Claude Code montre comment déclencher des actions automatiques autour de ces outils.
Vérifier que ça marche, déboguer et rester en sécurité
Tape /mcp dans une session Claude Code : tu vois immédiatement quels serveurs sont connectés, lesquels échouent et lesquels attendent une authentification.
Les pannes les plus fréquentes et leur cause réelle :
- Le serveur reste en « failed » : la commande de lancement est introuvable. Vérifie que Node.js est installé et que le nom du paquet est exact. Relance Claude Code avec l'option --debug pour lire le message d'erreur complet.
- Le serveur met trop de temps à démarrer : augmente le délai d'attente au lancement, par exemple avec MCP_TIMEOUT=15000 devant la commande claude (la valeur est en millisecondes).
- Le serveur est connecté mais Claude ne l'utilise pas : demande explicitement l'outil dans ton message (« utilise le serveur sentry pour... »). Tu peux aussi le préciser dans ton fichier CLAUDE.md pour que ce soit un réflexe.
- Sur Windows, une commande npx échoue : il faut parfois l'envelopper dans cmd /c. La documentation officielle du MCP dans Claude Code détaille ce cas.
Côté sécurité, trois réflexes à adopter dès ton premier serveur. Un : un serveur MCP est du code tiers qui s'exécute sur ta machine avec tes droits, donc installe uniquement des serveurs dont tu connais l'éditeur. Deux : applique le principe du moindre privilège, par exemple en connectant ta base de données avec un utilisateur en lecture seule plutôt qu'avec le compte administrateur. Trois : méfie-toi de l'injection de prompt, c'est-à-dire d'un contenu récupéré par un serveur (un ticket, une page web, un commentaire) qui contient des instructions cachées destinées à l'IA. Relis toujours les actions sensibles que Claude Code te propose avant de les valider, surtout quand elles touchent à des données externes.
Ce que tu peux faire dans l'heure qui vient
Commence petit : branche un seul serveur, idéalement celui de l'outil que tu ouvres dix fois par jour. Vérifie avec /mcp qu'il répond, pose deux ou trois questions à Claude Code pour voir ce qu'il en tire, puis ajoute le suivant. Une fois que trois serveurs tournent, passe à la portée project et partage la configuration avec ton équipe. Si les commandes du terminal te freinent encore, un parcours guidé te fera gagner des semaines de tâtonnements ; sinon, la documentation officielle et ce tutoriel suffisent largement pour démarrer.
