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.
-
No console do Cloud, na página do seletor de projetos, selecione ou crie um projeto na nuvem do Google Cloud.
-
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ã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 &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:
- Fazer chamadas de ferramentas 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 & 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:
-
No Console de APIs do Google, acesse Google Auth Platform > Clients > Create client.
-
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.
No campo Name, insira um nome para o aplicativo.
-
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-callbackClaude.ai
https://claude.ai/api/mcp/auth_callbackClaude Code
http://localhost:CLAUDE_REDIRECT_PORT/callback
ChatGPT
Você pode deixar o
redirect_uriem branco por enquanto. 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 é 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
-
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" ] } } } }
-
Executar
/mcp auth google-pay-wallet-devpara iniciar o processo de autenticação do servidor MCP do Google Pay & Wallet Developer.
Antigravity
Para configurar Antigravity para usar o servidor MCP:
- No Antigravity, clique no menu Additional options no painel do agente > MCP Servers > Manage MCP Servers.
-
Na parte de cima do painel "Manage MCP Servers", clique
View raw config para editar o
mcp_config.jsonarquivo:{ "mcpServers": { "google-pay-wallet-dev": { "serverUrl": "https://paydeveloper.googleapis.com/mcp", "oauth": { "clientId": "ANTIGRAVITY_CLIENT_ID", "clientSecret": "ANTIGRAVITY_CLIENT_SECRET" } } } }
- Volte para Manage MCP servers e clique em Refresh. Ao clicar em Authenticate, a guia Customizations é aberta em Agent Settings.
- Clique em Authenticate e conclua o fluxo do OAuth.
- Copie o código de autorização e envie-o na janela Agent Settings.
VS Code
-
Para configurar o VS Code (Copilot), edite o
.vscode/mcp.jsonarquivo no 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 o ID do cliente OAuth e pressione Enter.
- Quando solicitado, insira a chave secreta do cliente OAuth e pressione Enter.
- Uma caixa de diálogo para autenticação é aberta. Clique em Permitir.
- 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:
- Navegue até Customize > Connectors.
- Clique no botão e escolha Add custom connector.
-
Insira os seguintes detalhes:
-
Server name:
Google Pay & Wallet MCP.-
Remote MCP server URL
https://paydeveloper.googleapis.com/mcp. - Em Advanced settings , insira o ID do cliente OAuth e a chave secreta do cliente OAuth.
- 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:
- Ative o Modo de desenvolvedor em Configurações > Apps > Configurações avançadas.
- Clique no botão Criar app.
-
Insira os seguintes detalhes:
-
Nome:
Google Pay & Wallet MCP.-
MCP server URL:
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 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.