Configuration MCP pour Q Developer dans l'IDE - Amazon Q Developer
Avec l'IDEAjouter un serveur MCPRésolution des problèmes liés à la configuration de votre MCPActivation d'un serveur MCPDésactivation d'un serveur MCPSuppression d'un serveur MCP actuellement activéSuppression d'un serveur MCP actuellement désactivéRévision et ajustement des autorisations des outils

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 MCP pour Q Developer dans l'IDE

Cette page présente les options spécifiques à IDE pour configurer les serveurs MCP. Pour des informations générales sur la configuration MCP, voir Comprendre la configuration MCP.

Accès à l'interface utilisateur de configuration MCP

L'image suivante montre l'interface graphique utilisée pour configurer un serveur MCP pour Q Developer dans l'IDE.

Une interface graphique avec des champs pour les principaux éléments de configuration MCP.

Pour accéder à l'interface utilisateur de configuration MCP dans Q Developer dans l'IDE :

  1. Ouvrez votre IDE (VS Code JetBrains, etc.).

  2. Ouvrez le panneau Q Developer.

  3. Ouvrez le panneau de discussion.

  4. Cliquez sur l'icône des outils. tools icon

Ajouter un serveur MCP

Pour ajouter un serveur MCP à l'IDE :

  1. Accédez à l'interface utilisateur de configuration MCP.

  2. Choisissez le symbole plus (+).

  3. Sélectionnez l'étendue : globale ou locale.

    Si vous sélectionnez une portée globale, la configuration du serveur MCP est stockée dans ~/. aws/amazonq/mcp.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/mcp.json dans votre projet actuel.

  4. Dans le champ Nom, entrez le nom du serveur MCP.

    Par exemple, si nous installions le serveur de AWS documentation MCP, le nom pourrait êtreAWS DocMCPServer.

  5. Sélectionnez le protocole de transport.

    Actuellement, seul stdio est pris en charge.

  6. Dans le champ Commande, entrez la commande shell que le serveur MCP exécutera lors de son initialisation.

    Dans le cas du serveur MCP de AWS documentation, la commande estuvx. Il s'agit d'un alias pouruv tool run, qui crée un environnement Python éphémère.

  7. Dans le champ Arguments, entrez un argument à attribuer à la commande shell, le cas échéant.

    Dans le cas du serveur MCP de AWS documentation, l'argument estawslabs.aws-documentation-mcp-server@latest. Il s'agit d'un identifiant de package Python qui pointe vers un package hébergé sur PyPI (Python Package Index).

    Ajoutez d'autres arguments si nécessaire.

  8. Renseignez les variables d'environnement, le cas échéant.

    Dans le cas de notre exemple, nous remplissons d'abord le nom : FASTMCP_LOG_LEVEL et la valeur :ERROR.

    Nous utiliserons également le nom AWS_DOCUMENTATION_PARTITION et la valeur aws pour indiquer la partition avec laquelle nous allons travailler.

  9. Entrez une valeur de délai d'expiration, le cas échéant.

    Dans notre exemple, nous allons conserver la valeur recommandée de 60 (secondes).

  10. Choisissez Enregistrer.

    Le panneau de configuration sera remplacé par le panneau des autorisations de l'outil.

  11. Suivez la procédure ci-dessousRévision et ajustement des autorisations des outils.

Résolution des problèmes liés à la configuration de votre MCP

Après avoir ajouté un serveur MCP dans l'IDE, Amazon Q tente de s'y connecter.

En cas de problème de connexion, une alerte s'affiche en haut du panneau. Vous ne devez pas vous attendre à ce que les outils de ce serveur MCP fonctionnent correctement tant que l'alerte n'est pas résolue.

Choisissez Corriger la configuration pour revenir à l'écran de configuration du MCP afin de pouvoir apporter les modifications appropriées.

Activation d'un serveur MCP

La procédure suivante suppose que le serveur MCP en question n'est pas déjà activé.

Pour activer un serveur MCP dans l'IDE :

  1. Ouvrez le panneau Serveurs MCP.

  2. À côté du serveur que vous souhaitez activer, sélectionnez Activer.

Désactivation d'un serveur MCP

Pour désactiver un serveur MCP dans l'IDE :

  1. Ouvrez le panneau Serveurs MCP.

  2. Choisissez le serveur que vous souhaitez désactiver.

  3. Choisissez les trois points à côté de Modifier la configuration.

  4. Choisissez Désactiver le serveur MCP.

Suppression d'un serveur MCP actuellement activé

Pour supprimer un serveur MCP actuellement activé depuis l'IDE, procédez comme suit :

  1. Ouvrez le panneau Serveurs MCP.

  2. Choisissez le serveur que vous souhaitez supprimer.

    Un panneau contenant des informations détaillées sur ce serveur s'ouvre.

  3. Choisissez les trois points à côté de Modifier la configuration.

  4. Choisissez Supprimer le serveur MCP.

  5. Confirmez la suppression lorsque vous y êtes invité.

Suppression d'un serveur MCP actuellement désactivé

Pour supprimer un serveur MCP actuellement désactivé dans l'IDE, procédez comme suit :

  1. Ouvrez le panneau Serveurs MCP.

  2. À côté du serveur que vous souhaitez supprimer, choisissez Supprimer.

  3. Confirmez la suppression lorsque vous y êtes invité.

Révision et ajustement des autorisations des outils

Pour vérifier et ajuster les autorisations des outils, procédez comme suit :

  1. Ouvrez le panneau Serveurs MCP.

  2. Choisissez le serveur MCP pour lequel vous souhaitez vérifier et ajuster les autorisations.

  3. Pour chaque outil, vous pouvez définir l'un des niveaux d'autorisation suivants :

    • Demander : demandez l'autorisation chaque fois que l'outil est utilisé.

    • Toujours autoriser : autorisez l'exécution de l'outil sans qu'il soit nécessaire de le demander.

    • Refuser : n'utilisez pas cet outil.

  4. Choisissez Enregistrer ou Appliquer pour mettre à jour les paramètres d'autorisation.