Connettiti al server MCP per sviluppatori di Google Pay e Wallet

Anteprima

Questo prodotto è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Il server MCP per sviluppatori di Google Pay e Google Wallet consente agli strumenti di sviluppo basati sull'AI di accedere ai dati degli sviluppatori di Google Pay e Google Wallet, cercare la documentazione ufficiale e gestire le integrazioni.

Il Model Context Protocol (MCP) standardizza il modo in cui i modelli linguistici di grandi dimensioni (LLM) e le applicazioni o gli agenti AI si connettono a origini dati esterne. I server MCP consentono di utilizzare i relativi strumenti, risorse e prompt per eseguire azioni e ottenere dati aggiornati dal servizio di backend.

Il server MCP per sviluppatori di Google Pay e Google Wallet consente di:

• Cercare la documentazione: ricevi indicazioni e esempi di codice aggiornati dalla documentazione ufficiale di Google Pay e Google Wallet.
• Gestire le integrazioni: controlla lo stato delle integrazioni e abilita le API per il tuo account commerciante.
• Monitorare il rendimento: accedi ai dati sul rendimento aggregati e alle metriche degli errori per il tuo account commerciante.

• Gestire le tessere: elenca gli emittenti e le classi di tessere per Google Wallet.

  Nota: consulta il riferimento per sviluppatori di Pay e Wallet per visualizzare i dettagli degli strumenti MCP disponibili e le relative descrizioni.

Prompt di esempio

Puoi utilizzare i seguenti prompt con l'assistente AI:

• "Elenca i miei account Google Pay."
• "Qual è lo stato delle mie integrazioni di Google Pay?"
• "Come posso integrare Google Pay con React?"
• "Mostrami le metriche degli errori di Google Pay per la mia integrazione negli ultimi 30 giorni."
• "Elenca le mie classi di tessere di Google Wallet."

Prima di iniziare

Per utilizzare il server MCP per sviluppatori di Google Pay e Google Wallet, devi creare un progetto Google Cloud e abilitare il server MCP per sviluppatori di Google Pay e Google Wallet.

1. Nella console Cloud, nella pagina di selezione del progetto, seleziona o crea un progetto Google Cloud.

   Vai al selettore di progetti

2. Abilita l'API Pay &Wallet Developer.

   Ruoli richiesti per abilitare le API

   Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin), che contiene l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

   Abilita l'API

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per utilizzare il server MCP remoto del server MCP per sviluppatori di Google Pay e Google Wallet, chiedi all'amministratore di concederti i seguenti ruoli Identity and Access Management (IAM) nel progetto Google Cloud in cui vuoi abilitare il server MCP del server MCP per sviluppatori di Google Pay e Google Wallet:

• Esegui chiamate allo strumento MCP: Utente dello strumento MCP (roles/mcp.toolUser)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Autenticazione e autorizzazione

I server MCP del server MCP per sviluppatori di Google Pay e Google Wallet utilizzano il protocollo OAuth 2.0 con Identity and Access Management (IAM) per l'autenticazione e l'autorizzazione. Tutte le identità sono supportate per l'autenticazione ai server MCP.

Il server MCP per sviluppatori di Google Pay e Google Wallet non accetta chiavi API.

Ti consigliamo di creare un'identità separata per gli agenti che utilizzano gli strumenti MCP in modo che l'accesso alle risorse possa essere controllato e monitorato. Per saperne di più sull' autenticazione, consulta Autenticarsi ai server MCP.

Ambiti OAuth del server MCP per sviluppatori di Google Pay e Google Wallet

OAuth 2.0 utilizza ambiti e credenziali per determinare se un'entità autenticata è autorizzata a eseguire un'azione specifica su una risorsa. Per saperne di più sugli ambiti OAuth 2.0 di Google, consulta Utilizzare OAuth 2.0 per accedere alle API di Google.

Il server MCP per sviluppatori di Google Pay e Google Wallet ha i seguenti ambiti OAuth dello strumento MCP:

URI dell'ambito per gcloud CLI	Descrizione
https://www.googleapis.com/auth/paydeveloper.merchant	Gestisci i dati dei commercianti di Google Pay.
https://www.googleapis.com/auth/paydeveloper.issuer.readonly	Leggi i dati degli emittenti di Google Wallet.

Creare un ID client e un client secret OAuth 2.0

Per creare un ID client e un client secret OAuth 2.0:

1. Nella console API di Google, vai a Piattaforma di autenticazione Google > Client > Crea client.

   Vai a Crea client

   Se non ne hai ancora una, dovrai creare una nuova applicazione nella piattaforma di autenticazione Google. Fai clic sul pulsante "Inizia" nella pagina di panoramica e inserisci le informazioni necessarie.

2. Nell'elenco Tipo di applicazione, seleziona il tipo appropriato per la tua applicazione AI:

   • Per Antigravity, Claude.ai, Claude Code e ChatGPT, seleziona Applicazione web.
   • Per Gemini CLI e VS Code, seleziona App desktop.

3. Nel campo Nome, inserisci un nome per l'applicazione.

4. Se hai selezionato Applicazione web, nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi aggiungi l'URI di reindirizzamento richiesto per l'applicazione AI:

   Antigravity

   https://antigravity.google/oauth-callback

   Claude.ai

   https://claude.ai/api/mcp/auth_callback

   Claude Code

   http://localhost:CLAUDE_REDIRECT_PORT/callback

   ChatGPT

   Per il momento puoi lasciare vuoto il campo redirect_uri. ChatGPT genera un redirect_uri quando viene creata l'app (vedi Configurare l'applicazione AI di seguito).

   Nota: nella sezione Origini JavaScript autorizzate, fai clic su + Aggiungi URI e poi aggiungi https://chatgpt.com nel campo URI.

5. Fai clic su Crea. Al momento della creazione, il client secret viene visualizzato una sola volta. Copialo e conservalo in modo sicuro.

Configurare l'applicazione AI

Dopodiché, devi fornire all'applicazione AI i dettagli di configurazione del server.

Gemini CLI

1. Per configurare Gemini CLI, aggiungi quanto segue al file `~/.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"
           ]
         }
       }
     }
   }

2. Esegui /mcp auth google-pay-wallet-dev per avviare la procedura di autenticazione per il server MCP per sviluppatori di Google Pay e Google Wallet.

Antigravity

Per configurare Antigravity in modo che utilizzi il server MCP:

1. In Antigravity, fai clic sul menu Opzioni aggiuntive nel riquadro Agente > Server MCP > Gestisci server MCP.
2. Nella parte superiore del riquadro Gestisci server MCP, fai clic Visualizza configurazione non elaborata per modificare il mcp_config.json file:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "serverUrl": "https://paydeveloper.googleapis.com/mcp",
         "oauth": {
           "clientId": "ANTIGRAVITY_CLIENT_ID",
           "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
         }
       }
     }
   }

3. Torna a Gestisci server MCP e fai clic su Aggiorna. Se fai clic su Autentica , si apre la scheda Personalizzazioni in Impostazioni agente.
4. Fai clic su Autentica e completa il flusso OAuth.
5. Copia il codice di autorizzazione e invialo nella finestra Impostazioni agente.

VS Code

1. Per configurare VS Code (Copilot), modifica il .vscode/mcp.json file nell'area di lavoro:

   {
     "servers": {
       "google-pay-wallet-dev": {
         "url": "https://paydeveloper.googleapis.com/mcp"
       }
     }
   }

2. Chiama uno strumento nel server MCP per attivare la procedura di autenticazione. Ad esempio: "Elenca i miei account Google Pay".
3. Come previsto, si apre la finestra di dialogo Dynamic Client Registration non supportata. Fai clic su un pulsante qualsiasi per chiudere la finestra di dialogo.
4. Inserisci il tuo ID client OAuth e premi Invio.
5. Quando ti viene richiesto, inserisci il tuo client secret OAuth e premi Invio.
6. Si apre una finestra di dialogo per l'autenticazione, fai clic su Consenti.
7. Dopo l'autorizzazione, lo strumento viene chiamato e la sessione continua in la finestra della chat.

Claude.ai

Per configurare Claude.ai:

1. Vai a Personalizza > Connettori.
2. Fai clic sul pulsante e scegli Aggiungi connettore personalizzato.
3. Inserisci i seguenti dettagli:
   Nome server: Google Pay & Wallet MCP.
   URL del server MCP remoto https://paydeveloper.googleapis.com/mcp.
4. In Impostazioni avanzate , inserisci il tuo ID client OAuth e client secret OAuth.
5. Seleziona il nuovo connettore e fai clic su Connetti.

Claude Code

Per configurare Claude Code, esegui il seguente 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

Per configurare ChatGPT:

1. Attiva la modalità sviluppatore da Impostazioni > App > Impostazioni avanzate.
2. Fai clic sul pulsante Crea app.
3. Inserisci i seguenti dettagli:
   Nome: Google Pay & Wallet MCP.
   URL del server MCP: https://paydeveloper.googleapis.com/mcp
4. Vai a Impostazioni avanzate e inserisci l'ID client e il client secret OAuth.
5. Copia l'URL di callback dinamico e aggiungilo al client OAuth creato nel passaggio precedente.

Limitazioni note

• Risultati solo in inglese: la ricerca nella documentazione supporta solo l'inglese.
• Contenuti dietro ACL: la documentazione dietro gli ACL non viene indicizzata
• Dipendente dalla rete: il server richiede una connessione live ai servizi Google Pay e Google Wallet.

Termini di servizio

L'utilizzo dell'API Google Pay è soggetto ai Termini di servizio dell'API Google Pay. L'utilizzo dell' API Google Wallet è soggetto ai Termini di servizio dell'API Google Wallet.