MCP Reference: ces.googleapis.com

Servidor MCP para a API Gemini Enterprise for Customer Experience.

Um servidor do Protocolo de Contexto de Modelo (MCP) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos a um modelo de linguagem grande (LLM) ou aplicativo de IA. Os servidores MCP conectam aplicativos de IA a sistemas externos, como bancos de dados e serviços da Web, traduzindo as respostas em um formato que o aplicativo de IA possa entender.

Configuração do servidor

É preciso ativar os servidores MCP e configurar a autenticação antes de usar. Para mais informações sobre como usar servidores MCP remotos do Google e do Google Cloud, consulte Visão geral dos servidores MCP do Google Cloud.

Endpoints de servidor

Um endpoint de serviço do MCP é o endereço de rede e a interface de comunicação (geralmente um URL) do servidor MCP que um aplicativo de IA (o host do cliente do MCP) usa para estabelecer uma conexão segura e padronizada. É o ponto de contato para o LLM solicitar contexto, chamar uma ferramenta ou acessar um recurso. Os endpoints do Google MCP podem ser globais ou regionais.

O servidor MCP da API Gemini Enterprise for Customer Experience tem o seguinte endpoint global do MCP:

• https://ces.googleapis.com/mcp

Ferramentas do MCP

Uma ferramenta do MCP é uma função ou capacidade executável que um servidor MCP expõe a um LLM ou aplicativo de IA para realizar uma ação no mundo real.

Ferramentas

O servidor MCP ces.googleapis.com tem as seguintes ferramentas:

Ferramentas do MCP
list_apps	Lista os apps no projeto e local especificados.
get_app	Recebe detalhes do app especificado.
create_app	Cria um app no projeto e local especificados.
update_app	Atualiza o app especificado. Não se esqueça de sempre transmitir uma máscara de atualização na entrada.
delete_app	Exclui o app especificado.
list_agents	Lista os agentes no app especificado.
get_agent	Recebe detalhes do agente especificado.
create_agent	Cria um novo agente no app especificado.
update_agent	Atualiza o agente especificado. Sempre transmita uma máscara de atualização na entrada.
delete_agent	Exclui o agente especificado.
list_tools	Lista as ferramentas no app especificado.
get_tool	Recebe detalhes da ferramenta especificada.
create_tool	Cria uma nova ferramenta no app especificado.
update_tool	Atualiza a ferramenta especificada. Sempre transmita uma máscara de atualização na entrada.
delete_tool	Exclui a ferramenta especificada.
list_guardrails	Lista os mecanismos de proteção no app especificado.
get_guardrail	Recebe detalhes da proteção especificada.
create_guardrail	Cria uma nova proteção no app especificado.
update_guardrail	Atualiza a proteção especificada. Sempre transmita uma máscara de atualização na entrada.
delete_guardrail	Exclui o guardrail especificado.
list_deployments	Lista as implantações no app especificado.
get_deployment	Recebe detalhes da implantação especificada.
create_deployment	Cria uma nova implantação no app especificado.
update_deployment	Atualiza a implantação especificada. Sempre transmita uma máscara de atualização na entrada.
delete_deployment	Exclui a implantação especificada.
list_toolsets	Lista os conjuntos de ferramentas no app especificado.
get_toolset	Recebe detalhes do conjunto de ferramentas especificado.
create_toolset	Cria um novo conjunto de ferramentas no app especificado.
update_toolset	Atualiza o conjunto de ferramentas especificado. Sempre transmita uma máscara de atualização na entrada.
delete_toolset	Exclui o conjunto de ferramentas especificado.
list_app_versions	Lista todas as versões do app especificado.
get_app_version	Recebe detalhes da versão do app especificada.
create_app_version	Cria uma nova versão do app no app especificado.
delete_app_version	Exclui a versão especificada do app.
restore_app_version	Restaura a versão especificada do app.
list_changelogs	Lista os registros de alterações no app especificado.
get_changelog	Recebe detalhes do changelog especificado.
start_export_app	Começa a exportar um app do CES.
start_import_app	Inicia a importação de um app do CES.
run_evaluation	Executa uma avaliação para um app da CES.
create_evaluation	Cria uma nova avaliação.
create_evaluation_dataset	Cria um conjunto de dados de avaliação.
delete_evaluation	Exclui a avaliação especificada.
delete_evaluation_dataset	Exclui o conjunto de dados de avaliação especificado.
generate_evaluation_from_conversation	Gera uma avaliação com base em uma conversa.
get_evaluation	Recebe detalhes da avaliação especificada.
get_evaluation_dataset	Recebe detalhes do conjunto de dados de avaliação especificado.
get_evaluation_result	Recebe detalhes do resultado da avaliação especificada.
get_evaluation_run	Recebe detalhes da execução de avaliação especificada.
list_evaluation_datasets	Lista conjuntos de dados de avaliação.
list_evaluation_results	Lista os resultados da avaliação.
list_evaluation_runs	Lista execuções de avaliação.
list_evaluations	Lista as avaliações.
update_evaluation	Atualiza a avaliação especificada. Sempre transmita uma máscara de atualização na entrada.
update_evaluation_dataset	Atualiza o conjunto de dados de avaliação especificado. Não se esqueça de sempre transmitir uma máscara de atualização na entrada.
delete_evaluation_result	Exclui o resultado da avaliação especificado.
delete_evaluation_run	Exclui a execução de avaliação especificada.
get_conversation	Recebe detalhes da conversa especificada.
list_conversations	Lista conversas.
get_operation	Recebe o status de uma operação de longa duração. Uso: algumas ferramentas (por exemplo, run_evaluation) retornam uma operação de longa duração. Use essa ferramenta para saber o status da operação. Ela pode ser chamada repetidamente para pesquisar o status de uma operação de longa duração. Parâmetros * name: o nome da operação a ser recebida. * name precisa ser o nome retornado pela ferramenta que iniciou a operação. * name precisa estar no formato projects/{project}/locations/{location}/operations/{operation}.

Receber especificações da ferramenta MCP

Para receber as especificações de ferramentas do MCP de todas as ferramentas em um servidor MCP, use o método tools/list. O exemplo a seguir demonstra como usar curl para listar todas as ferramentas e especificações disponíveis no servidor MCP.

Solicitação curl
curl --location 'https://ces.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }'