El Protocolo de contexto del modelo (MCP) es un estándar de código abierto para conectar aplicaciones de IA a sistemas externos. Establece un conjunto específico de entidades y una estructura definida, que actúa como una forma estándar de conectar varias fuentes de datos y herramientas con modelos de IA.
Puedes usar herramientas de MCP para conectar tu aplicación de agente con un servidor de MCP existente.
Limitaciones
Se aplica la siguiente limitación:
- CX Agent Studio solo admite servidores basados en StreamableHttpTransport. No se admiten servidores de transporte SSE.
Crea o selecciona un servidor de MCP
Para compilar tu propio servidor de MCP, te recomendamos que uses los SDKs oficiales de MCP o cualquier otro SDK de terceros confiable, como FastMCP. Una vez que se crea el servidor de MCP, impleméntalo en un servicio de hosting. Puedes usar Cloud Run o Compute Engine para alojar el servidor de MCP. Considera seguir esta guía para comprender el proceso de extremo a extremo: Compila e implementa un servidor de MCP remoto en Google Cloud Run en menos de 10 minutos.
En lugar de crear un servidor de MCP desde cero, también puedes usar un servidor de MCP prediseñado, como un servidor de MCP deGoogle Cloud .
Autenticación
Las herramientas de MCP tienen las mismas opciones de autenticación que las herramientas de OpenAPI.
Prueba el servidor de MCP de forma independiente
Antes de conectar tus agentes al servidor de MCP, te recomendamos que lo pruebes de forma independiente.
Los servidores compilados con StreamableHttpTransport terminan con el sufijo (/mcp o /mcp/). Por ejemplo, si el servidor está alojado en https://example.com, la URL correcta para enviar solicitudes al servidor sería https://example.com/mcp.
Para probar el servidor de forma local, considera usar curl o Postman (que admite de forma nativa las conexiones de MCP). Esto garantiza que el servidor esté en funcionamiento y que se comprenda la información de autenticación necesaria para comunicarse con él.
Crea la herramienta de MCP
Para crear una herramienta de MCP desde la consola, haz lo siguiente:
- Haz clic en el ícono de herramientas que se encuentra en el lado derecho del creador de agentes.
- Selecciona Herramienta de MCP.
- Proporciona un nombre para la herramienta.
- Proporciona una descripción de la herramienta.
- Proporciona la dirección del servidor de MCP.
- Selecciona un tipo de autenticación.
- Haz clic en Crear.
Para los servidores alojados en Cloud Run, la opción de autenticación recomendada es el token de ID del agente de servicio.
Este método usa la cuenta de servicio de CX Agent Studio (con el formato service-{PROJECT_NUMBER}@gcp-sa-ces.iam.gserviceaccount.com) para enviar solicitudes al trabajo de Cloud Run.
Otorga el rol de invocador de Cloud Run a la cuenta de servicio de CX Agent Studio para que pueda enviar solicitudes al servidor con su propia identidad.
Antes de agregar herramientas adicionales al agente, te recomendamos que pruebes al menos una herramienta para asegurarte de que la información de autenticación esté configurada correctamente.