View a markdown version of this page

Configurazione dell’MCP nella CLI - Amazon Q Developer
Comandi di configurazioneServer MCP remoti

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 dell’MCP nella CLI

Questa pagina descrive CLI-specific le opzioni per la configurazione dei server MCP.

Comandi di configurazione

Utilizzo: qchat mcp [OPTIONS] COMMAND

Comandi di configurazione MCP
Comando Description
qchat mcp add Aggiungere o sostituire un server configurato
qchat mcp remove Rimuovere un server dalla configurazione MCP
qchat mcp list Elencare i server configurati
qchat mcp import Importare una configurazione del server da un altro file
qchat mcp status Ottenere lo stato di un server configurato
qchat mcp help Stampare questo elenco di comandi o fornire una guida per i sottocomandi specificati

Argomenti del server MCP

Il --args parametro ora supporta argomenti contenenti virgole utilizzando il formato di matrice escape o JSON:

# Escaped commas
q mcp add --name server --command cmd --args "arg1,arg2\,with\,commas,arg3"

# JSON array format  
q mcp add --name server --command cmd --args '["arg1", "arg2,with,commas", "arg3"]'

Server MCP remoti

Oltre ai server MCP locali che vengono eseguiti come processi, Amazon Q Developer CLI supporta server MCP remoti che comunicano tramite HTTP. I server remoti possono utilizzare l'autenticazione OAuth o essere aperti (non è richiesta l'autenticazione).

Configurazione

I server MCP remoti sono configurati nel file di configurazione dell'agente utilizzando i type campi e: url

{
  "mcpServers": {
    "find-a-domain": {
      "type": "http",
      "url": "https://api.findadomain.dev/mcp"
    }
  }
}

Flusso di autenticazione OAuth

Quando si utilizzano server MCP remoti che richiedono l'autenticazione OAuth:

  1. Avvia la sessione Q CLI con un agente che include il server MCP remoto

  2. Il server verrà inizialmente visualizzato come «non ancora caricato»

  3. Usa il /mcp comando per iniziare l'autenticazione

  4. Una CLI indicherà che il server richiede l'autenticazione e fornirà un URL

  5. Apri l'URL fornito nel tuo browser mantenendo aperta la sessione Q CLI

  6. Segui le istruzioni di autenticazione nel tuo browser

  7. Ritorna alla finestra Q CLI: accederai al server MCP se l'autenticazione ha avuto successo

Gli strumenti del server saranno disponibili una volta completata l'autenticazione.