Configuration de serveurs MCP dans l’interface de ligne de commande - Amazon Q Developer

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.

Configuration de serveurs MCP dans l’interface de ligne de commande

Cette page décrit les options de configuration des serveurs MCP spécifiques à l’interface de ligne de commande.

Commandes de configuration

Utilisation : qchat mcp [OPTIONS] COMMAND

Commandes de configuration des serveurs MCP
Commande Description
qchat mcp add Ajouter ou remplacer un serveur configuré
qchat mcp remove Supprimer un serveur de la configuration MCP
qchat mcp list Répertorier les serveurs configurés
qchat mcp import Importer une configuration de serveur d’un autre fichier
qchat mcp status Obtenir le statut d’un serveur configuré
qchat mcp help Imprimer cette liste de commandes ou obtenir de l’aide pour la ou les sous-commandes indiquées

Arguments du serveur MCP

Le --args paramètre prend désormais en charge les arguments contenant des virgules utilisant le format d'échappement ou le format de tableau JSON :

# Escaped commas
q mcp add --name server --command cmd --args "arg1,arg2\,with\,commas,arg3"

# JSON array format  
q mcp add --name server --command cmd --args '["arg1", "arg2,with,commas", "arg3"]'

Serveurs MCP distants

Outre les serveurs MCP locaux qui s'exécutent en tant que processus, la CLI Amazon Q Developer prend en charge les serveurs MCP distants qui communiquent via HTTP. Les serveurs distants peuvent utiliser OAuth l'authentification ou être ouverts (aucune authentification n'est requise).

Configuration

Les serveurs MCP distants sont configurés dans le fichier de configuration de votre agent à l'aide des url champs type et :

{ "mcpServers": { "find-a-domain": { "type": "http", "url": "https://api.findadomain.dev/mcp" } } }

OAuth flux d'authentification

Lorsque vous utilisez des serveurs MCP distants qui nécessitent une OAuth authentification :

  1. Démarrez votre session Q CLI avec un agent incluant le serveur MCP distant

  2. Le serveur s'affichera initialement comme « pas encore chargé »

  3. Utilisez la /mcp commande pour commencer l'authentification

  4. Une CLI indiquera que le serveur nécessite une authentification et fournira une URL

  5. Ouvrez l'URL fournie dans votre navigateur tout en gardant la session Q CLI ouverte

  6. Suivez les instructions d'authentification de votre navigateur

  7. Retournez à la fenêtre Q CLI : vous serez connecté au serveur MCP si l'authentification est réussie

Les outils du serveur seront disponibles une fois l'authentification terminée.