Chapter 2 · Ajouter et connecter
Ajouter ton premier serveur distant
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freePourquoi commencer par un serveur distant
Un serveur distant n'installe rien sur ton ordinateur : tu donnes une adresse, tu te connectes à ton compte, c'est tout. C'est le chemin le plus court pour voir ce que les MCP changent.
Exemple : Léa, fleuriste, garde ses commandes spéciales dans un outil de notes en ligne. Elle veut juste que Claude puisse lire ces pages pour préparer ses listes d'achats. Un serveur distant officiel, une commande, c'est réglé.
Où taper la commande
La commande se lance dans ton terminal, pas dans une conversation Claude Code. Si Claude Code est ouvert, quitte-le ou ouvre une deuxième fenêtre de terminal.
La syntaxe
claude mcp add --transport http <nom> <adresse>
--transport http: le type de connexion (forme courte :-t).<nom>: le nom que tu choisis, court et sans espace (par exemplenotesounotion).<adresse>: l'adresse du serveur, donnée par l'éditeur de l'outil dans sa documentation officielle.
Pour la portée, ajoute --scope user ou --scope project si besoin (leçon 3).
Un exemple de la documentation : Notion
La documentation de Claude Code cite cette commande pour Notion :
claude mcp add --transport http notion https://mcp.notion.com/mcp
Avant de la taper, vérifie l'adresse dans la documentation de Notion : c'est le bon réflexe pour tout service, même quand l'exemple vient d'une source fiable.
Quand le service demande un en-tête
Certains serveurs demandent une clé envoyée dans un en-tête (une information technique jointe à chaque demande). La documentation prévoit l'option --header (forme courte : -H). Exemple factice, avec une valeur masquée :
claude mcp add --transport http secure-api https://api.example.com/mcp --header "Authorization: Bearer ****"
Ici, **** remplace la vraie clé. Ne tape jamais ta vraie clé devant quelqu'un, ni dans une capture d'écran, ni dans une conversation. Quand le service propose une connexion par le navigateur (leçon 5), préfère-la : tu n'as alors aucune clé à manipuler.
Vérifier que tout va bien
claude mcp list
Chaque serveur affiche son état. Les principaux, d'après la documentation :
✔ Connected: prêt.! Needs authentication: il faut te connecter (leçon suivante).✘ Failed to connect: vérifie l'adresse, ta connexion, ou passe au dépannage (leçon 10).⏸ Pending approval: un serveur de portée project attend ton approbation, lanceclaudedans le projet pour l'approuver.⊘ Disabled for this project: tu l'as désactivé, il se réactive depuis/mcp.
Pour voir le détail d'un seul serveur :
claude mcp get notion
Retirer un serveur
claude mcp remove notion
Retirer le serveur de Claude Code ne supprime pas l'autorisation que tu as donnée côté service. Pense aussi à la révoquer dans les réglages de l'outil (on y revient au chapitre 4).
Le prompt pour préparer l'ajout sans risque
Copie ce prompt dans Claude Code. Il ne lance rien et te prépare la commande exacte :
Contexte : je veux connecter Claude Code à [nom de l'outil] pour [ce que tu veux faire avec].
Objectif : savoir si un serveur MCP officiel existe et comment l'ajouter proprement.
Contraintes : ne lance aucune commande. Sources officielles uniquement ; si tu n'es pas sûr qu'un serveur officiel existe, dis-le.
Format attendu : la commande claude mcp add à taper (avec la portée conseillée), ce que le serveur pourra lire et modifier, les droits minimum à lui donner, et comment le désactiver.
Validation : termine par les 3 risques à surveiller avec ce serveur et attends ma décision.
Pourquoi il marche : il exige une source officielle, il ne lance rien, et il te met face aux risques avant que tu tapes quoi que ce soit.
Les erreurs à éviter
- Lancer la commande dans la conversation Claude Code. Elle se tape dans le terminal.
- Copier une adresse depuis un forum ou une vidéo. Seulement la documentation officielle de l'éditeur.
- Mettre des espaces dans le nom. Un nom court, en minuscules, sans espace.
- Oublier de vérifier. Un
claude mcp listaprès chaque ajout t'évite de chercher plus tard.
À toi de jouer
Choisis l'outil prioritaire de ta liste. Trouve l'adresse de son serveur dans sa documentation officielle. Prépare ta commande sur une note, en remplaçant <nom> et <adresse>. Lance-la dans ton terminal, puis claude mcp list. Note l'état affiché : si c'est ! Needs authentication, parfait, c'est la leçon suivante.