Passer au contenu principal
Afficher en Markdown

Intégrations (MCP)

Les serveurs MCP (Model Context Protocol) étendent ce que l'agent peut faire — accéder à des API externes, se connecter à des bases de données, effectuer des recherches dans la documentation, exécuter des outils spécialisés. Chaque serveur fournit un ensemble d'outils que l'agent peut appeler pendant les conversations.

Gestion des intégrations

Depuis le tableau de bord (recommandé)

Dans Kiro Crew 0.13.0 ou une version ultérieure, ouvrez Personnaliser → Serveurs MCP. Dans les versions antérieures, ouvrez Agent Capabilities → Integrations (MCP). Le panneau affiche tous les serveurs configurés avec leur état (connecté, erreur, inconnu) et vous permet de :

  • Activer / désactiver des serveurs individuels
  • Ajouter de nouveaux serveurs — spécifiez une commande ou une URL
  • Supprimer les serveurs dont vous n'avez plus besoin
  • Sonder les serveurs pour vérifier qu'ils répondent
  • Toujours autoriser un seul outil, comme décrit dans Cesser de demander l'autorisation pour un outil

Les cartes de connexion pour des services comme GitHub, Notion et Google se trouvent sous Paramètres → Connexions, et non dans cet onglet. Consultez Google Workspace.

Serveurs intégrés

Crew est fourni avec deux serveurs gérés qui sont toujours disponibles :

ServeurOutils fournis
kirocrew-coreCréer des sous-agents, tirer des leçons, exécuter des tâches, enregistrer des hooks, envoyer des messages, effectuer des recherches dans les connaissances
kirocrew-cronPlanifier, lister, mettre en pause, reprendre, déclencher, supprimer des tâches cron

Ces serveurs se chargent automatiquement — aucune configuration requise.

Découverte de nouveaux serveurs

Cliquez sur Discover & Sync dans l'onglet Serveurs MCP. Crew analyse vos fichiers de configuration MCP et ajoute tous les nouveaux serveurs qu'il trouve. Cliquez ensuite sur Probe All pour vérifier que chaque serveur répond à la prise de contact MCP.

Serveurs courants à ajouter :

  • slack-mcp — accès à l'API Slack
  • playwright — automatisation de navigateur sans interface graphique
  • Serveurs de documentation pour votre pile technologique
  • Serveurs personnalisés pour les outils internes de votre équipe

Serveurs distants authentifiés

Lorsque vous ajoutez un serveur MCP distant qui nécessite une authentification, fournissez ses en-têtes de requête (comme un en-tête Authorization) au moment de l'ajouter, plutôt que de modifier manuellement un fichier de configuration.

Google Workspace

Dans Kiro Crew 0.12.0 ou une version ultérieure, Paramètres → Connexions propose Gmail, Google Drive, Google Agenda, Google Sheets, Google Docs et Google Slides. Dans la version 0.13.0 ou ultérieure, les six produits partagent une seule entrée Google, et vous sélectionnez Connecter pour chaque produit voulu. Chaque carte communique avec le serveur MCP Workspace distant de Google par un client OAuth que vous créez dans votre propre projet Google Cloud. Google ne prend pas en charge l'enregistrement dynamique des clients; une carte affiche donc Configuration requise jusqu'à ce qu'un client soit enregistré. Dans la version 0.12.0, le client s'enregistre sous Paramètres → Applications OAuth. Dans la version 0.13.0 ou ultérieure, Paramètres → Applications OAuth n'existe plus et vous enregistrez le client dans l'entrée Google de Paramètres → Connexions.

Avant de vous connecter

Les serveurs MCP Workspace de Google sont en version préliminaire pour développeurs. Dans la console Google Cloud :

  1. Inscrivez le projet Cloud au programme de version préliminaire pour développeurs de Google Workspace.
  2. Activez l'API du produit et son API MCP (par exemple, l'API Gmail et l'API MCP Gmail).
  3. Créez un client OAuth de type Application Web en cochant Utiliser ce client pour un agent alimenté par l'IA.
  4. Enregistrez l'URI de redirection de chaque carte que vous prévoyez d'utiliser. Un seul client peut servir toutes les cartes Google : ajoutez-y l'URI de redirection de chaque carte, puis collez le même identifiant client et le même secret une seule fois. Dans la version 0.13.0 ou ultérieure, l'application OAuth de l'entrée Google conserve un seul identifiant client et un seul secret pour les six produits, et énumère l'URI de redirection de chaque produit. Dans la version 0.12.0, collez-les dans chaque carte sous Paramètres → Applications OAuth.
CarteURI de redirection
Gmailhttp://127.0.0.1:48104/callback
Google Drivehttp://127.0.0.1:48103/callback
Google Agendahttp://127.0.0.1:48105/callback
Google Sheetshttp://127.0.0.1:48109/callback
Google Docshttp://127.0.0.1:48110/callback
Google Slideshttp://127.0.0.1:48111/callback

Connecter une carte

  1. Collez l'identifiant client et le secret client, puis sélectionnez Enregistrer. Dans la version 0.13.0 ou ultérieure, faites-le dans l'application OAuth de l'entrée Google de Paramètres → Connexions. Dans la version 0.12.0, ouvrez Paramètres → Applications OAuth et choisissez la carte Google. Chaque produit passe de Configuration requise à Connecter.
  2. Sélectionnez Connecter pour chaque produit voulu. La page de consentement de Google nomme votre client OAuth et énumère les portées en lecture seule ci-dessous; approuvez-la.
  3. La carte affiche Connecté.

Si votre passerelle s'exécute sur une autre machine, le navigateur aboutit à une page http://127.0.0.1:... qui ne peut pas se charger. C'est normal. Copiez l'adresse complète depuis la barre d'adresse du navigateur et collez-la dans le champ Adresse de retour de la carte; la passerelle termine l'échange et la carte affiche Connecté.

Ce que l'agent peut atteindre

Chaque carte demande uniquement des portées en lecture seule :

CartePortées
Gmailgmail.readonly
Google Drivedrive.readonly
Google Agendacalendar.calendarlist.readonly, calendar.events.readonly, calendar.events.freebusy
Google Sheetsspreadsheets.readonly, drive.readonly
Google Docsdocuments.readonly, drive.readonly
Google Slidespresentations.readonly, drive.readonly

gmail.readonly et drive.readonly sont des portées restreintes : elles lisent chaque message et chaque paramètre, ou chaque fichier Drive, du compte. Les portées qu'une carte demande sont fixes. Les outils qui écrivent (brouillons et libellés dans Gmail, ou création et mise à jour de fichiers, de documents et d'événements) échouent avec une erreur de permission, et l'ajout d'une portée d'écriture à votre client Google ne change pas ce que la carte demande.

Traitez les courriels et les fichiers que ces serveurs renvoient comme des entrées non fiables. Les portées en lecture seule empêchent ces outils Google d'écrire, mais ce qu'ils renvoient peut tout de même orienter les prochaines actions de l'agent; examinez les invites d'approbation et gardez sous contrôle les outils d'écriture sans rapport.

Autorisations et révocation

  • Une application externe laissée en mode Test perd son autorisation sept jours après le consentement; une application interne (Google Workspace) ne la perd pas.
  • Révoquer l'application dans votre compte Google retire d'un coup tous les produits Google connectés par ce projet Cloud.

Cesser de demander l'autorisation pour un outil

Dans Kiro Crew 0.13.0 ou une version ultérieure, chaque outil de la liste d'outils d'un serveur sous Personnaliser → Serveurs MCP comporte un interrupteur Toujours autoriser. La carte d'approbation d'un outil MCP ajoute aussi Toujours autoriser cet outil à son menu Trust. Dans les deux cas, cet outil cesse de demander une autorisation avant chaque appel jusqu'à ce que vous désactiviez de nouveau l'interrupteur.

Les propres règles de sécurité de Kiro Crew s'appliquent toujours à un outil toujours autorisé. L'interrupteur est refusé pour un serveur dont les paramètres demandent une autorisation avant chaque appel, pour un paramètre géré par un fichier de paramètres local sur cet ordinateur, et pour les outils propres à Kiro Crew, qui demandent toujours une autorisation.

Ensembles d'outils par agent

Par défaut, chaque serveur activé est accessible à toutes les sessions. Vous pouvez aussi limiter la portée des serveurs à des agents particuliers, afin que chaque agent ne voie que les outils dont il a besoin, sans modifier la configuration globale. Le sélecteur d'agents fait aussi apparaître les agents locaux au projet trouvés dans la session active.

Comment l'agent utilise les outils MCP

Une fois qu'un serveur est activé, ses outils apparaissent automatiquement dans la liste d'outils de l'agent. L'agent décide quand les appeler selon la conversation. Vous n'avez pas besoin d'indiquer à l'agent quel outil utiliser — il lit les descriptions des outils et choisit le bon.

Vous pouvez régler le degré auquel la recherche d'outils reporte le chargement des outils, en les masquant jusqu'à ce qu'ils soient nécessaires, afin de trouver un équilibre entre le budget de contexte et l'accès immédiat.

Les appels d'outils provenant des serveurs MCP passent par le même pipeline d'approbation que les outils intégrés : invites d'approbation interactives (ou approbation automatique en mode Autopilot), les commandes refusées et les contrôles de sécurité continuant de s'appliquer.

Page mise à jour : 18 novembre 2026