View a markdown version of this page

Configuration MCP pour Q Developer dans l'IDE - Amazon Q Developer
Fichiers de configuration MCP IDEAccès à l'interface utilisateurAjouter un serveur MCPRésolution des problèmes de configuration de votre MCPActivation d'un serveur MCPDésactivation d'un serveur MCPSupprimer un serveur MCP actuellement activéSupprimer 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 IDE-specific options de configuration des serveurs MCP.

Comprendre les fichiers de configuration MCP pour Q Developer dans l'IDE

Lorsque vous utilisez l'interface graphique pour ajouter un serveur MCP à Q Developer dans l'IDE, la configuration est stockée dans l'un des deux fichiers suivants :

  • À l'échelle mondiale : ~/. aws/amazonq/default.json

  • À l'échelle locale :. amazonq/default.json

Toutefois, pour des raisons liées à l'héritage, il est également possible de placer les informations de configuration MCP à deux autres emplacements :

  • À l'échelle mondiale : ~/. aws/amazonq/mcp.json

  • À l'échelle locale :. amazonq/mcp.json

Q Developer donne la priorité aux configurations au niveau de l'espace de travail pour les serveurs MCP, à leurs autorisations et aux paramètres stockés.

Note

Si vous avez déjà configuré une configuration MCP dans un fichier mcp.json et que vous utilisez l'interface graphique de configuration MCP pour la première fois, vous verrez cette configuration dans l'interface graphique.

Support pour les anciens fichiers mcp.json est activé par le LegacyMcpJson champ use de votre fichier de configuration global default.json. Par défaut, ce champ est défini sur true. Pour plus d'informations, consultez UseLegacyMcpJson Field dans le GitHub référentiel Q Developer CLI.

Notez que les fichiers mcp.json peuvent également être utilisés par la Q CLI.

Pour plus d'informations sur la façon de définir des commandes granulaires sur les outils MCP, consultez la Built-in référence des outils.

Accès à l'interface utilisateur 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

Il existe deux principaux mécanismes de transport pour la communication entre les clients AI et les serveurs MCP : STDIO et HTTP.

Ajouter un serveur HTTP MCP

Pour ajouter un serveur HTTP 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/default.json et disponible dans tous vos projets. Si vous sélectionnez une portée locale, la configuration est stockée dans. amazonq/default.json dans votre projet actuel.

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

  5. Sélectionnez http comme protocole de transport.

  6. Dans le champ URL, entrez l'URL que le serveur MCP appellera lors de son initialisation.

  7. Sous En-têtes - facultatif, vous pouvez saisir des paires clé-valeur qui doivent être envoyées sous forme d'en-têtes de requête HTTP.

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

  9. Choisissez Enregistrer.

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

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

Note

Si le point de terminaison HTTP MCP nécessite une autorisation, Amazon Q ouvre automatiquement une page de navigateur afin que vous puissiez autoriser Amazon Q à accéder au serveur MCP.

Ajouter un serveur STDIO MCP

Pour ajouter un serveur MCP STDIO à 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/default.json et disponible dans tous vos projets. Si vous sélectionnez une portée locale, la configuration est stockée dans. amazonq/default.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 stdio comme protocole de transport.

  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 de 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.

Supprimer 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 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é.

Supprimer 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 demande.

    • Refuser : n'utilisez pas cet outil.