Configurazione dei server MCP

L'applicazione desktop Amazon Quick supporta il Model Context Protocol (MCP), uno standard aperto che estende le funzionalità di Quick con strumenti e integrazioni personalizzati. Puoi connettere server MCP per fornire un accesso rapido a database, API interne, strumenti di sviluppo e altri sistemi che non sono disponibili tramite connessioni integrate.

Che cos'è MCP?

Model Context Protocol (MCP) è un protocollo che consente agli assistenti AI di interagire con strumenti e fonti di dati esterne. Quando connetti un server MCP a Quick, gli strumenti forniti da quel server diventano disponibili nelle conversazioni in chat e negli agenti pianificati. Ad esempio, è possibile connettere un server MCP che fornisce strumenti di interrogazione del database e quindi chiedere a Quick di interrogare il database direttamente in chat.

Accesso alle impostazioni MCP

Per gestire i server MCP, apri Impostazioni nella barra laterale, scegli Funzionalità, quindi scegli la scheda MCP.

La scheda MCP mostra i server connessi con una barra di ricerca, un menu a discesa dei filtri e un interruttore di visualizzazione a griglia o elenco. Puoi aggiungere nuovi server selezionando + Aggiungi MCP.

Aggiungi un server MCP

Quando si sceglie + Aggiungi MCP, viene visualizzata una finestra di dialogo con tre tipi di connessione: locale, di importazione e remota. Scegliete il tipo di connessione che corrisponde al funzionamento del server MCP.

Locale

Utilizzate il tipo di connessione locale per eseguire un server MCP come comando sul computer. Questa è l'opzione più comune per gli strumenti di sviluppo e i server installati localmente.

La tabella seguente descrive i campi per una connessione MCP locale.

Campo	Richiesto	Description
Nome	Sì	Un nome descrittivo per identificare questo server MCP (ad esempio, «My Database MCP»).
Comando	Sì	L'eseguibile da eseguire. I valori comuni includono pythonnpx,node, euvx.
Arguments (Argomenti)	No	Argomenti della riga di comando, separati da spazi (ad esempio,-m mcp_server --port 8080).
Descrizione	No	Una descrizione di ciò che fa questo server MCP e degli strumenti che fornisce. Questo aiuta Quick a capire quando utilizzare gli strumenti del server.
Variabili di ambiente	No	Variabili di ambiente richieste dal server. Scegliete + Aggiungi variabile per aggiungere coppie chiave-valore.
Timeout (secondi)	No	Tempo massimo di attesa per l'avvio del server, compreso tra 5 e 300 secondi. Il valore predefinito è 30 secondi.

Per aggiungere un server MCP locale

Attenersi alla seguente procedura:

1. Apri Impostazioni nella barra laterale e scegli Funzionalità.

2. Scegli la scheda MCP.

3. Scegli + Aggiungi MCP.

4. Scegli Local come tipo di connessione.

5. Immettete un nome e il comando da eseguire (ad esempio,python).

6. Immettete tutti gli argomenti richiesti dal comando (ad esempio,-m my_mcp_server).

7. Scegliete + Aggiungi MCP per salvare.

Importa

Utilizzate il tipo di connessione di importazione per caricare le configurazioni del server MCP da un file di configurazione esistente. Ciò è utile quando i server MCP sono già configurati per altri strumenti e si desidera riutilizzare tale configurazione in Quick.

Quick supporta i file di configurazione dei seguenti strumenti.

• Kiro

• Codice Claude

• SCOPO

• antigravità

• QuickWork esportazioni

La tabella seguente descrive i campi per una connessione di importazione MCP.

Campo	Richiesto	Description
Percorso del file di configurazione	Sì	Il percorso del file di configurazione sul computer (ad esempio,~/.kiro/settings/mcp.json).

Quando si immette il percorso di un file di configurazione, Quick esegue automaticamente la scansione del file e rileva i server MCP in esso definiti. Quick rileva anche gli strumenti installati sul sistema e li visualizza come chip (ad esempio, «Kiro», «AIM», «Claude Code») in Rilevati su questo sistema.

Per importare server MCP da un file di configurazione

Attenersi alla seguente procedura:

1. Apri Impostazioni nella barra laterale e scegli Funzionalità.

2. Scegli la scheda MCP.

3. Scegli + Aggiungi MCP.

4. Scegli Importa come tipo di connessione.

5. Immettete il percorso del file Config del file di configurazione MCP esistente.

6. Esamina i server e gli strumenti di sistema rilevati.

7. Scegli Carica file per importare i server.

Remoto

Utilizzate il tipo di connessione remota per connettervi a un server MCP in esecuzione su una macchina remota o un servizio cloud tramite HTTP. Questo è utile per server di team condivisi o servizi MCP ospitati.

La tabella seguente descrive i campi per una connessione MCP remota.

Campo	Richiesto	Description
Nome	Sì	Un nome descrittivo per identificare questo server MCP.
URL	Sì	L'URL dell'endpoint MCP (ad esempio,). https://mcp.example.com/sse
Token	No	Un token portante per l'autenticazione con il server remoto.
Descrizione	No	Una descrizione di ciò che fa questo server MCP e degli strumenti che fornisce.
Timeout (secondi)	No	Tempo massimo di attesa della risposta del server, compreso tra 5 e 300 secondi. Il valore predefinito è 30 secondi.

Per aggiungere un server MCP remoto

Attenersi alla seguente procedura:

1. Apri Impostazioni nella barra laterale e scegli Funzionalità.

2. Scegli la scheda MCP.

3. Scegli + Aggiungi MCP.

4. Scegli Remote come tipo di connessione.

5. Immettete un nome e l'URL dell'endpoint MCP.

6. (Facoltativo) Inserite un token se il server richiede l'autenticazione.

7. Scegli + Aggiungi MCP per salvare.

Gestione dei server MCP

Dopo aver aggiunto i server MCP, questi vengono visualizzati nella scheda MCP. È possibile gestire i server utilizzando le seguenti funzionalità.

• Cerca: utilizza la barra di ricerca per trovare i server per nome.

• Filtro: utilizza il filtro a discesa per mostrare tutti i server o filtra per stato.

• Attiva/disattiva la visualizzazione della visualizzazione: passa dalla visualizzazione a griglia alla visualizzazione a elenco.

• Attiva o disattiva i singoli server MCP senza rimuoverli.

• Modifica: modifica la configurazione del server.

• Rimuovi: elimina una connessione al server.

Agenti di codifica

La scheda MCP include anche una sezione Agenti di codifica sotto i server MCP. Gli agenti di codifica utilizzano l'Agent Client Protocol (ACP) per delegare le attività di codifica ad agenti di codifica locali come Kiro o Claude Code.

Per aggiungere un agente di codifica

Attenersi alla seguente procedura:

1. Apri Impostazioni nella barra laterale e scegli Funzionalità.

2. Scegli la scheda MCP.

3. Nella sezione Agenti di codifica, scegli + Aggiungi agente.

4. Configura le impostazioni di connessione dell'agente.

5. Salvare la configurazione.

Dopo aver configurato un agente di codifica, puoi delegargli delle attività dalla chat. Ad esempio, puoi dire «usa Kiro per rifattorizzare questo modulo» o «chiedi a Claude Code di scrivere test per questa funzione». Quick invia il lavoro all'agente di codifica e ti riporta i risultati.

Utilizzo degli strumenti MCP negli agenti pianificati

È possibile collegare i server MCP agli agenti pianificati come funzionalità. Quando si crea o si modifica un agente pianificato, è possibile selezionare a quali server MCP l'agente ha accesso. Ciò consente agli agenti automatizzati di utilizzare strumenti personalizzati quando vengono eseguiti secondo la loro pianificazione.

Per collegare le funzionalità MCP a un agente pianificato, apri l'agente in Impostazioni > Funzionalità > Attività pianificate, scegli la scheda Funzionalità per quell'agente e seleziona i server MCP che desideri rendere disponibili.

Nota

I server MCP devono essere in esecuzione e accessibili quando un agente pianificato tenta di utilizzare i propri strumenti. Per i server MCP locali, il processo del server si avvia automaticamente quando necessario. Per i server remoti, verificate che il server sia online e raggiungibile.