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.
-
No console do Cloud, na página do seletor de projetos, selecione ou crie um projeto na nuvem do Google Cloud.
-
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ãoserviceusage.services.enable. Saiba como conceder papéis.
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:
- Fazer chamadas de ferramentas do MCP: Usuário da ferramenta MCP
(
roles/mcp.toolUser)
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:
-
No console de APIs do Google, acesse Plataforma de autenticação do Google > Clientes > Criar cliente.
-
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.
No campo Nome, insira um nome para o aplicativo.
-
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-callbackClaude.ai
https://claude.ai/api/mcp/auth_callbackClaude Code
http://localhost:CLAUDE_REDIRECT_PORT/callback
ChatGPT
Por enquanto, deixe o campo
redirect_uriem branco. O ChatGPT gera umredirect_uriquando o app é criado. Consulte Configurar seu aplicativo de IA abaixo. 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
-
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" ] } } } }
-
Execute
/mcp auth google-pay-wallet-devpara 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:
- No Antigravity, clique no menu Outras opções no painel Agente > Servidores MCP > Gerenciar servidores MCP.
-
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" } } } }
- Volte para Gerenciar servidores MCP e clique em Atualizar. Ao clicar em Autenticar, a guia Personalizações é aberta em Configurações do agente.
- Clique em Autenticar e conclua o fluxo do OAuth.
- Copie o código de autorização e envie-o na janela Configurações do agente.
VS Code
-
Para configurar o VS Code (Copilot), edite o arquivo
.vscode/mcp.jsonno seu espaço de trabalho:{ "servers": { "google-pay-wallet-dev": { "url": "https://paydeveloper.googleapis.com/mcp" } } }
- Chame uma ferramenta no servidor MCP para acionar o processo de autenticação. Por exemplo: "Liste minhas contas do Google Pay".
- 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.
- Insira seu ID do cliente OAuth e pressione "Enter".
- Quando solicitado, digite sua chave secreta do cliente OAuth e pressione Enter.
- Uma caixa de diálogo para autenticação será aberta. Clique em Permitir.
- Depois de autorizar, a ferramenta é chamada e a sessão continua na janela de chat.
Claude.ai
Para configurar o Claude.ai:
- Acesse Personalizar > Conectores.
- Clique no botão e escolha Adicionar conector personalizado.
-
Insira os seguintes detalhes:
-
Nome do servidor:
Google Pay & Wallet MCP.-
URL do servidor MCP remoto
https://paydeveloper.googleapis.com/mcp. - Em Configurações avançadas, insira o ID do cliente OAuth e a chave secreta do cliente OAuth.
- 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:
- Ative o Modo desenvolvedor em Configurações > Apps > Configurações avançadas.
- Clique no botão Criar app.
-
Digite os seguintes detalhes:
-
Nome:
Google Pay & Wallet MCP.-
URL do servidor MCP:
https://paydeveloper.googleapis.com/mcp - Acesse Configurações avançadas e insira o ID e a chave secreta do cliente OAuth.
- 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.