Model Context Protocol (MCP)

Le Model Context Protocol (MCP) étend les capacités de Kiro en se connectant à des serveurs spécialisés qui fournissent des outils et du contexte supplémentaires. Ce guide vous aide à configurer et à utiliser des serveurs MCP avec Kiro sur toutes les surfaces.

MCP est un protocole qui permet à Kiro de communiquer avec des serveurs externes pour accéder à des outils, des requêtes et des ressources spécialisés. Par exemple, le serveur MCP de documentation AWS fournit des outils pour effectuer des recherches, lire de la documentation AWS et obtenir des recommandations directement dans Kiro.

Avec MCP, vous pouvez :

• Accéder à des bases de connaissances et à de la documentation spécialisées
• Vous intégrer à des services et à des API externes
• Étendre les capacités de Kiro avec des outils propres à un domaine
• Utiliser des modèles de requêtes et des modèles de ressources fournis par le serveur via le système de mention # dans le clavardage
• Répondre aux demandes de sollicitation du serveur lorsque les outils nécessitent des renseignements supplémentaires pendant l'exécution
• Créer des outils personnalisés pour vos flux de travail spécifiques

Avant d'utiliser MCP, assurez-vous d'avoir :

1. La dernière version de Kiro installée
2. Les prérequis particuliers aux serveurs MCP que vous souhaitez utiliser (indiqués dans la documentation de chaque serveur)

{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "disabled": false
    }
  }
}

Certains répertoires de serveurs et certains sites Web offrent des liens d'installation en un clic qui utilisent le schéma d'URL kiro://. Ouvrir un de ces liens ne modifie pas immédiatement votre configuration : Kiro affiche une boîte de dialogue de confirmation avant que quoi que ce soit soit écrit dans votre configuration. La boîte de dialogue liste la commande qui sera exécutée et ses arguments, ainsi que les noms des variables d'environnement ou des en-têtes - leurs valeurs restent cachées. Passez les détails en revue et confirmez pour ajouter le serveur, ou annulez pour laisser votre configuration inchangée.

Vous pouvez également définir des serveurs MCP directement dans le fichier de configuration d'un agent. Le champ mcpServers spécifie les serveurs MCP auxquels l'agent a accès :

{
  "name": "myagent",
  "description": "My special agent",
  "mcpServers": {
    "fetch": {
      "command": "fetch3.1",
      "args": []
    }
  },
  "includeMcpJson": false
}

Le champ includeMcpJson détermine si les serveurs MCP définis dans les fichiers de configuration de l'espace de travail et de l'utilisateur doivent être inclus. Lorsqu'il est défini à true, l'agent a accès à tous les serveurs MCP définis dans les configurations utilisateur et espace de travail, en plus de ceux définis dans le champ mcpServers de l'agent.

Si vous voyez « The following tools have been excluded due to validation errors », l'outil ne répond pas à une de ces exigences :

• Le nom de l'outil dépasse 64 caractères (préfixe du serveur inclus)
• Le nom de l'outil contient des caractères invalides (doit correspondre à ^[a-zA-Z][a-zA-Z0-9_]*$)
• La description de l'outil est vide

Communiquez avec le mainteneur du serveur MCP pour corriger la spécification de l'outil.

Si vous voyez « The following tools have large descriptions which may impact agent performance », la description d'un outil dépasse 10 000 caractères. L'outil fonctionne toujours, mais peut ralentir les réponses. Envisagez de demander au mainteneur du serveur de raccourcir la description.

• Documentation officielle du MCP

• Configuration - Options de configuration détaillées et structure des fichiers
• Répertoire des serveurs - Parcourir les serveurs MCP disponibles
• Outils - Découvrir comment utiliser efficacement les outils MCP
• Pratiques exemplaires - Pratiques exemplaires en matière de sécurité pour l'utilisation de MCP