Este é um servidor MCP que fornece ferramentas para desenvolvedores do Pay.
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 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
Você precisa 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 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 MCP que um aplicativo de IA (o host do cliente 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 MCP da API do servidor MCP do Google Pay e da Carteira do Google tem o seguinte endpoint global do MCP:
- https://paydeveloper.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 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 do Google Pay e da Carteira do Google e exemplos de código. |
list_merchants |
Recupera uma lista abrangente de todos os comerciantes do Google Pay associados à conta autenticada. Dependendo do papel do usuário em um comerciante, os administradores podem visualizar informações detalhadas completas, enquanto os desenvolvedores só podem visualizar informações básicas. |
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. Além disso, você PRECISA informar ao usuário que a integração pode ser criada/atualizada no Console do Google Pay e da Carteira (https://pay.google.com/business/console/). |
create_merchant |
Cria um novo comerciante com a conta autenticada. Você PRECISA pedir ao usuário que forneça as informações necessárias para a criação do comerciante. Um dos campos obrigatórios é o Código de categoria do comerciante (MCC, na sigla em inglês). Como a lista de MCCs é longa, você pode apresentar um subconjunto de opções comuns, mas PRECISA informar ao usuário que mais opções estão disponíveis e que ele pode pedir a lista completa (por exemplo, mostrando "Mais X opções" ou uma dica semelhante). Além disso, informe ao usuário que ele pode fornecer diretamente o código MCC de 4 dígitos (por exemplo, 5499) se já o conhecer e incentive o uso. Não chame essa ferramenta até tentar coletar as informações necessárias para a criação do comerciante. Depois que o comerciante for criado, você PRECISA apresentar o URL dos Termos de Serviço do Business Console ao usuário e instruí-lo a aceitá-lo antes de realizar qualquer operação nesse comerciante. |
list_pass_issuers |
Recupera uma lista abrangente de todos os emissores de cartões registrados no Business Console 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 Business Console 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. |
validate_pass_jwt |
Valida a representação JWT de um cartão ou o payload JWT não codificado como uma string JSON para um cartão. |
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 comercial de comerciante específico. Essa ferramenta fornece um detalhamento granular de erros, permitindo que os desenvolvedores identifiquem e resolvam problemas. |
update_merchant |
Atualiza campos específicos de um comerciante existente. Os campos aceitos incluem display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email e customer_support_phone. |
list_principals |
Lista os principais (usuários) que têm acesso a um comerciante específico. Essa operação requer acesso de administrador para o comerciante. |
set_principal_role |
Define o papel de um principal (usuário) em um comerciante ou adiciona um novo principal com o papel especificado. O principal recebe um convite por e-mail e precisa aceitá-lo antes que o acesso seja ativado. Essa operação requer acesso de administrador para o comerciante. |
delete_principal |
Exclui o acesso de um principal (usuário) a um comerciante específico. Essa operação requer acesso de administrador para o comerciante. |
Receber especificações da ferramenta MCP
Para receber as especificações da ferramenta 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 momento no servidor 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 }' |