Configuration des serveurs MCP d’Amazon Q Developer dans l’IDE - Amazon Q Developer
Avec l’IDEAjout d’un serveur MCPRésolution des problèmes de configuration des serveurs MCPActivation d’un serveur MCPDésactivation d’un serveur MCPSuppression d’un serveur MCP activéSuppression d’un serveur MCP désactivéVérification et ajustement des autorisations des outils

Configuration des serveurs MCP d’Amazon Q Developer dans l’IDE

Cette page présente les options de configuration de serveurs MCP spécifiques à l’IDE.

Accès à l’interface utilisateur de configuration des serveurs MCP

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

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

  2. Ouvrez le volet Q Developer.

  3. Ouvrez le volet Chat.

  4. Choisissez l’icône Outils tools icon .

Ajout d’un serveur MCP

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

Ajout d’un serveur MCP HTTP

Pour ajouter un serveur MCP HTTP à l’IDE :

  1. Accédez à l’interface utilisateur de configuration des serveurs MCP.

  2. Choisissez le symbole plus (+).

  3. Sélectionnez la portée : globale ou locale.

    Si vous sélectionnez une portée globale, la configuration du serveur MCP est stockée dans le fichier ~/.aws/amazonq/agents/default.json et disponible pour tous vos projets. Si vous sélectionnez une portée locale, la configuration est stockée dans le fichier .aws/amazonq/agents/default.json de votre projet en cours.

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

  5. Sélectionnez http comme protocole de transport.

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

  7. Sous En-têtes - facultatif, vous pouvez saisir des paires clé-valeur à envoyer sous forme d’en-têtes de demande HTTP.

  8. Saisissez un délai d’expiration, le cas échéant.

  9. Choisissez Enregistrer.

    Le volet de configuration est remplacé par le volet d’autorisation des outils.

  10. Suivez la procédure décrite sous Vérification et ajustement des autorisations des outils.

Note

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

Ajout d’un serveur MCP STDIO

Pour ajouter un serveur MCP STDIO à l’IDE :

  1. Accédez à l’interface utilisateur de configuration des serveurs MCP.

  2. Choisissez le symbole plus (+).

  3. Sélectionnez la portée : globale ou locale.

    Si vous sélectionnez une portée globale, la configuration du serveur MCP est stockée dans le fichier ~/.aws/amazonq/mcp.json et disponible pour tous vos projets. Si vous sélectionnez une portée locale, la configuration est stockée dans le fichier .amazonq/mcp.json de votre projet en cours.

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

    Par exemple, si nous installions le serveur MCP AWS Documentation, le nom pourrait être AWSDocMCPServer.

  5. Sélectionnez stdio comme protocole de transport.

  6. Dans le champ Commande, saisissez la commande shell que le serveur MCP appellera lors de son initialisation.

    Dans le cas du serveur MCP AWS Documentation, la commande est uvx. Il s’agit d’un alias pour uv tool run, qui crée un environnement Python éphémère.

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

    Dans le cas du serveur MCP AWS Documentation, l’argument est awslabs.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 renseignons d’abord le nom : FASTMCP_LOG_LEVEL et la valeur : ERROR.

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

  9. Saisissez un 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 volet de configuration est remplacé par le volet d’autorisation des outils.

  11. Suivez la procédure décrite sous Vérification et ajustement des autorisations des outils.

Résolution des problèmes de configuration des serveurs MCP

Une fois que vous avez 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 volet. Les outils de ce serveur MCP ne fonctionneront pas correctement tant que l’alerte ne sera pas résolue.

Choisissez Corriger la configuration pour revenir à l’écran de configuration du serveur MCP et apporter les modifications appropriées.

Activation d’un serveur MCP

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

Pour activer un serveur MCP dans l’IDE :

  1. Ouvrez le volet Serveurs MCP.

  2. Sélectionnez Activer en regard du serveur que vous souhaitez activer.

Désactivation d’un serveur MCP

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

  1. Ouvrez le volet Serveurs MCP.

  2. Sélectionnez le serveur que vous souhaitez désactiver.

  3. Sélectionnez les trois points en regard de Modifier la configuration.

  4. Choisissez Désactiver le serveur MCP.

Suppression d’un serveur MCP activé

Pour supprimer un serveur MCP activé depuis l’IDE :

  1. Ouvrez le volet Serveurs MCP.

  2. Choisissez le serveur que vous souhaitez supprimer.

    Un volet contenant des informations sur ce serveur s’ouvre.

  3. Sélectionnez les trois points en regard de Modifier la configuration.

  4. Choisissez Supprimer le serveur MCP.

  5. Lorsque vous y êtes invité, confirmez la suppression.

Suppression d’un serveur MCP désactivé

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

  1. Ouvrez le volet Serveurs MCP.

  2. Sélectionnez Supprimer en regard du serveur que vous souhaitez supprimer.

  3. Lorsque vous y êtes invité, confirmez la suppression.

Vérification et ajustement des autorisations des outils

Pour vérifier et ajuster les autorisations des outils :

  1. Ouvrez le volet Serveurs MCP.

  2. Sélectionnez le serveur MCP dont vous souhaitez vérifier et ajuster les autorisations.

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

    • Demander : demander systématiquement l’autorisation d’utiliser l’outil.

    • Toujours autoriser : autoriser l’exécution de l’outil sans demander de confirmation.

    • Refuser : ne pas utiliser cet outil.