Configuración de MCP para Q Developer en el IDE - Amazon Q Developer
Archivos de configuración MCP IDEAcceder a la interfaz de usuarioInclusión de un servidor MCPSolución de problemas de configuración de MCPHabilitación de un servidor MCPDeshabilitación de un servidor MCPEliminación de un servidor MCP actualmente habilitadoEliminación de un servidor MCP actualmente deshabilitadoRevisión y ajuste de los permisos de las herramientas

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 de MCP para Q Developer en el IDE

En esta página se describen las opciones específicas del IDE para configurar los servidores MCP.

Descripción de los archivos de configuración MCP para Q Developer en el IDE

Cuando se utiliza la GUI para añadir un servidor MCP a Q Developer en el IDE, la configuración se almacena en uno de estos dos archivos:

  • En el ámbito global: ~/. aws/amazonq/default.json

  • En el ámbito local: .amazonq/default.json

Sin embargo, por motivos heredados, también es posible colocar la información de configuración del MCP en otras dos ubicaciones:

  • En el ámbito global: ~/. aws/amazonq/mcp.json

  • En el ámbito local: .amazonq/mcp.json

Q Developer da prioridad a las configuraciones a nivel de espacio de trabajo para los servidores MCP, sus permisos y la configuración almacenada.

nota

Si ya ha configurado una configuración de MCP en un archivo mcp.json y está utilizando la GUI de configuración de MCP por primera vez, verá esa configuración en la GUI.

El campo Json del archivo de configuración global useLegacyMcp default.json permite la compatibilidad con los archivos mcp.json antiguos. De forma predeterminada, este campo está establecido en true. Para obtener más información, consulte UseLegacyMcpJson Field en el GitHub repositorio de CLI de Q Developer.

Tenga en cuenta que la CLI de Q también puede utilizar los archivos mcp.json.

Para obtener información sobre cómo configurar controles granulares en las herramientas MCP, consulte la referencia sobre las herramientas integradas.

Acceso a la interfaz de usuario de configuración de MCP

Para acceder a la interfaz de usuario de configuración de MCP en Q Developer en el IDE:

  1. Abra su IDE (VS Code JetBrains, etc.).

  2. Abra el panel de Q Developer.

  3. Abra el panel de chat.

  4. Elija el icono de herramientas. tools icon

Inclusión de un servidor MCP

Existen dos mecanismos de transporte principales para la comunicación entre los clientes de IA y los servidores MCP: STDIO y HTTP.

Inclusión de un servidor MCP con HTTP

Para agregar un servidor MCP con HTTP al IDE:

  1. Acceda a la interfaz de usuario de configuración de MCP.

  2. Elija el signo más (+).

  3. Seleccione el alcance: global o local.

    Si selecciona un ámbito global, la configuración del servidor MCP se almacena en ~/. aws/amazonq/default.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/default.json dentro de su proyecto actual.

  4. En el campo Nombre, introduzca el nombre del servidor MCP.

  5. Seleccione http como protocolo de transporte.

  6. En el campo URL, introduzca la URL a la que llamará el servidor MCP cuando se inicialice.

  7. En Encabezados (opcional), puede introducir pares clave-valor que deben enviarse como encabezados de solicitudes de HTTP.

  8. Introduzca un valor de timeout, según proceda.

  9. Seleccione Guardar.

    El panel de configuración se sustituirá por el panel de permisos de la herramienta.

  10. Siga el procedimiento indicado en Revisión y ajuste de los permisos de las herramientas.

nota

Si el punto de conexión HTTP de MCP requiere autorización, Amazon Q abrirá automáticamente una página del navegador para que pueda autorizar a Amazon Q a acceder al servidor MCP.

Inclusión de un servidor MCP con STDIO

Para añadir un servidor MCP con STDIO al IDE:

  1. Acceda a la interfaz de usuario de configuración de MCP.

  2. Elija el signo más (+).

  3. Seleccione el alcance: global o local.

    Si selecciona el ámbito global, la configuración del servidor MCP se almacena en ~/. aws/amazonq/default.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/default.json dentro de su proyecto actual.

  4. En el campo Nombre, introduzca el nombre del servidor MCP.

    Por ejemplo, si estuviéramos instalando el servidor MCP de AWS documentación, el nombre podría ser. AWS DocMCPServer

  5. Seleccione stdio como protocolo de transporte.

  6. En el campo Comando, introduzca el comando de intérprete de comandos que el servidor MCP ejecutará cuando se inicialice.

    En el caso del servidor MCP de AWS documentación, el comando es. uvx Se trata de un alias para uv tool run, que crea un entorno Python efímero.

  7. En el campo Argumentos, introduzca un argumento para asignarlo al comando de intérprete de comandos, si corresponde.

    En el caso del servidor MCP de AWS documentación, el argumento es. awslabs.aws-documentation-mcp-server@latest Este es un identificador de paquete de Python que apunta a un paquete alojado en PyPI (Índice de paquetes de Python).

    Agregue más argumentos según sea necesario.

  8. Rellene las variables de entorno según proceda.

    En el caso de nuestro ejemplo, primero rellenamos Nombre: FASTMCP_LOG_LEVEL y Valor:ERROR.

    También usaremos el nombre AWS_DOCUMENTATION_PARTITION y el valor aws para indicar la partición con la que vamos a trabajar.

  9. Introduzca un valor de timeout, según proceda.

    En nuestro ejemplo, mantendremos el valor recomendado de 60 (segundos).

  10. Seleccione Save.

    El panel de configuración se sustituirá por el panel de permisos de la herramienta.

  11. Siga el procedimiento indicado en Revisión y ajuste de los permisos de las herramientas.

Solución de problemas de configuración de MCP

Tras añadir un servidor MCP al IDE, Amazon Q intentará conectarse a él.

Si se producen problemas de conexión, aparecerá una alerta en la parte superior del panel. No debe esperar que las herramientas de ese servidor MCP funcionen correctamente hasta que se resuelva la alerta.

Elija Corregir configuración para volver a la pantalla de configuración del MCP y realizar los cambios adecuados.

Habilitación de un servidor MCP

En el siguiente procedimiento se asume que el servidor MCP en cuestión aún no está habilitado.

Para habilitar un servidor MCP en el IDE:

  1. Abra el panel de servidores MCP.

  2. Seleccione Habilitar junto al servidor que desee habilitar.

Deshabilitación de un servidor MCP

Para deshabilitar un servidor MCP en el IDE:

  1. Abra el panel de servidores MCP.

  2. Elija el servidor que desee deshabilitar.

  3. Seleccione los tres puntos situados junto a Editar configuración.

  4. Seleccione Deshabilitar servidor MCP.

Eliminación de un servidor MCP actualmente habilitado

Para eliminar del IDE un servidor MCP que está actualmente habilitado:

  1. Abra el panel de servidores MCP.

  2. Elija el servidor que desea eliminar.

    Se abrirá un panel con detalles sobre ese servidor.

  3. Seleccione los tres puntos situados junto a Editar configuración.

  4. Elija Eliminar servidor MCP.

  5. Cuando se le solicite, confirme la eliminación.

Eliminación de un servidor MCP actualmente deshabilitado

Para eliminar del IDE un servidor MCP que está actualmente deshabilitado:

  1. Abra el panel de servidores MCP.

  2. Junto a la etiqueta que desea eliminar, elija Eliminar.

  3. Cuando se le solicite, confirme la eliminación.

Revisión y ajuste de los permisos de las herramientas

Para revisar y ajustar los permisos de las herramientas:

  1. Abra el panel de servidores MCP.

  2. Elija el servidor MCP para el que desea revisar y ajustar los permisos.

  3. En cada herramienta, puede establecer uno de los siguientes niveles de permisos:

    • Solicitar: pida permiso cada vez que utilice la herramienta.

    • Permitir siempre: permita que la herramienta se ejecute sin petición.

    • Denegar: no utilice esta herramienta.