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 do 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 remotos do MCP do Google e do Google Cloud, consulte Visão geral dos servidores do MCP no Google Cloud.
Servidor MCP para a API Gemini Enterprise for Customer Experience.
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 do 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 ces.googleapis.com tem o seguinte endpoint MCP:
- https://ces.[REGION].rep.googleapis.com/mcp
Ferramentas do MCP
Uma ferramenta do MCP é uma função ou capacidade executável que um servidor do MCP expõe a um LLM ou aplicativo de IA para realizar uma ação no mundo real.
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 novo 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 a proteção especificada. |
| 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 | Começa a importar 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, Parâmetros * |
Receber especificações da ferramenta MCP
Para receber as especificações de ferramentas do MCP para todas as ferramentas em um servidor do 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.[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 }' |