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 MCP, você usa 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:

  • Pesquisar documentação: receba orientações atualizadas e exemplos de código nos documentos oficiais do Google Pay e da Carteira do Google.
  • Gerenciar integrações: verifique o status das suas integrações e ative APIs para sua conta do comerciante.
  • Monitorar a performance: acesse dados agregados de performance e métricas de erro da sua conta do comerciante.
  • Gerenciar cartões: lista de 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 Google Pay & Wallet Developer, crie um projeto do Google Cloud e ative o servidor MCP do Google Pay & Wallet Developer.

  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 a API Pay & Wallet Developer, se ela ainda não estiver ativada.

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão com o papel de Proprietário (roles/owner). Caso contrário, é possível receber essa permissão com o papel de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

    Ativar a API

Autenticação e autorização

O servidor MCP do desenvolvedor do Google Pay e da Carteira usa o protocolo OAuth 2.0 com o Identity and Access Management (IAM) para autenticação e autorização. Todas as identidades são compatíveis com a autenticação em servidores MCP.

O servidor MCP para desenvolvedores do Google Pay e da Carteira 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 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 Cursor Desktop, Claude Code, Claude.ai, ChatGPT e Antigravity, selecione Aplicativo da Web.
    • Para a CLI do Antigravity, o IDE do Antigravity e o VS Code, selecione Aplicativo 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:

    Cursor Desktop

    http://localhost:8787/callback

    Claude Code

    http://localhost:CLAUDE_REDIRECT_PORT/callback

    Claude.ai

    https://claude.ai/api/mcp/auth_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.

    Antigravity

    https://antigravity.google/oauth-callback

  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 da configuração do servidor.

VS Code

  1. Clique no ícone na parte de cima do painel lateral de chat e acesse Servidores MCP.
  2. Clique no botão Adicionar servidor (), selecione HTTP e insira o URL que aponta para o servidor MCP do desenvolvedor do Pay e Carteira: https://paydeveloper.googleapis.com/mcp.
    A configuração do MCP é salva no arquivo .vscode/mcp.json no seu espaço de trabalho:
    {
      "servers": {
        "google-pay-wallet-dev": {
          "url": "https://paydeveloper.googleapis.com/mcp"
        }
      }
    }
  3. Clique com o botão direito do mouse no novo servidor MCP e selecione Iniciar servidor.
  4. Volte para a janela de chat e chame uma ferramenta no servidor MCP para acionar o processo de autenticação. Por exemplo: "Liste minhas contas do Google Pay".
  5. A caixa de diálogo Registro Dinâmico de Clientes indisponível será aberta conforme o esperado. Clique em qualquer botão para fechar a caixa de diálogo.
  6. Insira seu ID do cliente OAuth e pressione Enter.
  7. Quando solicitado, insira sua chave secreta do cliente OAuth e pressione Enter.
  8. Uma caixa de diálogo de autenticação será aberta. Clique em Permitir.
  9. Você pode escolher em uma lista de identidades autenticadas ou fazer login com uma nova conta.
  10. Depois da autenticação, a ferramenta é chamada e a sessão continua na janela de chat.

Cursor Desktop

Para configurar o Cursor Desktop:

  1. Clique em Personalizar no painel lateral esquerdo.
  2. Clique em Novo servidor MCP. Isso abre o arquivo de configuração mcp.json.
  3. Insira os detalhes da configuração para adicionar o servidor MCP do Google Pay e da Carteira do Google para desenvolvedores:
    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "url": "https://paydeveloper.googleapis.com/mcp",
          "auth": {
            "CLIENT_ID": "CURSOR_DESKTOP_CLIENT_ID",
            "CLIENT_SECRET": "CURSOR_DESKTOP_CLIENT_SECRET"
          }
        }
      }
    }
  4. Ao salvar o arquivo, a lista de servidores MCP é atualizada.
  5. Clique em Autenticar para iniciar o processo.

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

Claude.ai

Para configurar o Claude.ai:

  1. Acesse Personalizar > Conectores.
  2. Clique em Adicionar 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.

ChatGPT

Para configurar o ChatGPT:

  1. Ative o Modo desenvolvedor em Configurações > Segurança e login.
  2. Selecione Plugins no painel lateral principal e clique no botão .
  3. Insira os seguintes detalhes:
      Nome: Google Pay & Wallet MCP.
      URL do servidor: 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.

CLI do Antigravity

  1. Para configurar a CLI do Antigravity, adicione o seguinte ao arquivo ~/.gemini/config/mcp_config.json:

    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "serverUrl": "https://paydeveloper.googleapis.com/mcp",
          "oauth": {
            "clientId": "AGY_CLI_CLIENT_ID",
            "clientSecret": "AGY_CLI_CLIENT_SECRET"
          }
        }
      }
    }
  2. Execute /mcp, selecione seu novo servidor MCP e escolha Autenticar para iniciar o processo de autenticação.

IDE do Antigravity

  1. Clique em na parte de cima do painel lateral do agente do editor e selecione Servidores MCP.
  2. Clique em Gerenciar servidores MCP.
  3. Clique em Ver configuração bruta e adicione os detalhes do servidor MCP:
    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "serverUrl": "https://paydeveloper.googleapis.com/mcp",
          "oauth": {
            "clientId": "ANTIGRAVITY_IDE_CLIENT_ID",
            "clientSecret": "ANTIGRAVITY_IDE_CLIENT_SECRET"
          }
        }
      }
    }
  4. Volte ao IDE do Antigravity e clique em Atualizar.
  5. Selecione o novo servidor MCP, clique em Autenticar e conclua o fluxo de autenticação.
  6. Copie e envie o código de autorização na janela Configurações do Antigravity.

Antigravity

  1. No Antigravity, acesse Configurações > Personalizações.
  2. Na seção Servidores MCP instalados, clique em Abrir configuração do MCP 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 Antigravity e clique em Atualizar.
  4. Clique em Autenticar e conclua o fluxo de autenticação.
  5. Copie e envie o código de autorização na janela Configurações do Antigravity.

Limitações conhecidas

  • Resultados apenas em inglês: a pesquisa na documentação só aceita 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.