Verbindung zum Google Pay & Wallet Developer MCP-Server herstellen

Vorschau

Dieses Produkt unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Der Google Pay & Wallet Developer MCP-Server ermöglicht KI-basierten Entwicklungstools den Zugriff auf Ihre Google Pay- und Google Wallet-Entwicklerdaten, die Suche in der offiziellen Dokumentation und die Verwaltung Ihrer Integrationen.

Das Model Context Protocol (MCP) standardisiert die Verbindung von Large Language Models (LLMs) und KI-Anwendungen oder ‑Agenten mit externen Datenquellen. Mit MCP-Servern können Sie die Tools, Ressourcen und Prompts verwenden, um Aktionen auszuführen und aktualisierte Daten vom Backend-Dienst abzurufen.

Mit dem MCP-Server für Google Pay & Wallet Developer können Sie:

• Dokumentation durchsuchen: In der offiziellen Google Pay- und Google Wallet-Dokumentation finden Sie aktuelle Anleitungen und Codebeispiele.
• Integrationen verwalten: Hier können Sie den Status Ihrer Integrationen prüfen und APIs für Ihr Händlerkonto aktivieren.
• Leistung im Blick behalten: Hier können Sie auf aggregierte Leistungsdaten und Fehlermesswerte für Ihr Händlerkonto zugreifen.

• Karten verwalten: Listet Kartenaussteller und ‑klassen für Google Wallet auf.

  Hinweis :In der Pay & Wallet Developer-Referenz finden Sie Details zu den verfügbaren MCP-Tools und deren Beschreibungen.

Beispiel-Prompts

Sie können die folgenden Prompts mit Ihrem KI-Assistenten verwenden:

• „List my Google Pay accounts.“ (Zeige meine Google Pay-Konten an.)
• „What is the status of my Google Pay integrations?“ (Wie ist der Status meiner Google Pay-Integrationen?)
• „Wie kann ich Google Pay in React einbinden?“
• „Zeige mir die Google Pay-Fehlermesswerte für meine Integration der letzten 30 Tage.“
• „List my Google Wallet pass classes.“ (Liste meine Google Wallet-Karten-/Ticketklassen auf.)

Hinweis

Wenn Sie den Google Pay & Wallet Developer MCP-Server verwenden möchten, müssen Sie ein Google Cloud-Projekt erstellen und den Google Pay & Wallet Developer MCP-Server und die Google Wallet APIs aktivieren.

1. Wählen Sie in der Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Zur Projektauswahl

2. Aktivieren Sie die Pay & Wallet Developer APIs und die Google Wallet APIs.

   Rollen, die zum Aktivieren von APIs erforderlich sind

   Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen

   APIs aktivieren

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen (Identity and Access Management) für das Google Cloud-Projekt zuzuweisen, in dem Sie den Google Pay & Wallet Developer MCP-Server aktivieren möchten, um die Berechtigungen zu erhalten, die Sie für die Verwendung des Google Pay & Wallet Developer MCP-Servers benötigen:

• MCP-Tool-Aufrufe ausführen: MCP Tool User (roles/mcp.toolUser)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Authentifizierung und Autorisierung

Google Pay & Wallet Developer MCP-Server verwenden das OAuth 2.0-Protokoll mit Identity and Access Management (IAM) für die Authentifizierung und Autorisierung. Alle -Identitäten werden für die Authentifizierung bei MCP-Servern unterstützt.

Der MCP-Server für Google Pay & Wallet-Entwickler akzeptiert keine API-Schlüssel.

Wir empfehlen, eine separate Identität für Kundenservicemitarbeiter zu erstellen, die MCP-Tools verwenden, damit der Zugriff auf Ressourcen gesteuert und überwacht werden kann. Weitere Informationen zur Authentifizierung finden Sie unter Bei MCP-Servern authentifizieren.

OAuth-Bereiche für den MCP-Server für Google Pay & Wallet Developer

OAuth 2.0 verwendet Bereiche und Anmeldedaten, um zu ermitteln, ob ein authentifiziertes Prinzipal berechtigt ist, eine bestimmte Aktion für eine Ressource auszuführen. Weitere Informationen zu OAuth 2.0-Bereichen bei Google finden Sie unter Mit OAuth 2.0 auf Google APIs zugreifen.

Der Google Pay & Wallet Developer MCP-Server hat die folgenden OAuth-Bereiche für MCP-Tools:

Bereichs-URI für die gcloud CLI	Beschreibung
https://www.googleapis.com/auth/paydeveloper.merchant	Händlerdaten von Google Pay verwalten
https://www.googleapis.com/auth/paydeveloper.issuer.readonly	Daten des Kreditkartenunternehmens in Google Wallet lesen

OAuth 2.0-Client-ID und ‑Secret erstellen

So erstellen Sie eine OAuth 2.0-Client-ID und ein Client-Secret:

1. Rufen Sie in der Google API Console Google Auth Platform > Clients > Create client auf.

   Zur Seite „Client erstellen“

   Sie müssen eine neue Anwendung auf der Google Auth Platform erstellen, falls Sie noch keine haben. Klicken Sie auf der Übersichtsseite auf die Schaltfläche „Jetzt starten“ und geben Sie die erforderlichen Informationen ein.

2. Wählen Sie in der Liste Anwendungstyp den entsprechenden Typ für Ihre KI-Anwendung aus:

   • Wählen Sie für Antigravity, Claude.ai, Claude Code und ChatGPT die Option Webanwendung aus.
   • Wählen Sie für die Gemini CLI und VS Code die Option Desktop-App aus.

3. Geben Sie im Feld Name einen Namen für Ihre Anwendung ein.

4. Wenn Sie Webanwendung ausgewählt haben, klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und fügen Sie dann den erforderlichen Weiterleitungs-URI für Ihre KI-Anwendung hinzu:

   Antigravity

   https://antigravity.google/oauth-callback

   Claude.ai

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

   Claude Code

   http://localhost:CLAUDE_REDIRECT_PORT/callback

   ChatGPT

   Sie können das Feld redirect_uri vorerst leer lassen. ChatGPT generiert eine redirect_uri, wenn die App erstellt wird (siehe KI-Anwendung konfigurieren unten).

   Hinweis:Klicken Sie im Abschnitt Autorisierte JavaScript-Quellen auf + URI hinzufügen und fügen Sie dann https://chatgpt.com im Feld URIs hinzu.

5. Klicken Sie auf Erstellen. Nach der Erstellung wird der Clientschlüssel einmal angezeigt. Kopieren Sie ihn und bewahren Sie ihn an einem sicheren Ort auf.

KI-Anwendung konfigurieren

Als Nächstes müssen Sie Ihrer KI-Anwendung die Details zur Serverkonfiguration zur Verfügung stellen.

Gemini CLI

1. Wenn Sie die Gemini CLI konfigurieren möchten, fügen Sie der Datei `~/.gemini/settings.json` Folgendes hinzu:

   {
     "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. Führen Sie /mcp auth google-pay-wallet-dev aus, um den Authentifizierungsvorgang für den Google Pay & Wallet Developer-MCP-Server zu starten.

Antigravity

So konfigurieren Sie Antigravity für die Verwendung des MCP-Servers:

1. Klicken Sie in Antigravity im Bereich „Agent“ auf das Dreipunkt-Menü > MCP Servers (MCP-Server) > Manage MCP Servers (MCP-Server verwalten).
2. Klicken Sie oben im Bereich „MCP-Server verwalten“ auf Rohkonfiguration ansehen, um die Datei mcp_config.json zu bearbeiten:

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

3. Kehren Sie zu MCP-Server verwalten zurück und klicken Sie auf Aktualisieren. Wenn Sie auf Authentifizieren klicken, wird der Tab Anpassungen in den Agent-Einstellungen geöffnet.
4. Klicken Sie auf Authentifizieren und führen Sie den OAuth-Ablauf aus.
5. Kopieren Sie den Autorisierungscode und senden Sie ihn im Fenster Agent Settings (Agent-Einstellungen).

VS Code

1. Wenn Sie VS Code (Copilot) konfigurieren möchten, bearbeiten Sie die Datei .vscode/mcp.json in Ihrem Arbeitsbereich:

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

2. Rufen Sie ein Tool auf dem MCP-Server auf, um den Authentifizierungsprozess auszulösen. Beispiel: „List my Google Pay accounts“ (Liste meine Google Pay-Konten auf).
3. Das Dialogfeld Dynamische Clientregistrierung wird wie erwartet geöffnet. Klicken Sie auf eine beliebige Schaltfläche, um das Dialogfeld zu schließen.
4. Geben Sie Ihre OAuth-Client-ID ein und drücken Sie die Eingabetaste.
5. Geben Sie bei Aufforderung Ihr OAuth-Client-Secret ein und drücken Sie die Eingabetaste.
6. Ein Dialogfeld zur Authentifizierung wird geöffnet. Klicken Sie auf Zulassen.
7. Nach der Autorisierung wird das Tool aufgerufen und die Sitzung wird im Chatfenster fortgesetzt.

Claude.ai

So konfigurieren Sie Claude.ai:

1. Gehen Sie zu Anpassen > Connectors.
2. Klicken Sie auf die Schaltfläche  und wählen Sie Benutzerdefinierten Connector hinzufügen aus.
3. Geben Sie die folgenden Details ein:
   Servername: Google Pay & Wallet MCP.
   Remote MCP server URL (Remote-MCP-Server-URL) https://paydeveloper.googleapis.com/mcp.
4. Geben Sie unter Erweiterte Einstellungen Ihre OAuth-Client-ID und Ihren OAuth-Clientschlüssel ein.
5. Wählen Sie den neuen Connector aus und klicken Sie auf Verbinden.

Claude Code

Führen Sie den folgenden Befehl aus, um Claude Code zu konfigurieren:

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

So konfigurieren Sie ChatGPT:

1. Aktivieren Sie den Entwicklermodus unter Einstellungen > Apps > Erweiterte Einstellungen.
2. Klicken Sie auf den Button App erstellen.
3. Geben Sie die folgenden Informationen ein:
   Name: Google Pay & Wallet MCP.
   MCP-Server-URL: https://paydeveloper.googleapis.com/mcp
4. Rufen Sie die erweiterten Einstellungen auf und geben Sie Ihre OAuth-Client-ID und Ihr Secret ein.
5. Kopieren Sie die dynamische Callback-URL und fügen Sie sie dem OAuth-Client hinzu, der im vorherigen Schritt erstellt wurde.

Bekannte Einschränkungen

• Nur englischsprachige Ergebnisse: Die Dokumentationssuche unterstützt nur Englisch.
• Inhalte hinter ACL: Dokumentation hinter ACLs wird nicht indexiert
• Netzwerkabhängig: Der Server benötigt eine aktive Verbindung zu Google Pay- und Wallet-Diensten.

Nutzungsbedingungen

Die Nutzung der Google Pay API unterliegt den Nutzungsbedingungen für die Google Pay API. Die Nutzung der Google Wallet API unterliegt den Nutzungsbedingungen für die Google Wallet API.