View a markdown version of this page

Configuración del MCP en la CLI - Amazon Q Developer
Comandos de configuraciónServidores MCP remotos

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración del MCP en la CLI

En esta página se describen CLI-specific las opciones para configurar los servidores MCP.

Comandos de configuración

Uso: qchat mcp [OPTIONS] COMMAND

Comandos de configuración de MCP
Comando Description (Descripción)
qchat mcp add Añadir o reemplazar un servidor configurado
qchat mcp remove Eliminar un servidor de la configuración del MCP
qchat mcp list Enumerar los servidores configurados
qchat mcp import Importar una configuración de servidor desde otro archivo
qchat mcp status Obtener el estado de un servidor configurado
qchat mcp help Imprimir esta lista de comandos o la ayuda para los subcomandos indicados

Argumentos del servidor MCP

El --args parámetro ahora admite argumentos que contienen comas utilizando un formato de matriz JSON o de escape:

# 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

Además de los servidores MCP locales que se ejecutan como procesos, la CLI para desarrolladores de Amazon Q admite servidores MCP remotos que se comunican a través de HTTP. Los servidores remotos pueden usar la autenticación OAuth o estar abiertos (no se requiere autenticación).

Configuración

Los servidores MCP remotos se configuran en el archivo de configuración del agente mediante los type campos y: url

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

Flujo de autenticación de OAuth

Cuando se utilizan servidores MCP remotos que requieren autenticación OAuth:

  1. Inicie su sesión de Q CLI con un agente que incluya el servidor MCP remoto

  2. El servidor aparecerá inicialmente como «aún no cargado»

  3. Utilice el /mcp comando para iniciar la autenticación

  4. Q: CLI indicará que el servidor requiere autenticación y proporcionará una URL.

  5. Abra la URL proporcionada en su navegador mientras mantiene abierta la sesión de Q CLI

  6. Siga las instrucciones de autenticación de su navegador

  7. Regrese a la ventana Q CLI: iniciará sesión en el servidor MCP si la autenticación se realizó correctamente

Las herramientas del servidor estarán disponibles una vez que se complete la autenticación.