Configurazione MCP per Q Developer nell’IDE - Amazon Q Developer
File di configurazione MCP IDEAccesso all'interfaccia utenteAggiungi un server MCPRisoluzione dei problemi di configurazione MCPAbilitazione di un server MCPAbilitazione 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.

Comprensione dei file di configurazione MCP per Q Developer nell'IDE

Quando si utilizza la GUI per aggiungere un server MCP a Q Developer nell'IDE, la configurazione viene memorizzata in uno dei due file:

  • A livello globale: ~/. aws/amazonq/default.json

  • Nell'ambito locale: .amazonq/default.json

Tuttavia, per motivi preesistenti, è anche possibile inserire le informazioni di configurazione MCP in altre due posizioni:

  • A livello globale: ~/. aws/amazonq/mcp.json

  • A livello locale: .amazonq/mcp.json

Q Developer dà la precedenza alle configurazioni a livello di area di lavoro per i server MCP, alle relative autorizzazioni e alle impostazioni memorizzate.

Nota

Se hai già impostato una configurazione MCP in un file mcp.json e stai utilizzando la GUI di configurazione MCP per la prima volta, vedrai quella configurazione nella GUI.

Il supporto per i file mcp.json legacy è abilitato dal campo useLegacyMcp Json nel file di configurazione globale default.json. Per impostazione predefinita, questo campo è impostato su true. Per ulteriori informazioni, consulta UseLegacyMcpJson Field nel repository Q Developer CLI GitHub .

Nota che i file mcp.json possono essere utilizzati anche dalla CLI Q.

Per informazioni su come impostare i controlli granulari sugli strumenti MCP, consultate il riferimento agli strumenti integrati.

Accesso all’interfaccia utente di 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

Aggiungi un server MCP

Sono disponibili due meccanismi di trasporto principali per la comunicazione tra client IA e server MCP: STDIO e HTTP.

Aggiungi un server MCP HTTP

Per aggiungere un server MCP HTTP all’IDE:

  1. Accedi all’interfaccia utente della configurazione di MCP.

  2. Scegli 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/default.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/default.json all'interno del tuo progetto attuale.

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

  5. Seleziona http come protocollo di trasporto.

  6. Nel campo URL, immetti l’URL che il server MCP chiamerà al momento dell’inizializzazione.

  7. In Intestazioni - facoltativo, puoi inserire coppie chiave-valore che devono essere inviate come intestazioni di richiesta HTTP.

  8. Inserisci un valore di timeout, se applicabile.

  9. Scegli Save (Salva).

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

  10. Segui la procedura riportata in Revisione e regolazione delle autorizzazioni dello strumento.

Nota

Se l’endpoint HTTP MCP richiede l’autorizzazione, Amazon Q aprirà automaticamente una pagina del browser in modo da poter autorizzare Amazon Q ad accedere al server MCP.

Aggiungere un server MCP

Per aggiungere un server MCP STDIO all’IDE:

  1. Accedi all’interfaccia utente della configurazione di MCP.

  2. Scegli 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/default.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/default.json all'interno del tuo progetto attuale.

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

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

  5. Seleziona stdio come protocollo di trasporto.

  6. Nel campo Comando, immetti 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 per uv tool run, che crea un ambiente Python effimero.

  7. Nel campo Argomenti, 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 in hosting su PyPI (Python Package Index).

    Aggiungi altri argomenti se necessario.

  8. Compila le variabili di ambiente, se applicabile.

    Nel caso del nostro esempio, inseriamo innanzitutto 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 riportata in Revisione e regolazione delle autorizzazioni dello strumento.

Risoluzione dei problemi di 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.

Scegli Correggi configurazione 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. Apri il pannello Server MCP.

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

Abilitazione di un server MCP

Per disabilitare un server MCP nell’IDE:

  1. Apri il pannello Server MCP.

  2. Scegli l’utente che desideri 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. Apri il pannello Server MCP.

  2. Scegli le chiavi che desideri 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. Apri il pannello Server MCP.

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

  3. Conferma l’eliminazione quando richiesto.

Revisione e regolazione delle autorizzazioni dello strumento

Per revisionare e regolare le autorizzazioni dello strumento:

  1. Apri il pannello Server MCP.

  2. Scegli il server MCP per il quale desideri 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 eseguire senza chiedere conferma.

    • Nega: non utilizzare questo strumento.