Ein MCP-Server (Model Context Protocol) fungiert als Proxy zwischen einem externen Dienst, der einem Large Language Model (LLM) oder einer KI-Anwendung Kontext, Daten oder Funktionen bereitstellt. MCP-Server verbinden KI-Anwendungen mit externen Systemen wie Datenbanken und Webdiensten und übersetzen deren Antworten in ein Format, das die KI-Anwendung versteht.
Server einrichten
Sie müssen MCP-Server aktivieren und die Authentifizierung einrichten, bevor Sie sie verwenden können. Weitere Informationen zur Verwendung von Remote-MCP-Servern von Google und Google Cloud finden Sie unter Übersicht über Google Cloud-MCP-Server.
Serverendpunkte
Ein MCP-Dienstendpunkt ist die Netzwerkadresse und Kommunikationsschnittstelle (in der Regel eine URL) des MCP-Servers, über die eine KI-Anwendung (der Host für den MCP-Client) eine sichere, standardisierte Verbindung herstellt. Er ist der Ansprechpartner für das LLM, um Kontext anzufordern, ein Tool aufzurufen oder auf eine Ressource zuzugreifen. Google-MCP-Endpunkte können global oder regional sein.
Der MCP-Server für Google Pay &Wallet-Entwickler hat den folgenden globalen MCP-Endpunkt:
- https://paydeveloper.googleapis.com/mcp
MCP-Tools
Ein MCP-Tool ist eine Funktion oder ausführbare Funktion, die ein MCP-Server einem LLM oder einer KI-Anwendung zur Verfügung stellt, um eine Aktion in der realen Welt auszuführen.
Tools
Der MCP-Server paydeveloper.googleapis.com hat die folgenden Tools:
| MCP-Tools | |
|---|---|
search_documentation |
Sucht und ruft die relevantesten und aktuellsten Abschnitte aus der offiziellen Google Pay- und Google Wallet-Entwicklerdokumentation und Codebeispiele ab. |
list_merchants |
Ruft eine Liste aller Google Pay-Händler-Unternehmensprofile ab, die mit dem authentifizierten Konto verknüpft sind. |
list_google_pay_integrations |
Gibt den aktuellen Status und die Konfigurationsdetails für alle Google Pay-Integrationen zurück, die mit einer bestimmten Händler-ID verknüpft sind. Es bietet sofortiges Feedback zum Status von Integrationen und Dokumentprüfungen. |
create_merchant |
Erstellt einen neuen Händler mit dem authentifizierten Konto. Sie MÜSSEN den Nutzer bitten, die erforderlichen Informationen für die Händlererstellung anzugeben. Rufen Sie dieses Tool erst auf, wenn Sie versucht haben, die erforderlichen Informationen für die Händlererstellung zu erfassen. Nachdem der Händler erstellt wurde, MÜSSEN Sie dem Nutzer die URL der Nutzungsbedingungen für die Business Console präsentieren und ihn auffordern, sie zu akzeptieren, bevor er Aktionen für diesen Händler ausführen kann. |
create_google_pay_integration |
Erstellt eine Google Pay-Integration für einen bestimmten Händler. Für diese Aktion muss der Nutzer die Nutzungsbedingungen für die Business Console und die Nutzungsbedingungen für die Google Pay API akzeptiert haben. Sie müssen diese nicht im Voraus prüfen. Wenn sie nicht akzeptiert wurden, schlägt der Toolaufruf fehl und die Fehlermeldung enthält die spezifischen URLs der Nutzungsbedingungen, die akzeptiert werden müssen. Präsentieren Sie dem Nutzer in diesem Fall die URLs zur Akzeptanz und fordern Sie ihn auf, es noch einmal zu versuchen, sobald sie akzeptiert wurden. Folgen Sie dieser Reihenfolge, um mit dem Nutzer zu interagieren, BEVOR Sie das Tool aufrufen: 1. Fragen Sie den Nutzer zuerst nach dem Integrationselement (derzeit wird nur die Web-Integration unterstützt). - Fragen Sie nach der Website-URL. # - Wenn das Integrationselement eine App-Integration ist, fragen Sie nach dem Android-App-Paketnamen. 2. Fragen Sie den Nutzer dann nach dem Integrationstyp: - Fordern Sie den Nutzer auf, „Gateway“ auszuwählen, wenn er einen unserer unterstützten Zahlungsdienstleister (Payment Service Providers, PSPs: https://developers.google.com/pay/api#participating-processors) verwendet, andernfalls „Direkt“. 3. Für ALLE Integrationstypen (direkt oder Gateway): - Fordern Sie den Nutzer auf, Screenshots (max. 1 MB) seines in die Google Pay API integrierten Kaufvorgangs hochzuladen. Der Kaufvorgang muss überprüft und genehmigt werden, bevor der Nutzer den uneingeschränkten Produktionszugriff erhält. Beispiele: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - Sie MÜSSEN den Nutzer auffordern, 5 unterstützende Screenshots bereitzustellen. Fragen Sie sie EINZELN an, um eine korrekte Zuordnung zu gewährleisten. Verwenden Sie beim Fragen NUR die nutzerfreundlichen Enum-Beschreibungen. 4. Wenn der Integrationstyp „Direkt“ ist: - Sie MÜSSEN den Nutzer AUCH auffordern, das PCI-Attestierungsdokument im PDF-Format bereitzustellen. Verwenden Sie beim Fragen NUR die nutzerfreundliche Enum-Beschreibung. 5. Fordern Sie den Nutzer für jede bereitgestellte Datei auf, den Dokumentpfad oder den Namen anzugeben, wenn sie sich im aktuellen Verzeichnis befindet. Ordnen Sie sie dem richtigen DocumentType zu und legen Sie das Feld „name“ in der Anfrage auf einen beschreibenden Namen fest (z.B. „item_selection.png“ oder „pci_attestation.pdf“). Rufen Sie dieses Tool erst auf, wenn Sie versucht haben, die erforderlichen Dokumente für den ausgewählten Integrationstyp zu erfassen. |
list_pass_issuers |
Ruft eine umfassende Liste aller in der Google Wallet Business Console registrierten Aussteller von Karten/Tickets ab, die mit dem authentifizierten Nutzer verknüpft sind. Dieses Tool enthält wichtige Informationen für Entwickler, die Wallet-Karten/Tickets wie Kundenkarten, Geschenkkarten oder Flugtickets verwalten. |
list_pass_classes |
Ruft eine umfassende Liste aller in der Google Wallet Business Console registrierten Karten-/Ticketklassen ab, die mit dem authentifizierten Nutzer verknüpft sind. Dieses Tool enthält wichtige Informationen für Entwickler, die Wallet-Karten/Tickets wie Kundenkarten, Geschenkkarten oder Flugtickets verwalten. |
validate_pass_jwt |
Validiert die JWT-Darstellung einer Karte/eines Tickets oder die nicht codierte JWT-Nutzlast als JSON-String für eine Karte/ein Ticket. |
query_merchant_performance |
Ruft aggregierte Leistungsdaten und Metriken nach der Integration für ein bestimmtes Unternehmensprofil des Händlers ab. |
query_merchant_error_metrics |
Ruft detaillierte Fehlermetriken für ein bestimmtes Unternehmensprofil des Händlers ab. Dieses Tool bietet eine detaillierte Aufschlüsselung der Fehler, sodass Entwickler Probleme genau lokalisieren und beheben können. |
MCP-Tool-Spezifikationen abrufen
Verwenden Sie die Methode tools/list, um die MCP-Tool-Spezifikationen für alle Tools auf einem MCP-Server abzurufen. Im folgenden Beispiel wird gezeigt, wie Sie mit curl alle Tools und ihre Spezifikationen auflisten, die derzeit auf dem MCP-Server verfügbar sind.
| Curl-Anfrage |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |