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 del MCP para conectar tu aplicación de agente con un servidor del 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 bien otros SDKs de terceros confiables, 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 del MCP tienen las mismas opciones de autenticación que las herramientas de OpenAPI.
Encabezados personalizados
Puedes proporcionar encabezados HTTP personalizados para que se envíen en las solicitudes al servidor de MCP. También puedes insertar variables del contexto de la sesión en estos encabezados. Para obtener más información, consulta Variables de contexto de sesión.
Prueba el servidor de MCP de forma independiente
Antes de conectar tus agentes al servidor de MCP, te recomendamos que pruebes el servidor de MCP 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 conexiones de MCP de forma nativa). Esto garantiza que el servidor esté en funcionamiento y que se comprenda la información de autenticación necesaria para comunicarse con él.
Encabezados personalizados
Puedes definir encabezados personalizados que se incluyen cuando se envían solicitudes HTTP al servidor de MCP (solicitudes de lista de herramientas y ejecución de herramientas). Los valores de estos encabezados deben proporcionarse a través de variables, por lo que, para definir un encabezado personalizado, primero debes definir una variable que contenga el valor del encabezado. Si una variable no contiene un valor y no hay un valor predeterminado en el tiempo de ejecución, el encabezado no se incluirá en las solicitudes.
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.
- De forma opcional, define encabezados personalizados proporcionando nombres de encabezados y variables que se usan como valores de encabezado.
- 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.