La déclaration
Déclarez les serveurs dans un fichier.mcp.json placé à la racine, sous la forme d’une map mcpServers. Le champ mcpServers défini en ligne dans le manifeste accepte la même map, sans l’objet englobant.
Espaces réservés.
${NAME} dans url ou headers est renseigné par la personne qui installe le module, depuis le volet Connect du serveur. ${NAME:-default} fournit une valeur de fallback lorsqu’aucune valeur n’est enregistrée. Un serveur de module d’extension lit uniquement les valeurs enregistrées sur son installation, et non les secrets de session portant le même nom. N’écrivez jamais de vrai token dans une déclaration : il est stocké tel quel.
Un serveur peut aussi exécuter une commande locale (command, args, env) ; il n’accepte alors aucun des champs d’identification HTTP ci-dessus.
La page serveurs MCP décrit le formulaire Personnaliser pour un serveur autonome. Le serveur d’un module d’extension utilise les noms de champs ci-dessus, et son URL, son transport et ses en-têtes s’affichent en lecture seule sur la ligne de l’installation.
Qui détient les informations d’identification
Configurations
Chaque configuration associe une entrée de la déclaration ci-dessus à l’emplacement où le module d’extension est installé et à son mode de distribution : Obligatoire l’installe pour tous les utilisateurs du périmètre, Proposé permet à chaque organisation ou membre de l’installer. Ces deux options se définissent au niveau du module d’extension, dans Personnaliser.
- OAuth par utilisateur pour tout le monde
Pour un serveur qui prend en charge OAuth, utilisez l’entrée example-mcp et installez le module d’extension avec le statut Obligatoire au niveau de l’Enterprise ou de l’organisation.
Avec tokenScope: "user", Access est défini sur Personnel par défaut : chaque membre se connecte donc une seule fois, depuis Personnaliser → MCPs ou lors de la première session qui en a besoin.
- Un compte de service d’organisation
Utilisez l’entrée example-mcp-service-account et installez le module d’extension au niveau de l’organisation.
- L’en-tête
Authorizationcontient un espace réservé ; la ligne affiche donc Connect. Un administrateur d’organisation saisit le token ; les membres ne le voient jamais. - Si le serveur rejette le token (401), la ligne affiche Check the information d’identification. Si le serveur annonce également la prise en charge d’OAuth, la ligne propose en plus Sign in with OAuth instead.
- Pour un compte de service qui se connecte via OAuth, supprimez l’en-tête, définissez
tokenScope: "org"et connectez l’identifiant de ce compte.
- Une clé par organisation
Placez l’entrée example-mcp-service-account dans un module d’extension Enterprise et définissez-le sur Proposé aux organisations.
- Chaque organisation qui l’installe est propriétaire de son installation : son administrateur renseigne donc
${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}avec la clé de cette organisation. - Aucune connexion n’est établie au niveau de l’Enterprise, et aucune organisation ne voit la clé d’une autre.
- À l’inverse, un module d’extension Enterprise Obligatoire crée une seule installation appartenant à l’Enterprise : une seule clé pour toutes les organisations.

