Passer au contenu principal
Afficher en Markdown

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.

CapacitéIDECLIWebMobile
Serveurs MCP locaux (stdio)✓✓✓✓
Serveurs MCP distants (HTTP/SSE)✓✓✓✓
Connexion OAuth pour les serveurs MCP distants✓✓Powers seulementPowers seulement
Fichier de configuration MCP (JSON)✓✓✓✓
Requêtes et ressources fournies par le serveur✓✓✓—

Dans Kiro Web et dans les sessions que vous démarrez depuis Kiro Mobile, les serveurs MCP distants se connectent à l'aide d'une URL et d'en-têtes facultatifs, comme un en-tête Authorization qui utilise un secret. Les paramètres oauth de mcp.json ne sont pas utilisés. Pour connecter un service qui exige une connexion OAuth, installez son Power et sélectionnez Authorize. Kiro Mobile n'a pas de menu de mention #; il ne peut donc pas insérer les requêtes ni les ressources fournies par le serveur.

Qu'est-ce que MCP?

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

Configuration de MCP

Prérequis

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)

Ajout d'un serveur MCP

1

Ouvrir la configuration MCP

Ouvrez la palette de commandes (Cmd + Shift + P sur Mac, Ctrl + Shift + P sur Windows/Linux) et recherchez Kiro: Open workspace MCP config (JSON) ou Kiro: Open user MCP config (JSON).

Vous pouvez également ouvrir le panneau Kiro et sélectionner l'icône Open MCP Config.

2

Ajouter votre configuration de serveur

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

Enregistrer et vérifier

Enregistrez le fichier de configuration (Cmd+S). Les serveurs se reconnectent automatiquement. Consultez l'onglet des serveurs MCP dans le panneau Kiro pour confirmer que le serveur est connecté.

Installation à partir d'un lien d'installation

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.

Configuration de l'agent

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 :

json
{ "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.

Dépannage

Vérification des journaux MCP

  1. Ouvrez le panneau Kiro
  2. Sélectionnez l'onglet Output
  3. Choisissez « Kiro - MCP Logs » dans le menu déroulant

Problèmes courants et solutions

ProblèmeSolution
Échecs de connexionVérifiez que les prérequis sont correctement installés
Erreurs de permissionVérifiez que les jetons et les clés API sont valides
L'outil ne répond pasPassez en revue les journaux MCP pour connaître les messages d'erreur précis
La configuration ne se charge pasValidez la syntaxe JSON et enregistrez le fichier de configuration

Erreurs de validation des outils

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.

Avertissements de description volumineuse

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.

Ressources supplémentaires

Prochaines étapes

Page mise à jour : 12 novembre 2026