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: \$1/. 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: \$1/. 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](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#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.](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#tools-field) ## 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.). 1. Apri il pannello Q Developer. 1. Apri il pannello **Chat**. 1. Scegli l’icona degli strumenti. ![\[tools icon\]](http://docs.aws.amazon.com/it_it/amazonq/latest/qdeveloper-ug/images/tools-icon-full.png) ## 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](#mcp-ide-configuration-access-ui). 1. Scegli il simbolo più (\$1). 1. Seleziona l’ambito: globale o locale. Se si seleziona l'ambito globale, la configurazione del server MCP viene memorizzata in \$1/. 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. 1. Nel campo **Nome**, immetti il nome del server MCP. 1. Seleziona `http` come protocollo di trasporto. 1. Nel campo **URL**, immetti l’URL che il server MCP chiamerà al momento dell’inizializzazione. 1. In **Intestazioni - facoltativo**, puoi inserire coppie chiave-valore che devono essere inviate come intestazioni di richiesta HTTP. 1. Inserisci un valore di **timeout**, se applicabile. 1. Scegli **Save** (Salva). Il pannello di configurazione verrà sostituito dal pannello delle autorizzazioni dello strumento. 1. Segui la procedura riportata in [Revisione e regolazione delle autorizzazioni dello strumento](#mcp-ide-configuration-review-adjust-tool). **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](#mcp-ide-configuration-access-ui). 1. Scegli il simbolo più (\$1). 1. Seleziona l’ambito: globale o locale. Se si seleziona l'ambito globale, la configurazione del server MCP viene memorizzata in \$1/. 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. 1. Nel campo **Nome**, immetti il nome del server MCP. Ad esempio, se stessimo installando il [server AWS Documentation MCP](https://awslabs.github.io/mcp/servers/aws-documentation-mcp-server/), il nome potrebbe essere. *AWS DocMCPServer* 1. Seleziona `stdio` come protocollo di trasporto. 1. 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. 1. 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. 1. Compila le variabili di ambiente, se applicabile. Nel caso del nostro esempio, inseriamo innanzitutto Nome: *FASTMCP\$1LOG\$1LEVEL* e Valore:*ERROR*. Useremo anche il nome *AWS\$1DOCUMENTATION\$1PARTITION* e il valore *aws* per indicare la [partizione](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/partitions.html) con cui lavoreremo. 1. Inserisci un valore di **timeout**, se applicabile. Per il nostro esempio, manterremo il valore consigliato di 60 (secondi). 1. Scegli **Save** (Salva). Il pannello di configurazione verrà sostituito dal pannello delle autorizzazioni dello strumento. 1. Segui la procedura riportata in [Revisione e regolazione delle autorizzazioni dello strumento](#mcp-ide-configuration-review-adjust-tool). ## 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. 1. 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. 1. Scegli l’utente che desideri disabilitare. 1. Scegli i tre puntini accanto a **Modifica configurazione**. 1. 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. 1. Scegli le chiavi che desideri eliminare. Si aprirà un pannello con i dettagli su quel server. 1. Scegli i tre puntini accanto a **Modifica configurazione**. 1. Scegli **Elimina server MCP**. 1. 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. 1. Accanto al server che desideri eliminare, scegli **Elimina**. 1. 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. 1. Scegli il server MCP per il quale desideri rivedere e modificare le autorizzazioni. 1. 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.