View a markdown version of this page

Configuração do MCP na CLI - Amazon Q Developer
Comandos de configuraçãoServidores MCP remotos

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configuração do MCP na CLI

Esta página aborda as CLI-specific opções para configurar servidores MCP.

Comandos de configuração

Uso: qchat mcp [OPTIONS] COMMAND

Comandos de configuração MCP
Command Description
qchat mcp add Adicionar ou substituir um servidor configurado
qchat mcp remove Remover um servidor da configuração do MCP
qchat mcp list Listar servidores configurados
qchat mcp import Importar uma configuração de servidor de outro arquivo
qchat mcp status Obter o status de um servidor configurado
qchat mcp help Imprimir esta lista de comandos ou ajuda para o(s) subcomando(s) fornecido(s)

Argumentos do servidor MCP

O --args parâmetro agora suporta argumentos contendo vírgulas usando escape ou formato de matriz 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"]'

Servidores MCP remotos

Além dos servidores MCP locais que são executados como processos, o Amazon Q Developer CLI oferece suporte a servidores MCP remotos que se comunicam por HTTP. Os servidores remotos podem usar a autenticação OAuth ou estar abertos (sem necessidade de autenticação).

Configuração

Os servidores MCP remotos são configurados no arquivo de configuração do agente usando os url campos type e:

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

Fluxo de autenticação OAuth

Ao usar servidores MCP remotos que exigem autenticação OAuth:

  1. Inicie sua sessão do Q CLI com um agente que inclui o servidor MCP remoto

  2. O servidor aparecerá inicialmente como “ainda não carregado”

  3. Use o /mcp comando para iniciar a autenticação

  4. Uma CLI indicará que o servidor requer autenticação e fornecerá uma URL

  5. Abra o URL fornecido em seu navegador enquanto mantém a sessão do Q CLI aberta

  6. Siga as instruções de autenticação no seu navegador

  7. Retorne à janela Q CLI - você será conectado ao servidor MCP se a autenticação for bem-sucedida

As ferramentas do servidor estarão disponíveis quando a autenticação for concluída.