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 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 ti consentono di utilizzare i loro strumenti, risorse e prompt per eseguire azioni e ottenere dati aggiornati dal loro servizio di backend.

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

• Documentazione della ricerca: ricevi indicazioni e campioni di codice aggiornati dalla documentazione ufficiale di Google Pay e Google Wallet.
• Gestisci integrazioni: controlla lo stato delle integrazioni e attiva le API per il tuo account commerciante.
• Monitorare il rendimento: accedi ai dati aggregati sul rendimento e alle metriche relative agli errori per il tuo account commerciante.

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

  Nota: consulta il riferimento per sviluppatori di Pay & 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 faccio a 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 Google Wallet."

Prima di iniziare

Per utilizzare il server Google Pay & Wallet Developer MCP, devi creare un progetto Google Cloud e attivare il server Google Pay & Wallet Developer MCP e le API Google Wallet.

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

   Vai al selettore di progetti

2. Abilita le API Pay & Wallet Developer e Google Wallet.

   Ruoli richiesti per abilitare le API

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

   Abilita le API

Ruoli obbligatori

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

• Effettuare chiamate allo strumento MCP: MCP Tool User (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 di Google Pay e Wallet Developer 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.

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 Esegui l'autenticazione sui server MCP.

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

OAuth 2.0 utilizza ambiti e credenziali per determinare se un principal autenticato è autorizzato a eseguire un'azione specifica su una risorsa. Per saperne di più sugli ambiti OAuth 2.0 in Google, leggi l'articolo Utilizzare OAuth 2.0 per accedere alle API di Google.

Il server MCP per sviluppatori di Google Pay e 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 dell'emittente 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 Google Auth > Client > Crea client.

   Vai a Crea client

   Se non ne hai ancora una, dovrai creare una nuova applicazione nella piattaforma Google Auth. 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 di AI:

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

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

Configura la tua applicazione AI

Successivamente, 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 di Google Pay e Wallet Developer.

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 su Visualizza configurazione non elaborata per modificare il file mcp_config.json:

   {
     "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 file .vscode/mcp.json 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. Si apre la finestra di dialogo Registrazione dinamica del client non supportata come previsto. Fai clic su un pulsante qualsiasi per chiudere la finestra di dialogo.
4. Inserisci il tuo ID client OAuth e premi Invio.
5. Quando richiesto, inserisci il 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 nella 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 l'ID client OAuth e il client secret OAuth.
5. Seleziona il nuovo connettore e fai clic su Connetti.

Claude Code

Per configurare Claude Code, esegui questo 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 OAuth e il segreto.
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 protetti da ACL: la documentazione protetta da ACL non è indicizzata
• Dipendente dalla rete: il server richiede una connessione attiva ai servizi Google Pay e 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.