Configuración de MCP para Q Developer en el IDE - Amazon Q Developer
Con el IDEAñadir un servidor MCPSolución de problemas de la configuración de MCPHabilitar un servidor MCPDeshabilitar un servidor MCPEliminar un servidor MCP que esté activado actualmenteEliminar un servidor MCP que está actualmente deshabilitadoRevisión y ajuste de los permisos de la herramienta

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. Para obtener información general sobre la configuración del MCP, consulte Descripción de la configuración del MCP.

Acceder a la interfaz de usuario de configuración del MCP

La siguiente imagen muestra la GUI utilizada para configurar un servidor MCP para Q Developer en el IDE.

Una GUI con campos para los elementos principales de la configuración del MCP.

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

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

  2. Abre el panel Q Developer.

  3. Abre el panel de chat.

  4. Selecciona el icono de herramientas. tools icon

Añadir un servidor MCP

Para agregar un servidor MCP al IDE:

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

  2. Elija el símbolo más (+).

  3. Seleccione el ámbito: global o local.

    Si selecciona el ámbito global, la configuración del servidor MCP se almacena en ~/. aws/amazonq/mcp.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/mcp.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 el protocolo de transporte.

    En la actualidad, solo se admite stdio.

  6. En el campo Comando, introduzca el comando shell 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 parauv tool run, que crea un entorno Python efímero.

  7. En el campo Argumentos, introduzca un argumento para asignarlo al comando shell, si corresponde.

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

    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 tiempo de espera, según corresponda.

    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 que se indica a continuaciónRevisión y ajuste de los permisos de la herramienta.

Solución de problemas de la configuración de MCP

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

Si hay 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 Fijar configuración para volver a la pantalla de configuración del MCP y poder realizar los cambios adecuados.

Habilitar un servidor MCP

El siguiente procedimiento supone 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. Junto al servidor que desee activar, seleccione Activar.

Deshabilitar 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. Selecciona los tres puntos situados junto a Editar configuración.

  4. Seleccione Desactivar el servidor MCP.

Eliminar un servidor MCP que esté activado actualmente

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

  1. Abra el panel de servidores MCP.

  2. Elija el servidor que desee eliminar.

    Se abrirá un panel con detalles sobre ese servidor.

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

  4. Seleccione Eliminar servidor MCP.

  5. Confirme la eliminación cuando se le solicite.

Eliminar un servidor MCP que está actualmente deshabilitado

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

  1. Abra el panel de servidores MCP.

  2. Junto al servidor que desee eliminar, seleccione Eliminar.

  3. Confirme la eliminación cuando se le solicite.

Revisión y ajuste de los permisos de la herramienta

Para revisar y ajustar los permisos de las herramientas:

  1. Abra el panel de servidores MCP.

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

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

    • Pedir: solicite permiso cada vez que utilice la herramienta.

    • Permitir siempre: permita que la herramienta se ejecute sin solicitarlo.

    • Denegar: no utilice esta herramienta.

  4. Seleccione Guardar o Aplicar para actualizar la configuración de permisos.