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 IDE-specific las opciones 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 LegacyMcpJson campo use del archivo de configuración global default.json permite la compatibilidad con los archivos mcp.json antiguos. De forma predeterminada, este campo se establece en true. Para obtener más información, consulte [UseLegacyMcpJson Field](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#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 de herramientas. Built-in ](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#tools-field)
## 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.).
1. Abra el panel de Q Developer.
1. Abra el panel de **chat**.
1. Elija el icono de herramientas. 
## 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](#mcp-ide-configuration-access-ui).
1. Elija el signo más (\+).
1. Seleccione el alcance: global o local.
Si selecciona un ámbito global, la configuración del servidor MCP se almacena en \~/. aws/amazonq/default.json y está disponible en todos tus proyectos. Si seleccionas el ámbito local, la configuración se guarda en. amazonq/default.json dentro de tu proyecto actual.
1. En el campo **Nombre**, introduzca el nombre del servidor MCP.
1. Seleccione `http` como protocolo de transporte.
1. En el campo **URL**, introduzca la URL a la que llamará el servidor MCP cuando se inicialice.
1. En **Encabezados (opcional)**, puede introducir pares clave-valor que deben enviarse como encabezados de solicitudes de HTTP.
1. Introduzca un valor de **timeout**, según proceda.
1. Seleccione **Guardar**.
El panel de configuración se sustituirá por el panel de permisos de la herramienta.
1. Siga el procedimiento indicado en [Revisión y ajuste de los permisos de las herramientas](#mcp-ide-configuration-review-adjust-tool).
**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](#mcp-ide-configuration-access-ui).
1. Elija el signo más (\+).
1. Seleccione el alcance: global o local.
Si selecciona el ámbito global, la configuración del servidor MCP se almacena en \~/. aws/amazonq/default.json y está disponible en todos tus proyectos. Si seleccionas el ámbito local, la configuración se guarda en. amazonq/default.json dentro de tu proyecto actual.
1. En el campo **Nombre**, introduzca el nombre del servidor MCP.
Por ejemplo, si estuviéramos instalando el [servidor MCP de AWS documentación](https://awslabs.github.io/mcp/servers/aws-documentation-mcp-server/), el nombre podría ser. {{AWS DocMCPServer}}
1. Seleccione `stdio` como protocolo de transporte.
1. 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.
1. 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.
1. 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](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/partitions.html) con la que vamos a trabajar.
1. Introduzca un valor de **timeout**, según proceda.
En nuestro ejemplo, mantendremos el valor recomendado de 60 (segundos).
1. Seleccione **Save**.
El panel de configuración se sustituirá por el panel de permisos de la herramienta.
1. Siga el procedimiento indicado en [Revisión y ajuste de los permisos de las herramientas](#mcp-ide-configuration-review-adjust-tool).
## 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.
1. 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.
1. Elija el servidor que desee deshabilitar.
1. Seleccione los tres puntos situados junto a **Editar configuración**.
1. 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.
1. Elija el servidor que desea eliminar.
Se abrirá un panel con detalles sobre ese servidor.
1. Seleccione los tres puntos situados junto a **Editar configuración**.
1. Elija **Eliminar servidor MCP**.
1. 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.
1. Junto a la etiqueta que desea eliminar, elija **Eliminar**.
1. 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.
1. Elija el servidor MCP para el que desea revisar y ajustar los permisos.
1. 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.