Configurazione MCP per Q Developer nell'IDE - Amazon Q Developer
Con l'IDEAggiungere un server MCPRisoluzione dei problemi relativi alla configurazione MCPAbilitazione di un server MCPDisabilitazione di un server MCPEliminazione di un server MCP attualmente abilitatoEliminazione di un server MCP attualmente disabilitatoRevisione e regolazione delle autorizzazioni dello strumento

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurazione MCP per Q Developer nell'IDE

Questa pagina descrive le opzioni specifiche dell'IDE per la configurazione dei server MCP. Per informazioni generali sulla configurazione MCP, vedere Comprendere la configurazione MCP.

Accesso all'interfaccia utente di configurazione MCP

L'immagine seguente mostra la GUI utilizzata per configurare un server MCP per Q Developer nell'IDE.

Una GUI con campi per gli elementi principali della configurazione MCP.

Per accedere all'interfaccia utente di configurazione MCP in Q Developer nell'IDE:

  1. Apri il tuo IDE (VS Code JetBrains, ecc.).

  2. Apri il pannello Q Developer.

  3. Apri il pannello Chat.

  4. Scegli l'icona degli strumenti. tools icon

Aggiungere un server MCP

Per aggiungere un server MCP all'IDE:

  1. Accedere all'interfaccia utente di configurazione MCP.

  2. Scegliete il simbolo più (+).

  3. Seleziona l'ambito: globale o locale.

    Se si seleziona l'ambito globale, la configurazione del server MCP viene memorizzata in ~/. aws/amazonq/mcp.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/mcp.json all'interno del tuo progetto attuale.

  4. Nel campo Nome, inserisci il nome del server MCP.

    Ad esempio, se stessimo installando il server AWS Documentation MCP, il nome potrebbe essere. AWS DocMCPServer

  5. Seleziona il protocollo di trasporto.

    Attualmente è supportato solo stdio.

  6. Nel campo Comando, immettete il comando shell che il server MCP eseguirà al momento dell'inizializzazione.

    Nel caso del AWS Documentation MCP Server, il comando è. uvx Questo è un alias peruv tool run, che crea un ambiente Python effimero.

  7. Nel campo Arguments, inserisci un argomento da assegnare al comando della shell, se applicabile.

    Nel caso del AWS Documentation MCP Server, l'argomento èawslabs.aws-documentation-mcp-server@latest. Questo è un identificatore di pacchetto Python che punta a un pacchetto ospitato su PyPI (Python Package Index).

    Aggiungi altri argomenti se necessario.

  8. Compila le variabili di ambiente, se applicabile.

    Nel caso del nostro esempio, inseriamo prima Nome: FASTMCP_LOG_LEVEL e Valore:ERROR.

    Useremo anche il nome AWS_DOCUMENTATION_PARTITION e il valore aws per indicare la partizione con cui lavoreremo.

  9. Inserisci un valore di Timeout, se applicabile.

    Per il nostro esempio, manterremo il valore consigliato di 60 (secondi).

  10. Scegli Save (Salva).

    Il pannello di configurazione verrà sostituito dal pannello delle autorizzazioni dello strumento.

  11. Segui la procedura Revisione e regolazione delle autorizzazioni dello strumento riportata di seguito.

Risoluzione dei problemi relativi alla configurazione MCP

Dopo aver aggiunto un server MCP nell'IDE, Amazon Q tenterà di connettersi ad esso.

In caso di problemi di connessione, verrà visualizzato un avviso nella parte superiore del pannello. Non dovresti aspettarti che gli strumenti di quel server MCP funzionino correttamente finché l'avviso non viene risolto.

Scegliete Fix Configuration per tornare alla schermata di configurazione MCP in modo da poter apportare le modifiche appropriate.

Abilitazione di un server MCP

La procedura seguente presuppone che il server MCP in questione non sia già abilitato.

Per abilitare un server MCP nell'IDE:

  1. Aprite il pannello MCP Servers.

  2. Accanto al server che desideri abilitare, scegli Abilita.

Disabilitazione di un server MCP

Per disabilitare un server MCP nell'IDE:

  1. Aprite il pannello MCP Servers.

  2. Scegliete il server che desiderate disabilitare.

  3. Scegli i tre puntini accanto a Modifica configurazione.

  4. Scegli Disabilita server MCP.

Eliminazione di un server MCP attualmente abilitato

Per eliminare un server MCP attualmente abilitato dall'IDE:

  1. Aprite il pannello MCP Servers.

  2. Scegliete il server che desiderate eliminare.

    Si aprirà un pannello con i dettagli su quel server.

  3. Scegli i tre puntini accanto a Modifica configurazione.

  4. Scegli Elimina server MCP.

  5. Conferma l'eliminazione quando richiesto.

Eliminazione di un server MCP attualmente disabilitato

Per eliminare un server MCP attualmente disabilitato dall'IDE:

  1. Aprite il pannello MCP Servers.

  2. Accanto al server che desideri eliminare, scegli Elimina.

  3. Conferma l'eliminazione quando richiesto.

Revisione e regolazione delle autorizzazioni dello strumento

Per rivedere e modificare le autorizzazioni dello strumento:

  1. Aprire il pannello MCP Servers.

  2. Scegliete il server MCP per il quale desiderate rivedere e modificare le autorizzazioni.

  3. Per ogni strumento, puoi impostare uno dei seguenti livelli di autorizzazione:

    • Chiedi: richiedi l'autorizzazione ogni volta che lo strumento viene utilizzato.

    • Consenti sempre: consenti allo strumento di funzionare senza chiedere conferma.

    • Nega: non utilizzare questo strumento.

  4. Scegli Salva o Applica per aggiornare le impostazioni delle autorizzazioni.