Uso de MCP con Amazon Q Developer - Amazon Q Developer

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.

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:

  1. Solicitudes de lenguaje natural: simplemente describa lo que quiere hacer y Q determinará qué herramienta utilizar.

  2. 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