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.
-
No console do Cloud, na página do seletor de projetos, selecione ou crie um projeto na nuvem do Google Cloud.
-
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.
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:
-
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 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.
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:
Cursor Desktop
http://localhost:8787/callbackClaude Code
http://localhost:CLAUDE_REDIRECT_PORT/callback
Claude.ai
https://claude.ai/api/mcp/auth_callbackChatGPT
Por enquanto, deixe o campo
redirect_uriem branco. O ChatGPT gera umredirect_uriquando o app é criado. Consulte Configurar seu aplicativo de IA abaixo.Antigravity
https://antigravity.google/oauth-callback 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
- Clique no ícone na parte de cima do painel lateral de chat e acesse Servidores MCP.
-
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.jsonno seu espaço de trabalho:{ "servers": { "google-pay-wallet-dev": { "url": "https://paydeveloper.googleapis.com/mcp" } } }
- Clique com o botão direito do mouse no novo servidor MCP e selecione Iniciar servidor.
- 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".
- 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.
- Insira seu ID do cliente OAuth e pressione Enter.
- Quando solicitado, insira sua chave secreta do cliente OAuth e pressione Enter.
- Uma caixa de diálogo de autenticação será aberta. Clique em Permitir.
- Você pode escolher em uma lista de identidades autenticadas ou fazer login com uma nova conta.
- Depois da autenticação, a ferramenta é chamada e a sessão continua na janela de chat.
Cursor Desktop
Para configurar o Cursor Desktop:
- Clique em Personalizar no painel lateral esquerdo.
-
Clique em Novo servidor MCP. Isso abre o arquivo de configuração
mcp.json. -
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" } } } }
- Ao salvar o arquivo, a lista de servidores MCP é atualizada.
- 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:
- Acesse Personalizar > Conectores.
- Clique em Adicionar 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.
ChatGPT
Para configurar o ChatGPT:
- Ative o Modo desenvolvedor em Configurações > Segurança e login.
- Selecione Plugins no painel lateral principal e clique no botão .
-
Insira os seguintes detalhes:
-
Nome:
Google Pay & Wallet MCP.-
URL do servidor:
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.
CLI do Antigravity
-
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" } } } }
-
Execute
/mcp, selecione seu novo servidor MCP e escolha Autenticar para iniciar o processo de autenticação.
IDE do Antigravity
- Clique em na parte de cima do painel lateral do agente do editor e selecione Servidores MCP.
- Clique em Gerenciar servidores MCP.
-
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" } } } }
- Volte ao IDE do Antigravity e clique em Atualizar.
- Selecione o novo servidor MCP, clique em Autenticar e conclua o fluxo de autenticação.
- Copie e envie o código de autorização na janela Configurações do Antigravity.
Antigravity
- No Antigravity, acesse Configurações > Personalizações.
-
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" } } } }
- Volte para Antigravity e clique em Atualizar.
- Clique em Autenticar e conclua o fluxo de autenticação.
- 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.