Outils

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

{
  "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"]
    }
  }
}

Lorsque Kiro veut utiliser un outil MCP, il demande d'abord votre approbation :

1. Vous verrez une invite décrivant l'outil et son objectif
2. Passez en revue les détails et les paramètres de l'outil
3. 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.

1. Tapez # dans le champ de saisie du clavardage pour ouvrir le menu des fournisseurs de contexte
2. Les requêtes MCP des serveurs connectés apparaissent dans la liste avec une icône MCP
3. 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.

1. Tapez # dans le champ de saisie du clavardage pour ouvrir le menu des fournisseurs de contexte
2. Les modèles de ressources des serveurs connectés apparaissent dans la liste avec une icône MCP
3. 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.

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 :

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.

1. Choisissez un langage de programmation (Python, Node.js, etc.)
2. Implémentez le protocole MCP à l'aide des bibliothèques disponibles
3. Définissez vos outils et leurs capacités
4. Empaquetez et distribuez votre serveur

• Spécification du protocole MCP
• Modèle de serveur MCP (Python)
• Modèle de serveur MCP (Node.js)

Si vous rencontrez des problèmes lors de l'utilisation des outils MCP :

1. Vérifiez l'état du serveur MCP dans le panneau Kiro (IDE) ou utilisez /mcp (CLI)
2. Passez en revue les journaux MCP pour voir les messages d'erreur
3. Essayez de reconnecter le serveur

1. Essayez de reformuler votre demande pour être plus précis
2. Vérifiez que vous utilisez l'outil approprié pour votre tâche
3. Vérifiez que le serveur MCP dispose des permissions nécessaires

1. Assurez-vous que le serveur MCP est correctement configuré
2. Vérifiez que le serveur est en cours d'exécution et connecté
3. 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 la page Répertoire des serveurs.