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:

• Cercare la documentazione: ricevi indicazioni aggiornate ed esempi di codice dalla documentazione ufficiale di Google Pay e Google Wallet.
• Gestire le integrazioni: controlla lo stato delle tue 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 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 di Google Wallet."

Prima di iniziare

Per utilizzare il server MCP per sviluppatori di Google Pay e Wallet, devi creare un progetto Google Cloud e abilitare il server MCP per sviluppatori di Google Pay e 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 dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin). 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 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 per sviluppatori di Google Pay e 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

Il server MCP per sviluppatori di Google Pay e Wallet utilizza 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 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 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 in Google, consulta 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 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 Cursor Desktop, Claude Code, Claude.ai, ChatGPT e Antigravity, seleziona Applicazione web.
   • Per Antigravity CLI, Antigravity IDE 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:

   Cursor Desktop

   http://localhost:8787/callback

   Claude Code

   http://localhost:CLAUDE_REDIRECT_PORT/callback

   Claude.ai

   https://claude.ai/api/mcp/auth_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.

   Antigravity

   https://antigravity.google/oauth-callback

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.

VS Code

1. Fai clic sull' icona nella parte superiore del riquadro laterale della chat e vai a Server MCP.
2. Fai clic sul pulsante Aggiungi server (), seleziona HTTP e inserisci l'URL che rimanda al server MCP per sviluppatori di Pay e Wallet: https://paydeveloper.googleapis.com/mcp.
   La configurazione MCP viene salvata nel file .vscode/mcp.json nell'area di lavoro:

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

3. Fai clic con il tasto destro del mouse sul nuovo server MCP e seleziona Avvia server.
4. Torna alla finestra della chat e chiama uno strumento nel server MCP per attivare la procedura di autenticazione. Ad esempio: "Elenca i miei account Google Pay".
5. Come previsto, si apre la finestra di dialogo Registrazione client dinamica non supportata. Fai clic su un pulsante qualsiasi per chiudere la finestra di dialogo.
6. Inserisci il tuo ID client OAuth e premi Invio.
7. Quando ti viene richiesto, inserisci il tuo client secret OAuth e premi Invio.
8. Si apre una finestra di dialogo per l'autenticazione, fai clic su Consenti.
9. Puoi scegliere da un elenco di identità autenticate o accedere con un nuovo account.
10. Dopo l'autenticazione, lo strumento viene chiamato e la sessione continua in la finestra della chat.

Cursor Desktop

Per configurare Cursor Desktop:

1. Fai clic su Personalizza nel riquadro laterale a sinistra.
2. Fai clic su Nuovo server MCP. Viene aperto il file di configurazione mcp.json.
3. Inserisci i dettagli di configurazione per aggiungere il server MCP per sviluppatori di Google Pay e Wallet:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "url": "https://paydeveloper.googleapis.com/mcp",
         "auth": {
           "CLIENT_ID": "CURSOR_DESKTOP_CLIENT_ID",
           "CLIENT_SECRET": "CURSOR_DESKTOP_CLIENT_SECRET"
         }
       }
     }
   }

4. Dopo aver salvato il file, l'elenco dei server MCP viene aggiornato.
5. Fai clic su Autentica per avviare la procedura di autenticazione.

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

Claude.ai

Per configurare Claude.ai:

1. Vai a Personalizza > Connettori.
2. Fai clic su Aggiungi 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.

ChatGPT

Per configurare ChatGPT:

1. Attiva la modalità sviluppatore da Impostazioni > Sicurezza e accesso.
2. Seleziona Plug-in nel riquadro laterale principale e fai clic sul pulsante .
3. Inserisci i seguenti dettagli:
   Nome: Google Pay & Wallet MCP.
   URL del server: 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.

Antigravity CLI

1. Per configurare Antigravity CLI, aggiungi quanto segue al tuo ~/.gemini/config/mcp_config.json file:

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

2. Esegui /mcp, seleziona il nuovo server MCP e scegli Autentica per avviare la procedura di autenticazione.

Antigravity IDE

1. Fai clic su nella parte superiore del riquadro laterale dell'agente dell'editor e seleziona Server MCP.
2. Fai clic su Gestisci server MCP.
3. Fai clic su Visualizza configurazione non elaborata e aggiungi i dettagli del server MCP:

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

4. Torna ad Antigravity IDE e fai clic su Aggiorna.
5. Seleziona il nuovo server MCP, fai clic su Autentica e completa la procedura di autenticazione.
6. Copia il codice di autorizzazione e invialo nella finestra Impostazioni di Antigravity.

Antigravity

1. In Antigravity, vai a Impostazioni > Personalizzazioni.
2. Nella sezione Server MCP installati, fai clic su Apri configurazione MCP 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 ad Antigravity e fai clic su Aggiorna.
4. Fai clic su Autentica e completa la procedura di autenticazione.
5. Copia il codice di autorizzazione e invialo nella finestra Impostazioni di Antigravity.

Limitazioni note

• Risultati solo in inglese: la ricerca nella documentazione supporta solo l'inglese.
• Contenuti dietro gli ACL: la documentazione dietro gli ACL non è indicizzata
• Dipendente dalla rete: il server richiede una connessione live 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.