Les serveurs MCP peuvent exposer des outils, des requêtes et des modèles de ressources à Kiro. Cette page explique comment interagir avec chacune de ces capacités sur toutes les surfaces.
Une fois que vous avez configuré les serveurs MCP, vous pouvez interagir avec leurs outils de plusieurs façons :
La façon la plus simple d'utiliser les outils MCP est de poser des questions liées au domaine du serveur :
Tell me about Amazon Bedrock
How do I configure S3 bucket policies?
Kiro sélectionne automatiquement l'outil MCP approprié en fonction de votre question.
Vous pouvez demander des outils MCP spécifiques en décrivant ce que vous voulez faire :
Search AWS documentation for information about ECS task definitions
Get recommendations for AWS CloudFormation best practices
Dans l'IDE, vous pouvez fournir un contexte explicite au sélecteur d'outils :
#[aws-docs] search_documentation Tell me about AWS Lambda
Ce format précise à la fois le serveur (aws-docs) et l'outil (search_documentation).
Le panneau Kiro comprend un onglet des serveurs MCP qui offre :
- Une liste de tous les serveurs MCP configurés
- Des indicateurs d'état de connexion
- La gestion individuelle des outils
- Un accès rapide aux outils du serveur
Pour accéder au panneau MCP :
- Sélectionnez l'icône Kiro dans la barre d'activité
- Accédez à l'onglet des serveurs MCP
- Consultez tous les serveurs connectés et leurs outils disponibles
Chaque serveur MCP peut exposer plusieurs outils. Vous pouvez activer ou désactiver des outils précis sans affecter l'ensemble du serveur :
Via le panneau Kiro :
- Ouvrez le panneau Kiro et accédez aux serveurs MCP
- Développez un serveur pour voir ses outils disponibles
- Cliquez sur un outil pour voir les options :
- Enable - Active un outil désactivé
- Disable - Désactive temporairement un outil sans retirer le serveur
- Les outils désactivés affichent une étiquette « Disabled » et ne seront pas offerts à Kiro
Via la configuration JSON :
Utilisez le tableau disabledTools dans votre configuration MCP pour désactiver de façon permanente des outils précis :
{ "mcpServers": { "github": { "command": "docker", "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"], "disabledTools": ["delete_repository", "force_push", "merge_pull_request"] } } }
Ceci est utile pour :
- Bloquer les opérations dangereuses (comme la suppression ou le force push)
- Réduire l'encombrement des outils en cachant les outils que vous n'utilisez pas
- Améliorer la performance en limitant les outils que Kiro considère
- Appliquer des politiques d'équipe lors du partage de configurations d'espace de travail
Faites un clic droit sur un serveur dans le panneau MCP pour accéder à des options supplémentaires :
- Reconnect - Redémarre la connexion au serveur
- Disable - Désactive temporairement l'ensemble du serveur
- Disable All Tools - Désactive tous les outils de ce serveur en une seule fois
- Enable All Tools - Réactive tous les outils précédemment désactivés
- Show MCP Logs - Affiche les journaux détaillés pour le dépannage
Lorsque Kiro veut utiliser un outil MCP, il demande d'abord votre approbation :
- Vous verrez une invite décrivant l'outil et son objectif
- Passez en revue les détails et les paramètres de l'outil
- Cliquez sur « Approve » pour permettre l'exécution de l'outil, ou sur « Deny » pour l'empêcher
Pour éviter des invites d'approbation répétées pour les outils auxquels vous faites confiance, ajoutez les noms d'outils au tableau autoApprove dans votre configuration MCP :
{ "mcpServers": { "aws-docs": { "autoApprove": [ "mcp_aws_docs_search_documentation", "mcp_aws_docs_read_documentation" ] } } }
Search AWS documentation for S3 bucket versioning
Ceci utilise l'outil mcp_aws_docs_search_documentation pour trouver la documentation AWS pertinente.
Read the AWS Lambda function URLs documentation
Ceci utilise l'outil mcp_aws_docs_read_documentation pour récupérer et afficher le contenu de la documentation.
Find related content to AWS ECS task definitions
Ceci utilise l'outil mcp_aws_docs_recommend pour suggérer de la documentation connexe.
Show me information about the tensorflow/tensorflow repository
Ceci récupère les détails du dépôt GitHub spécifié.
Find examples of React hooks in facebook/react
Ceci recherche du code correspondant à votre requête dans le dépôt spécifié.
Create an issue in my repository about the login bug
Ceci vous aide à créer un nouveau problème GitHub avec les détails appropriés.
Vous pouvez utiliser plusieurs outils MCP en séquence pour des tâches complexes :
First search AWS documentation for ECS task definitions, then find related content about service discovery
Les outils MCP fonctionnent mieux lorsqu'ils sont combinés avec votre contexte local :
Based on my Terraform code, help me optimize my AWS Lambda configuration using best practices from AWS documentation
Les serveurs MCP peuvent exposer des modèles de requêtes réutilisables qui fournissent des instructions préétablies pour des tâches courantes. Une requête est un modèle de message structuré défini par le serveur, avec un ensemble facultatif d'arguments que vous pouvez remplir pour la personnaliser. Les requêtes apparaissent avec les autres fournisseurs de contexte dans la liste de mentions # du clavardage.
- Tapez
#dans le champ de saisie du clavardage pour ouvrir le menu des fournisseurs de contexte - Les requêtes MCP des serveurs connectés apparaissent dans la liste avec une icône MCP
- Sélectionnez une requête pour l'insérer dans votre message
Si une requête n'a aucun argument, le contenu résolu est inséré directement dans votre contexte de clavardage.
Certaines requêtes acceptent des arguments pour personnaliser leur comportement. Lorsque vous sélectionnez une requête qui nécessite une saisie, un formulaire intégré apparaît où vous remplissez les paramètres avant que la requête soit ajoutée à votre message.
Par exemple, un serveur pourrait exposer une requête code_review avec un argument code requis et un argument language facultatif. Après avoir rempli le formulaire, le serveur résout la requête et le contenu résultant est inséré dans le contexte du clavardage.
Les requêtes sont toujours amorcées par l'utilisateur - Kiro n'envoie jamais de requête à un serveur sans que vous l'ayez sélectionnée. La liste des requêtes disponibles se met à jour automatiquement lorsque les serveurs en ajoutent ou en retirent.
Pour les détails complets du protocole, consultez la spécification des requêtes MCP.
Les serveurs MCP peuvent aussi exposer des modèles de ressources, qui sont des modèles d'URI paramétrés se résolvant en contenu précis. Comme les requêtes, les modèles de ressources apparaissent dans la liste de mentions # du clavardage.
- Tapez
#dans le champ de saisie du clavardage pour ouvrir le menu des fournisseurs de contexte - Les modèles de ressources des serveurs connectés apparaissent dans la liste avec une icône MCP
- Sélectionnez un modèle pour voir son formulaire d'arguments
Lorsque vous sélectionnez un modèle de ressource, un formulaire intégré apparaît pour que vous fournissiez les paramètres du modèle. Après avoir soumis le formulaire, Kiro résout l'URI et inclut le contenu de la ressource résultante comme contexte dans votre conversation.
Par exemple, un serveur de documentation pourrait exposer un modèle comme docs://{topic}/{version}. Vous rempliriez les champs de sujet et de version, et le contenu de documentation résolu devient accessible à Kiro.
Pendant l'exécution d'un outil, un serveur MCP peut avoir besoin de renseignements supplémentaires de votre part pour accomplir sa tâche. C'est ce qu'on appelle l'élicitation. Plutôt que d'échouer ou de deviner, le serveur s'arrête et vous demande directement. Kiro CLI prend en charge l'élicitation dans les sessions V3 locales à partir de la version 2.34.
Lorsqu'un outil a besoin de plus d'informations, il envoie une demande d'élicitation avec un message expliquant ce dont il a besoin. Kiro affiche un formulaire intégré dans la chronologie d'exécution avec des champs basés sur le type de données demandées :
| Type de champ | Rendu comme |
|---|---|
| Texte | Champ de texte (peut inclure des indices de format comme courriel ou date) |
| Nombre | Champ numérique |
| Oui/Non | Case à cocher |
| Choix | Menu déroulant de sélection |
Les champs requis sont indiqués, et les valeurs par défaut sont préremplies lorsqu'elles sont fournies par le serveur.
Après avoir examiné le formulaire, vous pouvez soumettre vos réponses, refuser la demande ou l'ignorer. Si vous refusez ou l'ignorez, le serveur décide comment procéder - il pourrait offrir des solutions de remplacement ou sauter complètement l'étape.
Pour les détails complets du schéma, consultez la spécification d'élicitation MCP.
Certains serveurs demandent que vous visitiez une URL externe, par exemple pour compléter un processus d'autorisation OAuth. Dans ce cas, Kiro affiche l'URL avec un bouton Open dans la chronologie d'exécution. Après avoir complété l'action externe, l'outil poursuit son exécution.
Kiro vous montre toujours quel serveur demande des renseignements et quelles données il requiert. Vous pouvez refuser toute demande d'élicitation à tout moment. Les serveurs ne devraient pas demander de renseignements sensibles comme des mots de passe par élicitation - si vous voyez une telle demande, demandez-vous si vous faites confiance au serveur.
Vous pouvez créer vos propres serveurs MCP pour étendre les capacités de Kiro selon vos besoins précis.
- Choisissez un langage de programmation (Python, Node.js, etc.)
- Implémentez le protocole MCP à l'aide des bibliothèques disponibles
- Définissez vos outils et leurs capacités
- Empaquetez et distribuez votre serveur
Si vous rencontrez des problèmes lors de l'utilisation des outils MCP :
- Vérifiez l'état du serveur MCP dans le panneau Kiro (IDE) ou utilisez
/mcp(CLI) - Passez en revue les journaux MCP pour voir les messages d'erreur
- Essayez de reconnecter le serveur
- Essayez de reformuler votre demande pour être plus précis
- Vérifiez que vous utilisez l'outil approprié pour votre tâche
- Vérifiez que le serveur MCP dispose des permissions nécessaires
- Assurez-vous que le serveur MCP est correctement configuré
- Vérifiez que le serveur est en cours d'exécution et connecté
- Vérifiez que vous disposez des permissions nécessaires pour utiliser l'outil
- Soyez précis dans vos demandes pour obtenir les résultats les plus pertinents
- Commencez par des questions directes avant d'utiliser des références explicites aux outils
- Approuvez automatiquement seulement les outils auxquels vous faites confiance et que vous utilisez fréquemment
- Combinez les outils MCP avec le contexte local pour de meilleurs résultats
- Vérifiez les paramètres des outils avant l'approbation pour vous assurer qu'ils sont corrects
Pour des renseignements sur les serveurs MCP disponibles, consultez le répertoire de serveurs MCP.
Outils