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](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#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.](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#tools-field)
## 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.).
1. Ouvrez le panneau Q Developer.
1. Ouvrez le panneau de **discussion**.
1. Cliquez sur l'icône des outils. 
## 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](#mcp-ide-configuration-access-ui).
1. Choisissez le symbole plus (\+).
1. 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.
1. Dans le champ **Nom**, entrez le nom du serveur MCP.
1. Sélectionnez `http` comme protocole de transport.
1. Dans le champ **URL**, entrez l'URL que le serveur MCP appellera lors de son initialisation.
1. 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.
1. Entrez une valeur de **délai d'expiration**, le cas échéant.
1. Choisissez **Enregistrer**.
Le panneau de configuration sera remplacé par le panneau des autorisations de l'outil.
1. Suivez la procédure ci-dessous[Révision et ajustement des autorisations des outils](#mcp-ide-configuration-review-adjust-tool).
**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](#mcp-ide-configuration-access-ui).
1. Choisissez le symbole plus (\+).
1. 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.
1. Dans le champ **Nom**, entrez le nom du serveur MCP.
Par exemple, si nous installions le [serveur de AWS documentation MCP](https://awslabs.github.io/mcp/servers/aws-documentation-mcp-server/), le nom pourrait être{{AWS DocMCPServer}}.
1. Sélectionnez `stdio` comme protocole de transport.
1. 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 est`uvx`. Il s'agit d'un alias pour`uv tool run`, qui crée un environnement Python éphémère.
1. 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 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.
1. 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](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/partitions.html) avec laquelle nous allons travailler.
1. 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).
1. Choisissez **Enregistrer**.
Le panneau de configuration sera remplacé par le panneau des autorisations de l'outil.
1. Suivez la procédure ci-dessous[Révision et ajustement des autorisations des outils](#mcp-ide-configuration-review-adjust-tool).
## 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.
1. À 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.
1. Choisissez le serveur que vous souhaitez désactiver.
1. Choisissez les trois points à côté de **Modifier la configuration**.
1. 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.
1. Choisissez le serveur que vous souhaitez supprimer.
Un panneau contenant des informations sur ce serveur s'ouvre.
1. Choisissez les trois points à côté de **Modifier la configuration**.
1. Choisissez **Supprimer le serveur MCP.**
1. 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.
1. À côté du serveur que vous souhaitez supprimer, choisissez **Supprimer**.
1. 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.
1. Choisissez le serveur MCP pour lequel vous souhaitez vérifier et ajuster les autorisations.
1. 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.