Utilisation de serveurs MCP avec Amazon Q Developer
Le protocole de contextualisation des modèles (MCP) est une norme ouverte qui permet aux assistants d’intelligence artificielle d’interagir avec des outils et services externes. L’interface de ligne de commande d’Amazon Q Developer prend désormais en charge le protocole MCP, ce qui vous permet d’étendre les fonctionnalités d’Amazon Q en le connectant à des outils et services personnalisés.
Rubriques
Configuration de serveurs MCP
Désactivation des serveurs MCP de votre organisation
En fonction de votre configuration, vous pouvez avoir la possibilité de désactiver les serveurs MCP de votre compte AWS ou de votre organisation dans la console Amazon Q Developer. Cela s’applique si :
vous gérez une organisation à partir de votre compte de gestion ou vous utilisez un compte autonome ;
vous utilisez Amazon Q Developer dans un IDE compatible.
Note
Ce paramètre est appliqué côté client. Sachez que vos utilisateurs finaux peuvent le contourner.
Pour désactiver le serveur MCP de votre compte ou votre organisation, procédez comme suit :
Ouvrez la console Amazon Q Developer.
Sélectionnez Paramètres.
Sous Préférences, choisissez Modifier.
Dans la fenêtre contextuelle Modifier les préférences, activez Protocole de contextualisation des modèles (MCP).
Choisissez Enregistrer.
Configuration de serveurs MCP à l’aide de l’interface de ligne de commande d’Amazon Q
La configuration de serveurs MCP à l’aide de l’interface de ligne de commande d’Amazon Q est gérée à l’adresse :
~/.aws/amazonq/cli-agents
Pour plus d’informations, consultez le guide de configuration des agents personnalisés dans le référentiel GitHub de l’interface de ligne de commande d’Amazon Q
Configuration de serveurs MCP avec Amazon Q dans l’IDE
La configuration de serveurs MCP avec Amazon Q dans l’IDE est gérée à l’adresse :
~/.aws/amazonq/agents/default.json
Pour plus d’informations, consultez Configuration des serveurs MCP d’Amazon Q Developer dans l’IDE.
Chargement de serveurs MCP
Amazon Q charge les serveurs MCP en arrière-plan, ce qui vous permet de commencer à interagir immédiatement sans attendre l’initialisation de tous les serveurs. Les outils deviennent disponibles au fur et à mesure que leurs serveurs respectifs sont chargés.
Vérification du statut des serveurs
Vous pouvez utiliser la commande /tools pour voir quels sont les serveurs en cours de chargement et quels sont les outils déjà disponibles.
Configuration de l’initialisation des serveurs
Vous pouvez personnaliser le délai d’initialisation des serveurs en utilisant :
$ q settings mcp.initTimeout [value]
Où [value] est le délai d’expiration en millisecondes. Ce paramètre contrôle la durée pendant laquelle Amazon Q attend l’initialisation des serveurs avant de vous permettre de commencer à interagir.
Outils et invites
Cette section explique comment utiliser les outils et invites MCP avec l’interface de ligne de commande d’Amazon Q Developer.
Présentation des outils MCP
Les outils MCP sont des fonctions exécutables que les serveurs MCP exposent à l’interface de ligne de commande d’Amazon Q Developer. Ils permettent à Amazon Q Developer d’effectuer des actions, de traiter des données et d’interagir avec des systèmes externes en votre nom.
Chaque outil MCP possède les éléments suivants :
-
Nom : identifiant unique de l’outil
-
Description : description en langage humain de l’action de l’outil
-
Schéma d’entrée : schéma JSON définissant les paramètres acceptés par l’outil
-
Annotations : conseils facultatifs sur le comportement et les effets de l’outil
Identification des outils disponibles
Pour connaître les outils disponibles dans votre session d’interface de ligne de commande Amazon Q :
/tools
Cette commande affiche tous les outils disponibles, y compris ceux intégrés et ceux fournis par les serveurs MCP.
Les outils peuvent disposer de différents niveaux d’autorisation qui déterminent la manière dont ils sont utilisés :
-
Approuvés automatiquement : ces outils peuvent être utilisés sans autorisation explicite à chaque invocation
-
Approbation requise : ces outils nécessitent votre autorisation explicite chaque fois qu’ils sont utilisés
-
Dangereux : ces outils sont marqués comme potentiellement à risque et nécessitent un examen attentif avant d’être approuvés
Utilisation des outils
Vous pouvez utiliser les outils MCP de deux façons :
-
Demandes en langage naturel : décrivez simplement ce que vous voulez faire, et Amazon Q déterminera l’outil à utiliser.
-
Invocation directe d’un outil : vous pouvez également demander explicitement à Amazon Q d’utiliser un outil spécifique.
Utilisation d’invites
Les serveurs MCP peuvent fournir des invites prédéfinies qui contribuent à guider Amazon Q dans des tâches spécifiques :
-
Répertorier les invites disponibles :
/prompts -
Utiliser une invite :
-
@prompt-namearg1 arg2
-
Exemple d’utilisation d’invite avec des arguments :
@fetch https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html
Principaux avantages
-
Extensibilité : connectez Amazon Q à des outils spécialisés pour des domaines ou des flux de travail spécifiques
-
Personnalisation : créez des outils personnalisés adaptés à vos besoins spécifiques
-
Intégration de l’écosystème : tirez parti de l’écosystème croissant d’outils compatibles avec les serveurs MCP
-
Normalisation : utilisez un protocole cohérent pris en charge par plusieurs assistants d’IA
-
Flexibilité : les serveurs MCP vous permettent de passer d’un fournisseur LLM à un autre tout en conservant les mêmes intégrations d’outils
-
Sécurité : conservez vos données au sein de votre infrastructure grâce aux serveurs MCP locaux
Architecture MCP
L’architecture MCP est une architecture client-serveur comprenant les éléments suivants :
-
Hôtes MCP : programmes tels que l’interface de ligne de commande d’Amazon Q Developer qui souhaitent accéder aux données via le serveur MCP
-
Clients MCP : clients du protocole qui maintiennent des connexions 1:1 avec les serveurs
-
Serveurs MCP : programmes légers qui présentent chacun des fonctionnalités spécifiques dans le cadre du protocole normalisé de contextualisation des modèles
-
Sources de données locales : fichiers, bases de données et services de votre ordinateur auxquels les serveurs MCP peuvent accéder en toute sécurité
-
Services à distance : systèmes externes disponibles sur Internet (par exemple, via des API) auxquels les serveurs MCP peuvent se connecter
Exemple Flux de communication d’un serveur MCP
User | v +------------------+ +-----------------+ +------------------+ | | | | | | | Amazon Q Dev | --> | MCP Client API | --> | MCP Server | | | | | | | +------------------+ +-----------------+ +------------------+ | v +------------------+ | | | External Service | | | +------------------+
Flux de communication entre l’utilisateur, l’interface de ligne de commande d’Amazon Q Developer et les services externes via un serveur MCP
Concepts de base des serveurs MCP
Outils
Les outils sont des fonctions exécutables que les serveurs MCP exposent aux clients. Grâce à Amazon Q, ils peuvent :
-
réaliser des actions sur des systèmes externes ;
-
traiter les données de manière spécialisée ;
-
interagir avec des API et des services ;
-
exécuter des commandes en votre nom.
Les outils sont définis avec un nom unique, une description, un schéma d’entrée (à l’aide d’un schéma JSON) et des annotations facultatives concernant leur comportement.
Invites
Les invites sont des modèles prédéfinis qui aident Amazon Q à exécuter des tâches spécifiques. Elles peuvent :
-
accepter des arguments dynamiques ;
-
inclure le contexte de ressources ;
-
enchaîner plusieurs interactions ;
-
guider des flux de travail spécifiques ;
-
apparaître sous forme d’éléments d’interface utilisateur (commandes slash, par exemple).
Ressources
Les ressources représentent les données que les serveurs MCP peuvent fournir à Amazon Q, par exemple :
-
Contenu de fichiers
-
Enregistrements de bases de données
-
Réponses API
-
Documentation
-
Données de configuration
