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 MCP avec Amazon Q Developer
Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants d'intelligence artificielle d'interagir avec des outils et services externes. Amazon Q Developer CLI prend désormais en charge le MCP, ce qui vous permet d'étendre les fonctionnalités de Q en le connectant à des outils et services personnalisés.
Rubriques
Chargement du serveur MCP
Amazon Q charge les serveurs MCP en arrière-plan, ce qui vous permet de commencer à interagir immédiatement sans attendre que tous les serveurs soient initialisés. Les outils deviennent disponibles au fur et à mesure que le chargement de leurs serveurs respectifs est terminé.
Vérification de l'état du serveur
Vous pouvez utiliser la /tools commande pour voir quels serveurs sont toujours en cours de chargement et quels outils sont déjà disponibles.
Configuration de l'initialisation du serveur
Vous pouvez personnaliser le délai d'initialisation du serveur 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 attendra l'initialisation des serveurs avant de vous permettre de commencer à interagir.
Outils et instructions
Cette section explique comment utiliser les outils et les instructions MCP avec Amazon Q Developer CLI.
Comprendre les outils MCP
Les outils MCP sont des fonctions exécutables que les serveurs MCP exposent à Amazon Q Developer CLI. 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 de MCP possède :
-
Nom : identifiant unique de l'outil
-
Description : description lisible par l'homme de ce que fait 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
Découvrir les outils disponibles
Pour voir quels outils sont disponibles dans votre session Q CLI :
/tools
Cette commande affiche tous les outils disponibles, y compris les outils intégrés et ceux fournis par les serveurs MCP.
Les outils peuvent avoir différents niveaux d'autorisation qui déterminent la manière dont ils sont utilisés :
-
Approuvé automatiquement : ces outils peuvent être utilisés sans autorisation explicite pour chaque invocation
-
Nécessite une approbation : ces outils nécessitent votre autorisation explicite chaque fois qu'ils sont utilisés
-
Dangereux : ces outils sont marqués comme potentiellement risqués et nécessitent un examen attentif avant d'être approuvés
Utiliser des outils
Vous pouvez utiliser les outils MCP de deux manières :
-
Demandes en langage naturel : Décrivez simplement ce que vous voulez faire, et Q déterminera l'outil à utiliser.
-
Invocation directe d'un outil : vous pouvez également demander explicitement à Q d'utiliser un outil spécifique.
Utilisation des instructions
Les serveurs MCP peuvent fournir des instructions prédéfinies qui aident à guider Q dans des tâches spécifiques :
-
Liste des invites disponibles :
/prompts -
Utilisez une invite :
-
@prompt-namearg1 arg2
-
Exemple d'utilisation d'une 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 MCP
-
Standardisation : utilisez un protocole cohérent soutenu par plusieurs assistants d'IA
-
Flexibilité : MCP vous permet de passer d'un fournisseur de 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
MCP suit une architecture client-serveur dans laquelle :
-
Hôtes MCP : programmes tels que Amazon Q Developer CLI qui souhaitent accéder aux données via MCP
-
Clients MCP : clients de protocole qui maintiennent des connexions 1:1 avec les serveurs
-
Serveurs MCP : programmes légers qui présentent chacun des fonctionnalités spécifiques grâce au protocole normalisé Model Context Protocol
-
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 MCP
User | v +------------------+ +-----------------+ +------------------+ | | | | | | | Amazon Q Dev | --> | MCP Client API | --> | MCP Server | | | | | | | +------------------+ +-----------------+ +------------------+ | v +------------------+ | | | External Service | | | +------------------+
Flux de communication entre l'utilisateur, la CLI Amazon Q Developer et les services externes via MCP
Concepts fondamentaux du MCP
Outils
Les outils sont des fonctions exécutables que les serveurs MCP exposent aux clients. Ils permettent à Amazon Q de :
-
Réaliser des actions dans des systèmes externes
-
Traitez les données de manière spécialisée
-
Interagissez avec APIs et offrez des services
-
Exécutez des commandes en votre nom
Les outils sont définis avec un nom unique, une description, un schéma d'entrée (à l'aide du schéma JSON) et des annotations facultatives concernant le comportement de l'outil.
Invites
Les invites sont des modèles prédéfinis qui aident Amazon Q à exécuter des tâches spécifiques. Il peut :
-
Accepter les arguments dynamiques
-
Inclure le contexte issu des ressources
-
Enchaînez plusieurs interactions
-
Guider des flux de travail spécifiques
-
Surface en tant qu'éléments de l'interface utilisateur (comme les commandes slash)
Ressources
Les ressources représentent les données que les serveurs MCP peuvent fournir à Amazon Q, telles que :
-
Contenu du fichier
-
enregistrements de base de données
-
Réponses API
-
Documentation
-
Données de configuration
