Um servidor do Protocolo de Contexto de Modelo (MCP) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos para um modelo de linguagem grande (LLM) 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 de usar. 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.
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 para desenvolvedores do Google Pay e da Carteira do Google tem o seguinte endpoint global:
- 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.
Ferramentas
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 do Google Pay e da Carteira do Google e exemplos de código. |
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. |
create_merchant |
Cria um novo comerciante com a conta autenticada. É NECESSÁRIO pedir ao usuário que forneça as informações necessárias para a criação do comerciante. 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. |
create_google_pay_integration |
Cria uma integração do Google Pay para um comerciante específico. Essa operação exige que o usuário tenha aceitado os Termos de Serviço do Business Console e os Termos de Serviço da API Google Pay. Não é necessário verificar isso de forma preventiva. Se eles não tiverem sido aceitos, a chamada da ferramenta vai falhar, e a mensagem de erro vai conter os URLs específicos dos Termos de Serviço que precisam ser aceitos. Se isso ocorrer, apresente os URLs ao usuário para aceitação e instrua-o a tentar novamente depois de aceitos. Siga esta sequência para interagir com o usuário ANTES de chamar a ferramenta: 1. Primeiro, peça ao usuário o item de integração (no momento, apenas a integração da Web é compatível). - Peça o URL do site. # - Se o item de integração for a integração do app, peça o nome do pacote do app Android. 2. Em seguida, peça ao usuário o tipo de integração: - Diga ao usuário para escolher "Gateway" se ele usar um dos nossos provedores de serviços de pagamento (PSPs) compatíveis (https://developers.google.com/pay/api#participating-processors). Caso contrário, escolha "Direto". 3. Para TODOS os tipos de integração (direta ou gateway): - Diga ao usuário para fazer upload de capturas de tela (máximo de 1 MB) do fluxo de compra integrado à API Google Pay. O fluxo de compra precisa ser revisado e aprovado antes que o usuário receba acesso total de produção. Exemplos: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - É NECESSÁRIO pedir ao usuário que forneça cinco capturas de tela de suporte. Peça-as UMA POR UMA para garantir o mapeamento correto. Use APENAS as descrições de enumeração fáceis de usar ao perguntar. 4. Se o tipo de integração for "Direto": - Você TAMBÉM PRECISA pedir ao usuário que forneça o documento de atestado de PCI em formato PDF. Use APENAS a descrição de enumeração fácil de usar ao perguntar. 5. Para cada arquivo fornecido, peça ao usuário o caminho ou o nome do documento, se estiver no diretório atual. Mapeie-o para o DocumentType correto e defina o campo "name" como um nome descritivo (por exemplo, item_selection.png ou pci_attestation.pdf) na solicitação. Não chame essa ferramenta até tentar coletar os documentos necessários para o tipo de integração selecionado. |
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 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 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 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 }' |