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à.
Utilizzo di MCP con Amazon Q Developer
Il Model Context Protocol (MCP) è uno standard aperto che consente agli assistenti AI di interagire con strumenti e servizi esterni. La CLI per sviluppatori di Amazon Q ora supporta MCP, che consente di estendere le funzionalità di Q collegandola a strumenti e servizi personalizzati.
Argomenti
Caricamento del server MCP
Amazon Q carica i server MCP in background, consentendoti di iniziare a interagire immediatamente senza attendere l'inizializzazione di tutti i server. Gli strumenti diventano disponibili progressivamente man mano che i rispettivi server terminano il caricamento.
Verifica dello stato del server
È possibile utilizzare il /tools comando per vedere quali server sono ancora in fase di caricamento e quali strumenti sono già disponibili.
Configurazione dell'inizializzazione del server
È possibile personalizzare il timeout di inizializzazione del server utilizzando:
$ q settings mcp.initTimeout [value]
[value]Dov'è il timeout in millisecondi. Questa impostazione controlla per quanto tempo Amazon Q aspetterà l'inizializzazione dei server prima di consentirti di iniziare a interagire.
Strumenti e istruzioni
Questa sezione spiega come utilizzare gli strumenti e i prompt MCP con Amazon Q Developer CLI.
Comprendere gli strumenti MCP
Gli strumenti MCP sono funzioni eseguibili che i server MCP espongono alla CLI di Amazon Q Developer. Consentono ad Amazon Q Developer di eseguire azioni, elaborare dati e interagire con sistemi esterni per tuo conto.
Ogni strumento in MCP ha:
-
Nome: un identificatore univoco per lo strumento
-
Descrizione: una descrizione leggibile dall'uomo di ciò che fa lo strumento
-
Schema di input: uno schema JSON che definisce i parametri accettati dallo strumento
-
Annotazioni: suggerimenti opzionali sul comportamento e gli effetti dello strumento
Alla scoperta degli strumenti disponibili
Per vedere quali strumenti sono disponibili nella tua sessione Q CLI:
/tools
Questo comando visualizza tutti gli strumenti disponibili, inclusi gli strumenti integrati e quelli forniti dai server MCP.
Gli strumenti possono avere diversi livelli di autorizzazione che determinano il modo in cui vengono utilizzati:
-
Approvazione automatica: questi strumenti possono essere utilizzati senza autorizzazione esplicita per ogni chiamata
-
Richiede l'approvazione: questi strumenti richiedono l'autorizzazione esplicita dell'utente ogni volta che vengono utilizzati
-
Pericolosi: questi strumenti sono contrassegnati come potenzialmente rischiosi e richiedono un'attenta valutazione prima dell'approvazione
Utilizzo degli strumenti
È possibile utilizzare gli strumenti MCP in due modi:
-
Richieste in linguaggio naturale: descrivi semplicemente cosa vuoi fare e Q determinerà quale strumento usare.
-
Invocazione diretta dello strumento: puoi anche richiedere esplicitamente a Q di utilizzare uno strumento specifico.
Lavorare con i prompt
I server MCP possono fornire istruzioni predefinite che aiutano a guidare Q in attività specifiche:
-
Elenca i prompt disponibili:
/prompts -
Usa un prompt:
-
@prompt-namearg1 arg2
-
Esempio di utilizzo di un prompt con argomenti:
@fetch https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html
Vantaggi principali
-
Estensibilità: Connect Amazon Q a strumenti specializzati per domini o flussi di lavoro specifici
-
Personalizzazione: crea strumenti personalizzati su misura per le tue esigenze specifiche
-
Integrazione dell'ecosistema: sfrutta il crescente ecosistema di strumenti compatibili con MCP
-
Standardizzazione: utilizza un protocollo coerente supportato da più assistenti AI
-
Flessibilità: MCP consente di passare da un fornitore LLM all'altro mantenendo le stesse integrazioni di strumenti
-
Sicurezza: mantieni i dati all'interno della tua infrastruttura con server MCP locali
Architettura MCP
MCP segue un'architettura client-server in cui:
-
Host MCP: programmi come Amazon Q Developer CLI che desiderano accedere ai dati tramite MCP
-
Client MCP: client di protocollo che mantengono connessioni 1:1 con i server
-
Server MCP: programmi leggeri, ciascuno dei quali presenta funzionalità specifiche tramite il Model Context Protocol standardizzato Model Context Protocol
-
Fonti di dati locali: file, database e servizi del computer a cui i server MCP possono accedere in modo sicuro
-
Servizi remoti: sistemi esterni disponibili su Internet (ad esempio tramite APIs) a cui i server MCP possono connettersi
Esempio Flusso di comunicazione MCP
User | v +------------------+ +-----------------+ +------------------+ | | | | | | | Amazon Q Dev | --> | MCP Client API | --> | MCP Server | | | | | | | +------------------+ +-----------------+ +------------------+ | v +------------------+ | | | External Service | | | +------------------+
Flusso di comunicazione tra utente, Amazon Q Developer CLI e servizi esterni tramite MCP
Concetti principali di MCP
Strumenti
Gli strumenti sono funzioni eseguibili che i server MCP espongono ai client. Consentono ad Amazon Q di:
-
Eseguire azioni in sistemi esterni
-
Elabora i dati in modi specializzati
-
Interagisci con APIs e servizi
-
Esegui comandi per tuo conto
Gli strumenti sono definiti con un nome univoco, una descrizione, uno schema di input (utilizzando lo schema JSON) e annotazioni opzionali sul comportamento dello strumento.
Prompt
I prompt sono modelli predefiniti che aiutano a guidare Amazon Q in attività specifiche. In particolare, può:
-
Accetta argomenti dinamici
-
Includi il contesto delle risorse
-
Concatena più interazioni
-
Guida flussi di lavoro specifici
-
Espandi come elementi dell'interfaccia utente (come i comandi slash)
Risorse
Le risorse rappresentano i dati che i server MCP possono fornire ad Amazon Q, ad esempio:
-
Contenuto del file
-
Record del database
-
Risposte API
-
Documentazione
-
Dati di configurazione
