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.
# Uso del MCP con Amazon Q Developer
El Protocolo de contexto para modelos (MCP) es un estándar abierto que permite a los asistentes de IA interactuar con herramientas y servicios externos. La CLI de Amazon Q Developer ahora es compatible con MCP, lo que le permite ampliar las capacidades de Q conectándolo a herramientas y servicios personalizados.
**Topics**
+ [Información general del MCP](qdev-mcp-overview.md)
+ [Configuración del MCP en la CLI](command-line-mcp-config-CLI.md)
+ [Configuración del MCP](#mcp-configuration)
+ [Herramientas y peticiones](#command-line-mcp-tools-prompts)
+ [Configuración de MCP para Q Developer en el IDE](mcp-ide.md)
+ [Ventajas principales](#command-line-mcp-benefits)
+ [Arquitectura del MCP](#command-line-mcp-architecture)
+ [Conceptos clave del MCP](#command-line-mcp-concepts)
+ [Seguridad del MCP](command-line-mcp-security.md)
+ [Gobernanza de MCP para Q Developer](mcp-governance.md)
## Configuración del MCP
### Configuración de los servidores MCP con la CLI de Q
La configuración de MCP definida globalmente para Amazon Q CLI se gestiona en:
```
~/.aws/amazonq/cli-agents
```
La CLI para desarrolladores de Amazon Q admite servidores MCP locales (que se ejecutan como procesos) y servidores MCP remotos (que se comunican a través de HTTP). Los servidores remotos pueden utilizar la OAuth autenticación o estar abiertos sin necesidad de autenticación.
Para obtener más información, consulte [la guía de configuración de agentes personalizados en el repositorio Github de Q CLI](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#mcpservers-field) y[Servidores MCP remotos](command-line-mcp-config-CLI.md#command-line-mcp-remote-servers).
### Configuración de los servidores MCP con Q en el IDE
La configuración de MCP definida globalmente para Amazon Q en el IDE se gestiona en:
```
~/.aws/amazonq/agents/default.json
```
Para obtener más información, consulte [Configuración de MCP para Q Developer en el IDE](mcp-ide.md).
### Carga del servidor MCP
Amazon Q carga los servidores MCP en segundo plano, lo que le permite empezar a interactuar inmediatamente sin tener que esperar a que se inicialicen todos los servidores. Las herramientas estarán disponibles progresivamente a medida que sus respectivos servidores terminen de cargarse.
#### Comprobación del estado del servidor
Puede usar el comando `/tools` para ver qué servidores siguen cargándose y qué herramientas ya están disponibles.
#### Configuración de la inicialización del servidor
Puede personalizar el tiempo de espera de inicialización del servidor mediante:
```
$ q settings mcp.initTimeout [value]
```
Donde `[value]` es el tiempo de espera en milisegundos. Esta configuración controla cuánto tiempo esperará Amazon Q a que los servidores se inicialicen antes de que pueda empezar a interactuar.
## Herramientas y peticiones
En esta sección se explica cómo utilizar las herramientas y las peticiones del MCP con la CLI de Amazon Q Developer.
### Descripción de las herramientas del MCP
Las herramientas del MCP son funciones ejecutables que los servidores MCP exponen a la CLI de Amazon Q Developer. Permiten a Amazon Q Developer realizar acciones, procesar datos e interactuar con sistemas externos en su nombre.
Cada herramienta del MCP tiene las siguientes opciones:
+ **Nombre:** un identificador único para la herramienta
+ **Descripción:** una descripción en lenguaje natural de lo que hace la herramienta
+ **Esquema de entrada:** un esquema de JSON que define los parámetros que acepta la herramienta
+ **Anotaciones:** sugerencias opcionales sobre el comportamiento y los efectos de la herramienta
### Detección de herramientas disponibles
Para ver qué herramientas están disponibles en la sesión de CLI de Q:
```
/tools
```
Este comando muestra todas las herramientas disponibles, incluidas las herramientas integradas y las que proporcionan los servidores MCP.
Las herramientas pueden tener diferentes niveles de permisos que determinan cómo se utilizan:
+ **Aprobación automática:** estas herramientas se pueden usar sin permiso explícito para cada invocación.
+ **Requiere aprobación:** estas herramientas necesitan su permiso explícito cada vez que se utilizan.
+ **Peligrosas:** estas herramientas están marcadas como potencialmente arriesgadas y requieren estudiarse detenidamente antes de su aprobación.
### Cómo utilizar herramientas de
Puede utilizar las herramientas del MCP de dos maneras:
1. **Solicitudes de lenguaje natural:** simplemente describa lo que quiere hacer y Q determinará qué herramienta utilizar.
1. **Invocación directa de herramientas:** también puede solicitar explícitamente a Q que utilice una herramienta en concreto.
### Uso de las peticiones
Los servidores MCP pueden proporcionar peticiones predefinidas que ayuden a guiar a Q en tareas específicas:
+ Enumere las peticiones disponibles: `/prompts`
+ Utilice una petición:
+ `@ prompt-name arg1 arg2`
Ejemplo del uso de una petición con argumentos:
```
@fetch https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html
```
## Ventajas principales
+ **Extensibilidad:** conecte Amazon Q a herramientas especializadas para dominios o flujos de trabajo específicos.
+ **Personalización:** cree herramientas personalizadas adaptadas a sus necesidades específicas.
+ **Integración del ecosistema:** saque partido del creciente ecosistema de herramientas compatibles con el MCP.
+ **Estandarización:** utilice un protocolo coherente compatible con varios asistentes de IA.
+ **Flexibilidad:** el MCP le permite cambiar entre diferentes proveedores de LLM y, al mismo tiempo, mantener las mismas integraciones de herramientas.
+ **Seguridad:** mantenga los datos en la infraestructura con los servidores MCP locales.
## Arquitectura del MCP
El MCP sigue una arquitectura cliente-servidor que cuenta con:
+ **Hosts del MCP:** programas como la CLI de Amazon Q Developer que desean acceder a los datos a través del MCP
+ **Clientes del MCP:** clientes de protocolo que mantienen conexiones individuales con los servidores
+ **Servidores MCP:** programas ligeros, cada uno de los cuales expone capacidades específicas a través del Protocolo de contexto para modelos estandarizado
+ **Orígenes de datos locales:** los archivos, bases de datos y servicios que almacena en el ordenador a los que los servidores MCP pueden acceder de forma segura
+ **Servicios remotos**: sistemas externos disponibles a través de Internet (por ejemplo, a través de APIs) a los que se pueden conectar los servidores MCP
**Example Flujo de comunicación del MCP**
```
User
|
v
+------------------+ +-----------------+ +------------------+
| | | | | |
| Amazon Q Dev | --> | MCP Client API | --> | MCP Server |
| | | | | |
+------------------+ +-----------------+ +------------------+
|
v
+------------------+
| |
| External Service |
| |
+------------------+
```
Flujo de comunicación entre el usuario, la CLI de Amazon Q Developer y los servicios externos a través del MCP
## Conceptos clave del MCP
### Tools (Herramientas)
Las herramientas son funciones ejecutables que los servidores MCP exponen a los clientes. Permiten a Amazon Q:
+ Realizar acciones en sistemas externos
+ Procesar los datos de manera especializada
+ Interactúa con APIs y presta servicios
+ Ejecutar comandos en su nombre
Las herramientas se definen con un nombre único, una descripción, un esquema de entrada (mediante el esquema de JSON) y anotaciones opcionales sobre el comportamiento de la herramienta.
### Mensajes
Las peticiones son plantillas predefinidas que ayudan a guiar a Amazon Q en tareas específicas. Puede realizar lo siguiente:
+ Aceptar argumentos dinámicos
+ Incluir el contexto de los recursos
+ Encadenar varias interacciones
+ Guiar los flujos de trabajo específicos
+ Manifestarse como elementos de la interfaz de usuario (como comandos de barra inclinada)
### Recursos
Los recursos representan datos que los servidores MCP pueden proporcionar a Amazon Q, como, por ejemplo:
+ Contenido del archivo
+ Registros de bases de datos
+ Respuestas de la API
+ Documentación
+ Datos de configuración