Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
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.
Configuration de serveurs MCP
Configuration de serveurs MCP à l’aide de l’interface de ligne de commande d’Amazon Q
La configuration MCP définie globalement pour Amazon Q CLI est gérée à l'adresse suivante :
~/.aws/amazonq/cli-agents
La CLI Amazon Q Developer prend en charge à la fois les serveurs MCP locaux (qui s'exécutent en tant que processus) et les serveurs MCP distants (qui communiquent via HTTP). Les serveurs distants peuvent utiliser OAuth l'authentification ou être ouverts sans qu'aucune authentification ne soit requise.
Pour plus d'informations, consultez le guide de configuration de l'agent personnalisé sur le référentiel Github de la CLI Q et.
Configuration de serveurs MCP avec Amazon Q dans l’IDE
La configuration MCP définie globalement pour Amazon Q dans l'IDE est gérée à l'adresse suivante :
~/.aws/amazonq/agents/default.json
Pour de plus amples informations, veuillez consulter Configuration MCP pour 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 APIs) 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 ;
-
Interagissez avec APIs et offrez 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.
Invitations
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
