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

O servidor MCP do Google Pay &Wallet Developer oferece às ferramentas de desenvolvimento com tecnologia de IA a capacidade de acessar seus dados de desenvolvedor do Google Pay e da Carteira do Google, pesquisar a documentação oficial e gerenciar suas integrações.

O Protocolo de Contexto de Modelo (MCP) padroniza como os modelos de linguagem grandes (LLMs) e os aplicativos ou agentes de IA se conectam a fontes de dados externas. Os servidores MCP permitem que você use as ferramentas, os recursos e os comandos deles para realizar ações e receber dados atualizados do serviço de back-end.

O servidor MCP do Google Pay &Wallet Developer permite:

  • Pesquisar documentação: receba orientações e exemplos de código atualizados da documentação oficial do Google Pay e da Carteira do Google.
  • Gerenciar integrações: verifique o status das suas integrações e ative as APIs da sua conta de comerciante.
  • Monitorar o desempenho: acesse dados de desempenho agregados e métricas de erro da sua conta de comerciante.
  • Gerenciar cartões: liste os emissores e as classes de cartões da 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ões da Carteira do Google."

Antes de começar

Para usar o servidor MCP do Google Pay &Wallet Developer, crie um projeto na nuvem do Google e ative o servidor MCP do Google Pay &Wallet Developer e as APIs do 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 do Pay &Wallet Developer e da Carteira do Google.

    Funções necessárias para ativar APIs

    Para ativar as APIs, é necessário ter o papel do IAM de administrador do Service Usage (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 &Wallet Developer, peça ao administrador para conceder a você os seguintes papéis do Identity and Access Management (IAM) no projeto na nuvem do Google Cloud em que você quer ativar o servidor MCP do Google Pay &Wallet Developer:

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 & Wallet Developer usam o OAuth 2.0 protocolo com Identity and Access Management (IAM) para autenticação e autorização. Todas as identidades são aceitas para autenticação em servidores MCP.

O servidor MCP do Google Pay &Wallet Developer não aceita chaves de API.

Recomendamos criar uma identidade separada para agentes que usam ferramentas MCP para que o acesso aos recursos possa ser controlado e monitorado. Para mais informações sobre autenticação, consulte Autenticar em servidores MCP.

Escopos do OAuth do servidor MCP do Google Pay &Wallet Developer

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 &Wallet Developer tem os seguintes escopos do OAuth da ferramenta MCP:

URI de escopo para a CLI gcloud Descrição
https://www.googleapis.com/auth/paydeveloper.merchant Gerenciar dados de comerciante 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 Google Auth Platform > Clients > Create client.

    Acessar "Criar cliente"

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

    • Para Antigravity, Claude.ai, Claude Code e ChatGPT, selecione Web application.
    • Para CLI do Gemini e VS Code, selecione Desktop app.
  3. No campo Name, insira um nome para o aplicativo.

  4. Se você selecionou Web application, na seção Authorized redirect URIs, clique em + Add 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

    Você pode deixar o redirect_uri em branco por enquanto. 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 é mostrada uma vez. Copie e armazene com segurança.

Configurar seu aplicativo de IA

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

CLI do Gemini

  1. Para configurar a CLI do Gemini, adicione o seguinte ao seu 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. Executar /mcp auth google-pay-wallet-dev para iniciar o processo de autenticação do servidor MCP do Google Pay & Wallet Developer.

Antigravity

Para configurar Antigravity para usar o servidor MCP:

  1. No Antigravity, clique no menu Additional options no painel do agente > MCP Servers > Manage MCP Servers.
  2. Na parte de cima do painel "Manage MCP Servers", clique View raw config para editar o mcp_config.json arquivo:
    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "serverUrl": "https://paydeveloper.googleapis.com/mcp",
          "oauth": {
            "clientId": "ANTIGRAVITY_CLIENT_ID",
            "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
          }
        }
      }
    }
  3. Volte para Manage MCP servers e clique em Refresh. Ao clicar em Authenticate, a guia Customizations é aberta em Agent Settings.
  4. Clique em Authenticate e conclua o fluxo do OAuth.
  5. Copie o código de autorização e envie-o na janela Agent Settings.

VS Code

  1. Para configurar o VS Code (Copilot), edite o .vscode/mcp.json arquivo 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 o ID do cliente OAuth e pressione Enter.
  5. Quando solicitado, insira a chave secreta do cliente OAuth e pressione Enter.
  6. Uma caixa de diálogo para autenticação é aberta. Clique em Permitir.
  7. Após a autorização, a ferramenta é chamada e a sessão continua em a janela de chat.

Claude.ai

Para configurar o Claude.ai:

  1. Navegue até Customize > Connectors.
  2. Clique no botão e escolha Add custom connector.
  3. Insira os seguintes detalhes:
      Server name: Google Pay & Wallet MCP.
      Remote MCP server URL https://paydeveloper.googleapis.com/mcp.
  4. Em Advanced settings , insira o ID do cliente OAuth e a chave secreta do cliente OAuth.
  5. Selecione o novo conector e clique em Connect.

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 de desenvolvedor em Configurações > Apps > Configurações avançadas.
  2. Clique no botão Criar app.
  3. Insira os seguintes detalhes:
      Nome: Google Pay & Wallet MCP.
      MCP server URL: 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 callback dinâmico e adicione-o ao cliente OAuth criado na etapa anterior.

Limitações conhecidas

  • Resultados apenas em inglês: a pesquisa de documentação só é compatível com inglês.
  • Conteúdo atrás da ACL: a documentação atrá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.