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

Visualizar

Este produto está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições da fase de lançamento.

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 a forma como modelos de linguagem grandes (LLMs) e 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 a performance: acesse dados de performance 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.

  **Observação**: consulte a referência do Pay & Wallet Developer para conferir detalhes das ferramentas MCP disponíveis e as descrições delas.

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 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.

   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 a função Proprietário (roles/owner). Caso contrário, você pode receber essa permissão pela função Administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin). Saiba como conceder funções.

   Ativar a API

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ê as seguintes funções do Identity and Access Management (IAM) no projeto do Google Cloud em que você quer ativar o servidor MCP do Google Pay &Wallet Developer:

• Fazer chamadas de ferramentas MCP: Usuário da ferramenta MCP (roles/mcp.toolUser)

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

Autenticação e autorização

O servidor MCP do Google Pay & Wallet Developer usa 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 Plataforma de autenticação do Google > Clientes > Criar cliente.

   Acessar "Criar cliente"

   Você precisará criar um novo aplicativo na plataforma de autenticação do Google se ainda não tiver um. Clique no botão "Começar" na página de visão geral e preencha as informações necessárias.

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 CLI do Antigravity, IDE do Antigravity e 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

   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).

   Observação: na seção Origens JavaScript autorizadas, clique em + Adicionar URI e adicione https://chatgpt.com no campo URIs.

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

VS Code

1. Clique no ícone na parte de cima do painel lateral do chat e navegue até Servidores MCP.
2. Clique no botão Adicionar servidor (), selecione HTTP e insira o URL que aponta para o servidor MCP do Pay & Wallet Developer: https://paydeveloper.googleapis.com/mcp.
   Sua 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 é aberta conforme o esperado. Clique em qualquer botão para fechar a caixa de diálogo.
6. Insira o ID do cliente OAuth e pressione Enter.
7. Quando solicitado, insira a chave secreta do cliente OAuth e pressione Enter.
8. Uma caixa de diálogo para autenticação é aberta. Clique em Permitir.
9. Você pode escolher uma lista de identidades autenticadas ou fazer login com uma nova conta.
10. Após a autenticação, a ferramenta é chamada e a sessão continua em a 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 de configuração para adicionar o servidor MCP do Google Pay &Wallet Developer:

   {
     "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 de autenticação.

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. Navegue até 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 de desenvolvedor em Configurações > Segurança e login.
2. Selecione Plug-ins 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 callback 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 seu ~/.gemini/config/mcp_config.json arquivo:

   {
     "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 o 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 o código de autorização e envie-o na janela Antigravity Configurações.

Antigravity

1. No Antigravity, acesse as configurações 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 ao Antigravity e clique em Atualizar.
4. Clique em Autenticar e conclua o fluxo de autenticação.
5. Copie o código de autorização e envie-o na janela Antigravity Configurações.

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.