Aller au contenu
Floskool

Chapitre 2 · Ajouter et connecter

Ajouter ton premier serveur distant

Leçon gratuite 8 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Pourquoi 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 exemple notes ou notion).
  • <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, lance claude dans 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 list aprè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.