Conecte-se ao servidor MCP do desenvolvedor do Google Pay e da Carteira

O servidor MCP para desenvolvedores do Google Pay e da Carteira do Google permite que ferramentas de desenvolvimento com tecnologia de IA acessem seus dados de desenvolvedor do Google Pay e da Carteira do Google, pesquisem documentação oficial e gerenciem suas integrações.

O Protocolo de Contexto de Modelo (MCP) padroniza a conexão de modelos de linguagem grandes (LLMs) e aplicativos ou agentes de IA com fontes de dados externas. Com os servidores do MCP, é possível usar as ferramentas, os recursos e os comandos deles para realizar ações e receber dados atualizados do serviço de back-end.

Com o servidor MCP para desenvolvedores do Google Pay e da Carteira, você pode:

  • Documentação da pesquisa: receba orientações atualizadas e exemplos de código dos documentos oficiais do Google Pay e da Carteira do Google.
  • Gerenciar integrações: verifique o status das suas integrações e ative as APIs na sua conta do comerciante.
  • Monitorar o desempenho: acesse dados agregados de desempenho e métricas de erro da sua conta de comerciante.
  • Gerenciar cartões: lista emissores e classes de cartões para a Carteira do Google.

Comandos de amostra

Você pode usar os seguintes comandos com seu assistente de IA:

  • "Liste minhas contas do Google Pay."
  • "Qual é o status das minhas integrações do Google Pay?"
  • "Como posso integrar o Google Pay ao React?"
  • "Mostre as métricas de erro do Google Pay para minha integração nos últimos 30 dias."
  • "Liste minhas classes de cartão da Carteira do Google."

Antes de começar

Para usar o servidor MCP do desenvolvedor do Google Pay e da Carteira, crie um projeto na nuvem do Google e ative o servidor MCP do desenvolvedor do Google Pay e da Carteira e as APIs Google Wallet.

  1. No console do Cloud, na página do seletor de projetos, selecione ou crie um projeto na nuvem do Google Cloud.

    Acessar o seletor de projetos

  2. Ative as APIs Pay & Wallet Developer e Google Wallet.

    Funções necessárias para ativar APIs

    Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

    Ativar as APIs

Funções exigidas

Para receber as permissões necessárias para usar o servidor MCP remoto do Google Pay e da Carteira do Desenvolvedor, peça ao administrador para conceder a você os seguintes papéis de Identity and Access Management (IAM) no projeto do Google Cloud em que você quer ativar o servidor MCP do Google Pay e da Carteira do Desenvolvedor:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Autenticação e autorização

Os servidores MCP do Google Pay e da Carteira do Google para desenvolvedores usam o protocolo OAuth 2.0 com o gerenciamento de identidade e acesso (IAM) para autenticação e autorização. Todas as identidades são compatíveis com a autenticação em servidores MCP.

O servidor MCP do desenvolvedor do Google Pay e da Carteira não aceita chaves de API.

Recomendamos criar uma identidade separada para agentes que usam ferramentas do MCP. Assim, é possível controlar e monitorar o acesso aos recursos. Para mais informações sobre autenticação, consulte Autenticar em servidores MCP.

Escopos do OAuth do servidor MCP para desenvolvedores do Google Pay e da Carteira

O OAuth 2.0 usa escopos e credenciais para determinar se um principal autenticado está autorizado a realizar uma ação específica em um recurso. Para mais informações sobre os escopos do OAuth 2.0 no Google, leia Como usar o OAuth 2.0 para acessar as APIs do Google.

O servidor MCP do Google Pay e da Carteira para desenvolvedores tem os seguintes escopos OAuth da ferramenta MCP:

URI de escopo para a CLI gcloud Descrição
https://www.googleapis.com/auth/paydeveloper.merchant Gerenciar dados de comerciantes do Google Pay.
https://www.googleapis.com/auth/paydeveloper.issuer.readonly Ler dados do emissor da Carteira do Google.

Criar um ID e uma chave secreta do cliente OAuth 2.0

Para criar um ID e uma chave secreta do cliente OAuth 2.0, siga estas etapas:

  1. No console de APIs do Google, acesse Plataforma de autenticação do Google > Clientes > Criar cliente.

    Acesse "Criar cliente"

  2. Na lista Tipo de aplicativo, selecione o tipo adequado para seu aplicativo de IA:

    • Para Antigravity, Claude.ai, Claude Code e ChatGPT, selecione Aplicativo da Web.
    • Para a CLI do Gemini e o VS Code, selecione App para computador.
  3. No campo Nome, insira um nome para o aplicativo.

  4. Se você selecionou Aplicativo da Web, na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e adicione o URI de redirecionamento necessário para seu aplicativo de IA:

    Antigravity

    https://antigravity.google/oauth-callback

    Claude.ai

    https://claude.ai/api/mcp/auth_callback

    Claude Code

    http://localhost:CLAUDE_REDIRECT_PORT/callback

    ChatGPT

    Por enquanto, deixe o campo redirect_uri em branco. O ChatGPT gera um redirect_uri quando o app é criado. Consulte Configurar seu aplicativo de IA abaixo.

  5. Clique em Criar. Após a criação, a chave secreta do cliente é exibida uma vez. Copie e armazene com segurança.

Configurar seu aplicativo de IA

Em seguida, forneça ao aplicativo de IA os detalhes da configuração do servidor.

CLI do Gemini

  1. Para configurar a CLI do Gemini, adicione o seguinte ao arquivo `~/.gemini/settings.json`:

    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "httpUrl": "https://paydeveloper.googleapis.com/mcp",
          "authProviderType": "dynamic_discovery",
          "oauth": {
            "enabled": true,
            "clientId": "GEMINI_CLI_CLIENT_ID",
            "clientSecret": "GEMINI_CLI_CLIENT_SECRET",
            "scopes": [
              "https://www.googleapis.com/auth/paydeveloper.merchant",
              "https://www.googleapis.com/auth/paydeveloper.issuer.readonly"
            ]
          }
        }
      }
    }
  2. Execute /mcp auth google-pay-wallet-dev para iniciar o processo de autenticação do servidor MCP do Google Pay e da Carteira para desenvolvedores.

Antigravity

Para configurar o Antigravity para usar o servidor MCP:

  1. No Antigravity, clique no menu Outras opções no painel Agente > Servidores MCP > Gerenciar servidores MCP.
  2. Na parte de cima do painel "Gerenciar servidores MCP", clique em Ver configuração bruta para editar o arquivo mcp_config.json:
    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "serverUrl": "https://paydeveloper.googleapis.com/mcp",
          "oauth": {
            "clientId": "ANTIGRAVITY_CLIENT_ID",
            "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
          }
        }
      }
    }
  3. Volte para Gerenciar servidores MCP e clique em Atualizar. Ao clicar em Autenticar, a guia Personalizações é aberta em Configurações do agente.
  4. Clique em Autenticar e conclua o fluxo do OAuth.
  5. Copie o código de autorização e envie-o na janela Configurações do agente.

VS Code

  1. Para configurar o VS Code (Copilot), edite o arquivo .vscode/mcp.json no seu espaço de trabalho:
    {
      "servers": {
        "google-pay-wallet-dev": {
          "url": "https://paydeveloper.googleapis.com/mcp"
        }
      }
    }
  2. Chame uma ferramenta no servidor MCP para acionar o processo de autenticação. Por exemplo: "Liste minhas contas do Google Pay".
  3. A caixa de diálogo Registro dinâmico de clientes indisponível é aberta conforme o esperado. Clique em qualquer botão para fechar a caixa de diálogo.
  4. Insira seu ID do cliente OAuth e pressione "Enter".
  5. Quando solicitado, digite sua chave secreta do cliente OAuth e pressione Enter.
  6. Uma caixa de diálogo para autenticação será aberta. Clique em Permitir.
  7. Depois de autorizar, a ferramenta é chamada e a sessão continua na janela de chat.

Claude.ai

Para configurar o Claude.ai:

  1. Acesse Personalizar > Conectores.
  2. Clique no botão e escolha Adicionar conector personalizado.
  3. Insira os seguintes detalhes:
      Nome do servidor: Google Pay & Wallet MCP.
      URL do servidor MCP remoto https://paydeveloper.googleapis.com/mcp.
  4. Em Configurações avançadas, insira o ID do cliente OAuth e a chave secreta do cliente OAuth.
  5. Selecione o novo conector e clique em Conectar.

Claude Code

Para configurar o Claude Code, execute o seguinte comando:

MCP_CLIENT_SECRET=CLAUDE_CODE_CLIENT_SECRET claude mcp add --transport http \
  --client-id CLAUDE_CODE_CLIENT_ID --client-secret --callback-port CLAUDE_REDIRECT_PORT \
  google-pay-wallet-dev https://paydeveloper.googleapis.com/mcp

ChatGPT

Para configurar o ChatGPT:

  1. Ative o Modo desenvolvedor em Configurações > Apps > Configurações avançadas.
  2. Clique no botão Criar app.
  3. Digite os seguintes detalhes:
      Nome: Google Pay & Wallet MCP.
      URL do servidor MCP: https://paydeveloper.googleapis.com/mcp
  4. Acesse Configurações avançadas e insira o ID e a chave secreta do cliente OAuth.
  5. Copie o URL de retorno de chamada dinâmico e adicione-o ao cliente OAuth criado na etapa anterior.

Limitações conhecidas

  • Resultados apenas em inglês: a pesquisa na documentação só está disponível em inglês.
  • Conteúdo por trás da ACL: a documentação por trás das ACLs não é indexada.
  • Dependente da rede: o servidor exige uma conexão ativa com os serviços do Google Pay e da Carteira.

Termos de Serviço

O uso da API Google Pay está sujeito aos Termos de Serviço da API Google Pay. O uso da API Google Wallet está sujeito aos Termos de Serviço da API Google Wallet.