MCP Reference: ces.googleapis.com

Un servidor del Protocolo de contexto del modelo (MCP) actúa como proxy entre un servicio externo que proporciona contexto, datos o capacidades a un modelo de lenguaje grande (LLM) o una aplicación de IA. Los servidores de MCP conectan las aplicaciones de IA a sistemas externos, como bases de datos y servicios web, y traducen sus respuestas a un formato que la aplicación de IA pueda comprender.

Configuración del servidor

Antes de usar los servidores de MCP, debes habilitarlos y configurar la autenticación. Para obtener más información sobre el uso de los servidores de MCP remotos de Google y Google Cloud, consulta Descripción general de los servidores de MCP de Google Cloud.

Servidor de MCP para la API de Gemini Enterprise for Customer Experience

Extremos del servidor

Un extremo de servicio de MCP es la dirección de red y la interfaz de comunicación (por lo general, una URL) del servidor de MCP que una aplicación de IA (el host para el cliente de MCP) usa para establecer una conexión segura y estandarizada. Es el punto de contacto para que el LLM solicite contexto, llame a una herramienta o acceda a un recurso. Los extremos de MCP de Google pueden ser globales o regionales.

El servidor de MCP de ces.googleapis.com tiene el siguiente extremo de MCP:

  • https://ces.[REGION].rep.googleapis.com/mcp

Herramientas de MCP

Una herramienta de MCP es una función o capacidad ejecutable que un servidor de MCP expone a un LLM o una aplicación de IA para realizar una acción en el mundo real.

El servidor de MCP de ces.googleapis.com tiene las siguientes herramientas:

Herramientas de MCP
list_apps Enumera las apps en el proyecto y la ubicación determinados.
get_app Obtiene detalles de la app especificada.
create_app Crea una app nueva en el proyecto y la ubicación especificados.
update_app Actualiza la app especificada. Asegúrate de pasar siempre una máscara de actualización en la entrada.
delete_app Borra la app especificada.
list_agents Enumera los agentes de la app especificada.
get_agent Obtiene detalles del agente especificado.
create_agent Crea un agente nuevo en la app especificada.
update_agent Actualiza el agente especificado. Asegúrate de pasar siempre una máscara de actualización en la entrada.
delete_agent Borra el agente especificado.
list_tools Enumera las herramientas de la app especificada.
get_tool Obtiene detalles de la herramienta especificada.
create_tool Crea una herramienta nueva en la app especificada.
update_tool Actualiza la herramienta especificada. Asegúrate de pasar siempre una máscara de actualización en la entrada.
delete_tool Borra la herramienta especificada.
list_guardrails Enumera los parámetros de protección de la app especificada.
get_guardrail Obtiene detalles sobre la protección especificada.
create_guardrail Crea una nueva protección en la app especificada.
update_guardrail Actualiza la protección especificada. Asegúrate de pasar siempre una máscara de actualización en la entrada.
delete_guardrail Borra la protección especificada.
list_deployments Enumera las implementaciones en la app especificada.
get_deployment Obtiene detalles de la implementación especificada.
create_deployment Crea una implementación nueva en la app especificada.
update_deployment Actualiza la implementación especificada. Asegúrate de pasar siempre una máscara de actualización en la entrada.
delete_deployment Borra la implementación especificada.
list_toolsets Enumera los conjuntos de herramientas de la app especificada.
get_toolset Obtiene detalles del conjunto de herramientas especificado.
create_toolset Crea un nuevo conjunto de herramientas en la app especificada.
update_toolset Actualiza el conjunto de herramientas especificado. Asegúrate de pasar siempre una máscara de actualización en la entrada.
delete_toolset Borra el conjunto de herramientas especificado.
list_app_versions Enumera todas las versiones de la app especificada.
get_app_version Obtiene detalles de la versión de la app especificada.
create_app_version Crea una versión nueva de la app en la app especificada.
delete_app_version Borra la versión de la app especificada.
restore_app_version Restablece la versión de la app especificada.
list_changelogs Enumera los registros de cambios de la app especificada.
get_changelog Obtiene detalles del registro de cambios especificado.
start_export_app Comienza a exportar una app de CES
start_import_app Comienza a importar una app de CES
run_evaluation Ejecuta una evaluación para una app de CES
create_evaluation Crea una evaluación nueva.
create_evaluation_dataset Crea un conjunto de datos de evaluación nuevo.
delete_evaluation Borra la evaluación especificada.
delete_evaluation_dataset Borra el conjunto de datos de evaluación especificado.
generate_evaluation_from_conversation Genera una evaluación a partir de una conversación.
get_evaluation Obtiene detalles de la evaluación especificada.
get_evaluation_dataset Obtiene detalles del conjunto de datos de evaluación especificado.
get_evaluation_result Obtiene detalles del resultado de la evaluación especificado.
get_evaluation_run Obtiene detalles de la ejecución de evaluación especificada.
list_evaluation_datasets Enumera los conjuntos de datos de evaluación.
list_evaluation_results Enumera los resultados de la evaluación.
list_evaluation_runs Enumera las ejecuciones de evaluación.
list_evaluations Enumera las evaluaciones.
update_evaluation Actualiza la evaluación especificada. Asegúrate de pasar siempre una máscara de actualización en la entrada.
update_evaluation_dataset Actualiza el conjunto de datos de evaluación especificado. Asegúrate de pasar siempre una máscara de actualización en la entrada.
delete_evaluation_result Borra el resultado de la evaluación especificado.
delete_evaluation_run Borra la ejecución de evaluación especificada.
get_conversation Obtiene detalles de la conversación especificada.
list_conversations Enumera las conversaciones.
get_operation

Obtiene el estado de una operación de larga duración.

Uso Algunas herramientas (por ejemplo, run_evaluation) muestran una operación de larga duración. Puedes usar esta herramienta para obtener el estado de la operación. Se puede llamar a este método de forma repetida para sondear el estado de una operación de larga duración.

Parámetros * name: Es el nombre de la operación que se obtendrá. * name debe ser el nombre que devolvió la herramienta que inició la operación. * name debe tener el formato projects/{project}/locations/{location}/operations/{operation}.

Obtén las especificaciones de la herramienta de MCP

Para obtener las especificaciones de las herramientas de MCP para todas las herramientas en un servidor de MCP, usa el método tools/list. En el siguiente ejemplo, se muestra cómo usar curl para enumerar todas las herramientas y sus especificaciones disponibles actualmente en el servidor de MCP.

Solicitud de Curl
                      curl --location 'https://ces.[REGION].rep.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'