Passer au contenu principal
Un module d’extension peut inclure des serveurs MCP (par exemple un outil de suivi des tickets) : toutes les personnes qui l’installent disposent ainsi de la même configuration de serveur, sans devoir la recréer de zéro. Une fois le module installé, vous fournissez les informations d’identification requises par le serveur, comme une clé d’API ou une connexion OAuth. Une connexion peut être personnelle ou partagée, selon l’endroit où le module d’extension est installé et le paramètre Access de l’installation.

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.

  1. 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.

  1. 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 Authorization contient 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.

  1. 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.

  1. Les deux dans un seul module d’extension

Fournissez les deux entrées, comme dans la déclaration ci-dessus, puis proposez le module d’extension. Chaque organisation qui l’installe dispose alors de deux lignes : l’une à laquelle les membres se connectent individuellement, l’autre que l’administrateur d’organisation connecte. Grâce à des noms de serveur distincts, les skills du module d’extension peuvent indiquer quel serveur utiliser.