Um servidor do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos para um modelo de linguagem grande (LLM, na sigla em inglês) ou um 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
É necessário ativar os servidores do MCP e configurar a autenticação antes do uso. Para mais informações sobre como usar servidores do MCP remotos do Google e do Google Cloud, consulte Visão geral dos servidores do MCP do Google Cloud.
Este é um servidor do MCP que fornece ferramentas para desenvolvedores do Pay.
Endpoints do 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 MCP do Google podem ser globais ou regionais.
O servidor do MCP paydeveloper.googleapis.com tem o seguinte endpoint do MCP:
- https://paydeveloper.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 do MCP paydeveloper.googleapis.com tem as seguintes ferramentas:
| Ferramentas do MCP | |
|---|---|
| search_documentation | Pesquisa e recupera as seções mais relevantes e atualizadas da documentação oficial para desenvolvedores e exemplos de código do Google Pay e da Carteira do Google. |
| list_merchants | Recupera uma lista de todos os perfis de empresas de comerciantes do Google Pay associados à conta autenticada. |
| list_google_pay_integrations | Retorna o status atual e os detalhes de configuração de todas as integrações do Google Pay associadas a um ID de comerciante específico. Ele fornece feedback imediato sobre o status da integração e das revisões de documentos. |
| enable_google_pay_api | Ativa a Google Pay API para uma conta de comerciante recém-criada ou existente. Esse é um pré-requisito antes de adicionar integrações específicas da plataforma (Web ou Android). |
| list_pass_issuers | Recupera uma lista abrangente de todos os emissores de cartões registrados no console empresarial da Carteira do Google associados ao usuário autenticado. Essa ferramenta fornece informações essenciais para desenvolvedores que gerenciam cartões da Carteira, como cartões de fidelidade, vales-presente ou voos. |
| list_pass_classes | Recupera uma lista abrangente de todas as classes de cartões registradas no console empresarial da Carteira do Google associadas ao usuário autenticado. Essa ferramenta fornece informações essenciais para desenvolvedores que gerenciam cartões da Carteira, como cartões de fidelidade, vales-presente ou voos. |
| query_merchant_performance | Recupera dados de performance agregados de alto nível e métricas pós-integração para um perfil comercial de comerciante específico. |
| query_merchant_error_metrics | Recupera métricas de erro detalhadas para um perfil de empresa de comerciante específico. Essa ferramenta fornece um detalhamento granular dos erros, permitindo que os desenvolvedores identifiquem e resolvam problemas. |
Receber especificações de ferramentas do MCP
Para receber as especificações de ferramentas do MCP de 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 momento no servidor do MCP.
| Solicitação curl |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |