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 de MCP con Amazon Q Developer
El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA interactuar con herramientas y servicios externos. La CLI para desarrolladores de Amazon Q ahora es compatible con MCP, lo que le permite ampliar las capacidades de Q conectándola a herramientas y servicios personalizados.
Temas
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.
Comprobando el estado del servidor
Puede usar el /tools
comando para ver qué servidores siguen cargándose y qué herramientas ya están disponibles.
Configurar la inicialización del servidor
Puede personalizar el tiempo de espera de inicialización del servidor mediante:
$ q settings mcp.initTimeout [value]
¿Dónde [value]
está 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 puedas empezar a interactuar.
Herramientas e indicaciones
En esta sección se explica cómo utilizar las herramientas y las instrucciones de MCP con Amazon Q Developer CLI.
Comprensión de las herramientas de MCP
Las herramientas 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 de MCP tiene:
-
Nombre: un identificador único para la herramienta
-
Descripción: una descripción legible para los humanos de lo que hace la herramienta
-
Esquema de entrada: un esquema JSON que define los parámetros que acepta la herramienta
-
Anotaciones: sugerencias opcionales sobre el comportamiento y los efectos de la herramienta
Descubriendo las herramientas disponibles
Para ver qué herramientas están disponibles en su sesión de Q CLI:
/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 tu permiso explícito cada vez que se utilizan
-
Peligrosas: estas herramientas están marcadas como potencialmente riesgosas y requieren una cuidadosa consideración antes de su aprobación
Cómo utilizar herramientas de
Puede utilizar las herramientas de 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 específica.
Trabajando con indicaciones
Los servidores MCP pueden proporcionar indicaciones predefinidas que ayudan a guiar a Q en tareas específicas:
-
Enumere las indicaciones disponibles:
/prompts
-
Usa un mensaje:
-
@
prompt-name
arg1 arg2
-
Ejemplo de uso de un mensaje con argumentos:
@fetch https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html
Ventajas principales
-
Extensibilidad: Connect 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: aproveche el creciente ecosistema de herramientas compatibles con MCP
-
Estandarización: utilice un protocolo coherente compatible con varios asistentes de IA
-
Flexibilidad: MCP le permite cambiar entre diferentes proveedores de LLM y, al mismo tiempo, mantener las mismas integraciones de herramientas
-
Seguridad: mantenga sus datos dentro de su infraestructura con los servidores MCP locales
Arquitectura MCP
El MCP sigue una arquitectura cliente-servidor en la que:
-
Hosts de MCP: programas como Amazon Q Developer CLI que desean acceder a los datos a través de MCP
-
Clientes MCP: clientes de protocolo que mantienen conexiones individuales con los servidores
-
Servidores MCP: programas livianos, cada uno de los cuales expone capacidades específicas a través del protocolo estandarizado Model Context
-
Fuentes de datos locales: archivos, bases de datos y servicios de su computadora 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
ejemplo Flujo de comunicación 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 de MCP
Conceptos básicos 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
-
Procese los datos de forma especializada
-
Interactúe con APIs nuestros servicios
-
Ejecute comandos en su nombre
Las herramientas se definen con un nombre único, una descripción, un esquema de entrada (mediante el esquema JSON) y anotaciones opcionales sobre el comportamiento de la herramienta.
Mensajes
Las indicaciones son plantillas predefinidas que ayudan a guiar a Amazon Q en tareas específicas. Puede realizar lo siguiente:
-
Acepta argumentos dinámicos
-
Incluya el contexto de los recursos
-
Encadene múltiples interacciones
-
Guíe flujos de trabajo específicos
-
Aparecen como elementos de la interfaz de usuario (como comandos de barra oblicua)
Recursos
Los recursos representan datos que los servidores MCP pueden proporcionar a Amazon Q, como:
-
Contenido del archivo
-
registros de bases de datos
-
Respuestas de la API
-
Documentación
-
Datos de configuración