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.
Temas
Configuración del MCP
Deshabilitación del MCP para la organización
Según la configuración, es posible que tenga la opción de deshabilitar los servidores MCP para la organización o la cuenta de AWS en la consola de Amazon Q Developer. Esto se aplica si:
Administra una organización desde la cuenta de administración o utiliza una cuenta independiente.
Utiliza Amazon Q Developer en un IDE compatible.
nota
Esta configuración se aplica en el cliente. Tenga en cuenta que los usuarios finales podrían eludirla.
Cómo deshabilitar el MCP en su cuenta u organización:
Abra la consola de Amazon Q Developer.
Elija Configuración.
En Preferencias, seleccione Editar.
En la ventana emergente Editar preferencias, cambie a Protocolo de contexto para modelos (MCP).
Seleccione Save.
Configuración de los servidores MCP con la CLI de Q
La configuración del MCP para la CLI de Amazon Q definida globalmente se gestiona en:
~/.aws/amazonq/cli-agents
Para obtener más información, consulte la guía de configuración de agentes personalizados en el repositorio sobre la CLI de Q de Github
Configuración de los servidores MCP con Q en el IDE
La configuración del MCP 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.
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:
-
Solicitudes de lenguaje natural: simplemente describa lo que quiere hacer y Q determinará qué herramienta utilizar.
-
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-namearg1 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 las API) a los que se pueden conectar los servidores MCP
ejemplo 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
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
-
Interactuar con las API y los 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
