Chapitre 2 · Ajouter et connecter
Te connecter avec /mcp et gérer tes serveurs
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementPourquoi une connexion à part
Ajouter un serveur, c'est poser la prise. Mais beaucoup de services veulent savoir qui se branche : il faut te connecter à ton compte. La plupart des serveurs distants utilisent OAuth (une méthode de connexion où tu autorises l'accès dans ton navigateur, sans jamais donner ton mot de passe à Claude Code).
Exemple : Thomas, photographe, vient d'ajouter le serveur de son outil de suivi d'erreurs pour son site de réservation. claude mcp list affiche ! Needs authentication. Deux minutes plus tard, il est connecté, et Claude peut lui expliquer pourquoi le formulaire de réservation a planté hier soir.
Les étapes
- Ouvre ton terminal dans le dossier de ton projet et lance Claude Code :
claude. - Dans la conversation, tape
/mcp. La liste de tes serveurs s'affiche avec leur état. - Choisis le serveur qui demande une connexion, puis l'option d'authentification.
- Ton navigateur s'ouvre : connecte-toi au service et autorise l'accès.
- Reviens dans Claude Code : le serveur est connecté.
La documentation précise trois points utiles :
- Les jetons de connexion (les autorisations obtenues) sont stockés de façon sécurisée et renouvelés automatiquement.
- Si ton navigateur ne s'ouvre pas tout seul, copie l'adresse affichée et ouvre-la à la main.
- L'option « Clear authentication » dans le menu
/mcpefface la connexion.
Se connecter depuis le terminal
La documentation donne aussi des commandes pour le faire sans ouvrir de conversation :
claude mcp login <nom>
claude mcp logout <nom>
La première lance la connexion, la seconde efface les identifiants enregistrés pour ce serveur.
Tout ce que /mcp permet de faire
D'après la documentation, le panneau /mcp sert à :
- voir l'état de chaque serveur ;
- te connecter, ou te reconnecter (option Re-authenticate) quand une autorisation a expiré ;
- relancer la connexion d'un serveur (option Reconnect) ;
- désactiver un serveur sans perdre sa configuration, puis le réactiver plus tard ;
- effacer la connexion (Clear authentication).
La désactivation est très pratique : un serveur dont tu n'as pas besoin aujourd'hui reste configuré, mais Claude Code ne s'y connecte pas.
Bien choisir ce que tu autorises
Au moment de l'autorisation dans le navigateur, lis l'écran du service. Certains outils permettent de limiter l'accès à quelques pages, projets ou espaces, ou de choisir entre lecture seule et lecture-écriture. Choisis toujours le minimum qui suffit à ton usage. Tu pourras élargir plus tard si besoin, alors que réparer un accès trop large après un incident est bien plus pénible.
Certains serveurs n'utilisent pas OAuth mais un jeton personnel (une sorte de mot de passe technique, comme une clé API) que tu crées dans ton compte. La documentation montre par exemple GitHub avec un en-tête Authorization. Dans ce cas :
- crée le jeton avec le minimum de droits et, si le service le permet, une date d'expiration ;
- ne le colle jamais dans une conversation, un fichier partagé, un message ou une capture d'écran ;
- garde la marche à suivre pour le révoquer (dans les réglages du service).
Copie ce prompt pour faire le point après chaque nouvelle connexion :
Je viens de connecter le serveur MCP [nom] à mon compte [service].
Sans rien modifier et sans lancer d'action dans le service :
1. liste les outils que ce serveur met à ta disposition,
2. classe-les en trois groupes : lecture, modification, envoi ou suppression,
3. dis-moi lesquels je devrais garder sous accord systématique.
Explique en mots simples, puis attends ma décision.
Les erreurs à éviter
- Cliquer « Autoriser » sans lire. L'écran du service te dit ce que tu donnes.
- Garder des connexions inutiles. Désactive dans
/mcpce qui ne sert pas, efface la connexion des serveurs abandonnés. - Croire que retirer le serveur suffit. L'autorisation existe aussi côté service : révoque-la là-bas.
À toi de jouer
Connecte le serveur ajouté à la leçon 4 avec /mcp. Puis lance le prompt ci-dessus. Note les outils classés « modification » ou « envoi » : ce sont eux que tu surveilleras de près. Enfin, essaie de désactiver puis réactiver le serveur dans /mcp, pour savoir le faire le jour où tu en auras besoin.