Les clients de niveau Pro qui utilisent IAM Identity Center peuvent contrôler l'accès aux serveurs MCP au moyen d'un registre MCP. Lorsque celui-ci est configuré par les administrateurs, les utilisateurs ne peuvent utiliser que les serveurs MCP explicitement autorisés dans le registre.
Sans registre (par défaut) :
- Les utilisateurs peuvent ajouter n'importe quel serveur MCP
- Les serveurs sont configurés dans les fichiers d'agent ou via l'interface CLI
- Aucun contrôle central
Avec registre (entreprise) :
- L'administrateur configure les serveurs autorisés
- Les utilisateurs sélectionnent un serveur dans la liste du registre
- Impossible d'ajouter des serveurs personnalisés - les serveurs qui ne figurent pas dans le registre sont masqués, y compris ceux que vous définissez vous-même dans
mcp.json - Gouvernance et sécurité centralisées
En mode registre, les serveurs disponibles apparaissent dans le panneau MCP. Sélectionnez un serveur pour l'ajouter à votre configuration.
Lorsqu'un registre est actif, il constitue la seule source de serveurs pouvant s'exécuter. Un serveur que vous définissez dans mcp.json (fichier global ~/.kiro/settings/mcp.json ou fichier de l'espace de travail .kiro/settings/mcp.json) n'est admissible à l'exécution que si son nom correspond à une entrée du registre. Tout le reste est masqué et ne démarre jamais, y compris les serveurs qui fonctionnaient avant l'activation du registre.
Dans l'IDE, les serveurs masqués apparaissent sous la forme d'un avis « N serveurs masqués » dans le panneau MCP plutôt que sous forme d'entrées individuelles. Pour exécuter un serveur qui ne figure pas dans le registre, demandez à votre administrateur de l'ajouter.
Dans une session V3 de Kiro CLI, une correspondance de nom ne suffit pas. Un serveur du registre ne s'exécute que lorsque son entrée mcp.json est déclarée comme {"type": "registry"}. Une entrée qui correspond à un nom du registre, mais qui fournit son propre command ou url, est ignorée. Le panneau /mcp liste les serveurs configurés que le registre a masqués et, pour les serveurs que le registre offre, montre comment les déclarer. kiro-cli mcp list marque ces serveurs comme ignorés plutôt qu'actifs.
Une entrée mcp.json dont le nom figure dans le registre reste utile : c'est ainsi que vous fournissez des valeurs propres à votre configuration, comme des clés API ou des chemins locaux. Voir Substitutions des serveurs du registre.
Même avec le mode registre activé, vous pouvez personnaliser les serveurs en utilisant des substitutions de registre dans votre configuration d'agent ou dans un fichier mcp.json (fichier global ~/.kiro/settings/mcp.json ou fichier de l'espace de travail .kiro/settings/mcp.json). Vos valeurs sont fusionnées par-dessus les valeurs par défaut du registre - par exemple, si le registre définit NODE_ENV=development et que votre substitution définit NODE_ENV=production, le serveur s'exécute avec NODE_ENV=production. Les objets env et headers fusionnent par clé, de sorte que les valeurs par défaut du registre que vous ne remplacez pas sont conservées.
{ "mcpServers": { "github": { "type": "registry", "env": { "GITHUB_TOKEN": "$GITHUB_TOKEN", "GITHUB_ORG": "my-org" }, "timeout": 60000 } } }
Champs de substitution :
- Serveurs locaux (stdio) -
env(variables d'environnement),timeout(délai d'expiration de la requête en ms) - Serveurs distants (HTTP) -
headers(en-têtes HTTP),timeout(délai d'expiration de la requête en ms),oauthetoauthScopes
Les substitutions que vous définissez pour une entrée de type registre sont transmises au serveur lancé, de sorte que le processus en cours d'exécution utilise vos valeurs personnalisées.
Kiro CLI V3 utilise les paramètres oauth et oauthScopes fournis par le registre d'une organisation pour les serveurs distants. Une substitution de registre correspondante peut remplacer ces valeurs pour votre configuration locale. Ces champs utilisent le même format que les serveurs distants dans mcp.json. Consultez Authentification OAuth pour connaître les champs et les règles de portée.
Registre MCP