Aller au contenu
Floskool

Chapitre 1 · Comprendre les MCP

Les 3 portées : toi, ton projet, ton équipe

Leçon gratuite 7 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 la portée compte

Quand tu ajoutes un serveur, tu choisis où il sera disponible. C'est la portée (en anglais scope), réglée avec l'option --scope, ou sa forme courte -s.

Exemple : Sophie est coach et gère deux dossiers dans Claude Code, un pour son site et un pour ses contenus. Son outil de notes lui sert partout : elle veut le serveur dans les deux dossiers. Mais un outil de facturation qu'elle teste ne doit apparaître que dans un dossier. Et si un jour elle travaille avec une assistante, elle voudra que celle-ci ait la même configuration, sans partager ses accès personnels. Trois besoins, trois portées.

Les trois portées, d'après la documentation

local (par défaut)

  • Pour qui : toi seul, dans le projet courant seulement.
  • Où c'est rangé : dans ton fichier de configuration personnel ~/.claude.json (le ~ désigne ton dossier utilisateur), sous le chemin du projet.
  • Partagé : non.
  • C'est ce que tu obtiens si tu n'écris pas --scope.

user

  • Pour qui : toi, dans tous tes projets.
  • Où c'est rangé : aussi dans ~/.claude.json.
  • Partagé : non.
  • Idéal pour un outil que tu utilises partout.

project

  • Pour qui : toute personne qui travaille sur ce projet.
  • Où c'est rangé : dans un fichier .mcp.json à la racine du projet (le dossier principal).
  • Partagé : oui, ce fichier est fait pour être enregistré dans le suivi de versions (Git, l'outil qui garde l'historique de tes fichiers).
  • Par sécurité, la documentation indique que Claude Code demande une approbation avant d'utiliser les serveurs d'un .mcp.json dans une session interactive. Si tu changes d'avis, la commande claude mcp reset-project-choices remet ces choix à zéro.

Lequel choisir ?

  • Tu testes : laisse local (rien à ajouter).
  • Tu utilises cet outil dans tous tes dossiers : user.
  • Toute l'équipe du projet doit avoir le même outil : project.

Les commandes, telles que la documentation les donne

Les adresses ci-dessous sont des exemples tirés de la documentation de Claude Code. Avant de les utiliser pour de vrai, vérifie l'adresse dans la documentation officielle du service concerné.

Portée locale (par défaut) :

claude mcp add --transport http stripe https://mcp.stripe.com

Portée utilisateur :

claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

Portée projet :

claude mcp add --transport http shared-server --scope project https://example.com/mcp

La dernière commande crée (ou complète) un fichier .mcp.json qui ressemble à ceci :

{
  "mcpServers": {
    "shared-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

Et si le même nom existe à plusieurs endroits ?

La documentation donne un ordre de priorité : local d'abord, puis project, puis user, puis les serveurs fournis par des plugins (des extensions de Claude Code), puis les connecteurs de claude.ai. Concrètement : si tu as un serveur « notes » en portée user et un autre « notes » en portée local dans un projet, c'est la version locale qui sert dans ce projet.

Conseil simple : donne des noms différents à tes serveurs pour ne jamais te demander lequel est utilisé.

Copie ce prompt pour faire le point sur tes portées actuelles :

Fais l'inventaire de mes serveurs MCP, sans rien modifier :
1. liste chaque serveur avec sa portée (local, project ou user) et le fichier où il est déclaré,
2. signale les noms en double entre portées,
3. pour chacun, dis si la portée me semble adaptée et pourquoi, en une phrase.
Attends mon accord avant tout changement.

Les erreurs à éviter

  • Mettre en portée project un serveur qui contient une clé. Le fichier .mcp.json est partagé : une clé écrite dedans serait visible par tous ceux qui ont le projet. On voit à la leçon 6 comment l'éviter.
  • Tout mettre en user par facilité. Un serveur disponible partout est un serveur dont Claude peut se servir partout. Garde user pour ce qui sert vraiment partout.
  • Approuver sans lire les serveurs d'un .mcp.json que tu as récupéré. Regarde ce qu'il contient avant de dire oui.

À toi de jouer

Pour chaque outil repéré à la leçon 2, décide de sa portée : local, user ou project. Écris une phrase de justification par outil. Exemple : « Notes : user, je m'en sers dans tous mes dossiers. »