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 MCP

La configuración de MCP en Amazon Q Developer CLI se administra mediante archivos JSON. En esta sección se explica cómo configurar los servidores MCP para ampliar las capacidades de Q.

Comprensión de la configuración de MCP

La configuración del cliente MCP en Amazon Q Developer CLI se almacena en formato JSON, en un archivo denominadomcp.json. En esta sección se explica cómo funciona la configuración de MCP y cómo estructurar los archivos de configuración.

Ubicaciones de los archivos de configuración

La CLI para desarrolladores de Amazon Q admite dos niveles de configuración de MCP:

Ambos archivos son opcionales; no puede existir ninguno, ni uno ni ambos. Si ambos archivos existen, la CLI para desarrolladores de Amazon Q lee la configuración de MCP de ambos y los combina, tomando la unión de sus contenidos. Si hay un conflicto (es decir, un servidor definido en la configuración global también está presente en la configuración del espacio de trabajo), se muestra una advertencia y solo se utiliza la entrada del servidor en la configuración del espacio de trabajo.

La CLI de Amazon Q Developer supervisa estos archivos de configuración y vuelve a cargar automáticamente la configuración del MCP cada vez que realiza cambios en alguno de los archivos.

Estructura del archivo de configuración

El archivo de configuración MCP utiliza un formato JSON con la siguiente estructura:

{
  "mcpServers": {
    "server-name": {
      "command": "command-to-run",
      "args": ["arg1", "arg2"],
      "env": {
        "ENV_VAR1": "value1",
        "ENV_VAR2": "value2"
      },
      "timeout": 60000
    }
  }
}

Cada entrada del servidor MCP es un objeto, con el nombre del servidor como clave. El nombre debe ser único en cada archivo de configuración del MCP y en los archivos de configuración globales y del proyecto. El nombre del servidor no debe estar vacío y no debe tener más de 250 caracteres.

Cada objeto de entrada del servidor MCP debe tener la propiedad «command» (para el transporte stdio) o la propiedad «url» (para el transporte HTTP, que se admitirá en una versión futura).

Si hay algún atributo inesperado en el archivo JSON, se muestra una advertencia y esos atributos se ignoran.

Configuración del servidor Stdio

Si la propiedad «command» está presente en una entrada, este servidor MCP usa stdio transport. Se admiten los siguientes atributos:

Sustitución de variables de entorno:

Ejemplo de configuración de servidor de estudio:

{
  "mcpServers": {
    "stdio-mcp-server": {
      "command": "mycommand",
      "args": [
        "arg1"
      ],
      "env": {
        "API_KEY": "value1"
      },
      "timeout": 60000
    }
  }
}

Ejemplos de configuraciones

Ejemplo básico con un único servidor MCP:

{
  "mcpServers": {
    "markdown-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@example/markdown-mcp"
      ]
    }
  }
}

Ejemplo con varios servidores MCP y variables de entorno:

{
  "mcpServers": {
    "git-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@example/git-mcp"
      ],
      "timeout": 30000
    },
    "api-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@example/api-mcp"
      ],
      "env": {
        "API_URL": "https://api.example.com",
        "API_KEY": "your-api-key"
      },
      "timeout": 120000
    }
  }
}

Prácticas recomendadas de configuración

Comandos de configuración

Uso: Usage: qchat mcp [OPTIONS] COMMAND