PayPal

PayPal Model Context Protocol

Der PayPal Model Context Protocol -Server ermöglicht die Integration mit PayPal-APIs durch Funktionsaufrufe. Dieses Protokoll unterstützt verschiedene Tools zur Interaktion mit verschiedenen PayPal-Diensten.

Um den PayPal MCP-Server mit npx auszuführen, verwenden Sie den folgenden Befehl:

npx -y @paypal/mcp --tools=all PAYPAL_ACCESS_TOKEN="YOUR_ACCESS_TOKEN" PAYPAL_ENVIRONMENT="SANDBOX"

Ersetzen Sie YOUR_ACCESS_TOKEN durch Ihren PayPal-Zugriffstoken. Hier erfahren Sie, wie Sie einen PayPal-Zugriffstoken generieren . Alternativ können Sie den PAYPAL_ACCESS_TOKEN in Ihren Umgebungsvariablen festlegen.

Verwendung mit MCP-Host (Claude Desktop/Cline/Cursor/GitHub Copilot)

In dieser Anleitung wird erklärt, wie der PayPal-Connector in Claude Desktop integriert wird.

Related MCP server: Worldpay MCP Server

Voraussetzungen

• Claude Desktop-Anwendung installiert

• Node.js lokal installieren

Installationsschritte

1. Installieren Sie Node.js

Für die Funktion des PayPal-Connectors ist Node.js erforderlich:

1. Besuchen Sie die offizielle Website von Node.js , laden Sie es herunter und installieren Sie es.

2. Anforderungen: Node 18+

2. Konfigurieren Sie den PayPal Connector mit dem MCP-Host (Claude Desktop / Cursor / Cline).

Wir zeigen die Integration mit Claude Desktop. Sie können Ihren bevorzugten MCP-Host verwenden.

1. Öffnen Sie Claude Desktop

2. Navigieren Sie zu Einstellungen

3. Suchen Sie den Abschnitt „Entwicklereinstellungen“ oder „Erweiterte Einstellungen“

4. Suchen Sie den Konfigurationsbereich für externe Tools oder Konnektoren

5. Fügen Sie dieser Datei ~/Claude/claude_desktop_config.json die folgende PayPal-Connector-Konfiguration hinzu:

{
   "mcpServers": {
     "paypal": {
       "command": "npx",
       "args": [
         "-y",
         "@paypal/mcp",
         "--tools=all"
       ],
       "env": {
         "PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN",
         "PAYPAL_ENVIRONMENT": "SANDBOX"
       }
     }
   }
}

Ersetzen Sie YOUR_PAYPAL_ACCESS_TOKEN durch Ihren tatsächlichen PayPal-Zugriffstoken. Alternativ können Sie den PAYPAL_ACCESS_TOKEN als Umgebungsvariable festlegen. Sie können ihn auch als Argument mit --access-token in "args" übergeben. Setzen Sie den Wert für PAYPAL_ENVIRONMENT entweder auf SANDBOX für Bühnentests oder PRODUCTION für die Produktionsumgebung.

6. Speichern Sie Ihre Konfigurationsänderungen

3. Testen Sie die Integration

1. Beenden und starten Sie Claude Desktop neu, um die Änderungen zu übernehmen

2. Testen Sie die Verbindung, indem Sie Claude bitten, eine PayPal-bezogene Aufgabe auszuführen

   • Beispiel: „Meine PayPal-Rechnungen auflisten“

Verfügbare Werkzeuge

Rechnungen

• create_invoice : Erstellen Sie eine neue Rechnung im PayPal-System

• list_invoices : Rechnungen auflisten mit optionaler Paginierung und Filterung

• get_invoice : Details einer bestimmten Rechnung abrufen

• send_invoice : Senden Sie eine Rechnung an die Empfänger

• send_invoice_reminder : Senden Sie eine Erinnerung für eine bestehende Rechnung

• cancel_sent_invoice : Stornieren Sie eine gesendete Rechnung

• generate_invoice_qr_code : Einen QR-Code für eine Rechnung generieren

Zahlungen

• create_order : Erstellen Sie eine Bestellung im PayPal-System basierend auf den bereitgestellten Details

• get_order : Ruft die Details einer Bestellung ab

• pay_order : Zahlung für eine autorisierte Bestellung verarbeiten

Streitbeilegung

• list_disputes : Ruft eine Zusammenfassung aller offenen Streitigkeiten ab

• get_dispute : Rufen Sie detaillierte Informationen zu einem bestimmten Streitfall ab

• accept_dispute_claim : Einen Streitfall akzeptieren

Sendungsverfolgung

• create_shipment_tracking : Erstellen Sie einen Sendungsverfolgungsdatensatz

• get_shipment_tracking : Sendungsverfolgungsinformationen abrufen

Katalogverwaltung

• create_product : Erstellen Sie ein neues Produkt im PayPal-Katalog

• list_products : Produkte mit optionaler Paginierung und Filterung auflisten

• show_product_details : Details zu einem bestimmten Produkt abrufen

• update_product : Aktualisieren Sie ein vorhandenes Produkt

Abonnementverwaltung

• create_subscription_plan : Einen neuen Abonnementplan erstellen

• list_subscription_plans : Abonnementpläne auflisten

• show_subscription_plan_details : Details eines bestimmten Abonnementplans abrufen

• create_subscription : Ein neues Abonnement erstellen

• show_subscription_details : Details eines bestimmten Abonnements abrufen

• cancel_subscription : Ein aktives Abonnement kündigen

Berichte und Einblicke

• list_transactions : Listen Sie Transaktionen mit optionaler Paginierung und Filterung auf

Umgebungsvariablen

Die folgenden Umgebungsvariablen können verwendet werden:

• PAYPAL_ACCESS_TOKEN : Ihr PayPal-Zugriffstoken

• PAYPAL_ENVIRONMENT : Für den Sandbox-Modus auf SANDBOX eingestellt, für die Produktion auf PRODUCTION (standardmäßig auf SANDBOX -Modus eingestellt)

In dieser Anleitung wird erläutert, wie Sie ein Zugriffstoken für die PayPal-API-Integration generieren und wie Sie Ihre Client-ID und Ihr Client-Geheimnis finden.

Voraussetzungen

• PayPal-Entwicklerkonto (für Sandbox)

• PayPal-Geschäftskonto (für die Produktion)

So finden Sie Ihre Client-ID und Ihr Client-Geheimnis

1. Erstellen Sie ein PayPal-Entwicklerkonto :

   • Gehen Sie zum PayPal-Entwickler-Dashboard

   • Registrieren Sie sich oder melden Sie sich mit Ihren PayPal-Anmeldeinformationen an

2. Greifen Sie auf Ihre Anmeldeinformationen zu :

   • Klicken Sie im Entwickler-Dashboard im Menü auf Apps & Anmeldeinformationen

   • Wechseln Sie je nach Bedarf zwischen Sandbox- und Live- Modus

3. Erstellen oder Anzeigen einer App :

   • Um eine neue App zu erstellen, klicken Sie auf App erstellen

   • Geben Sie Ihrer App einen Namen und wählen Sie ein Geschäftskonto aus, das damit verknüpft werden soll

   • Klicken Sie bei vorhandenen Apps auf den App-Namen, um Details anzuzeigen

4. Anmeldeinformationen abrufen :

   • Sobald Ihre App erstellt oder ausgewählt ist, wird ein Bildschirm mit Folgendem angezeigt:

     • Client-ID : Eine öffentliche Kennung für Ihre App

     • Client Secret : Ein privater Schlüssel (wird nach dem Klicken auf „Anzeigen“ angezeigt)

   • Speichern Sie diese Anmeldeinformationen sicher, da sie zum Generieren von Zugriffstoken erforderlich sind

Generieren eines Zugriffstokens

Verwenden von cURL

curl -v https://api-m.sandbox.paypal.com/v1/oauth2/token \\
  -H \"Accept: application/json\" \\
  -H \"Accept-Language: en_US\" \\
  -u \"CLIENT_ID:CLIENT_SECRET\" \\
  -d \"grant_type=client_credentials\"

Ersetzen Sie CLIENT_ID und CLIENT_SECRET durch Ihre tatsächlichen Anmeldeinformationen. Verwenden Sie für die Produktion https://api-m.paypal.com anstelle der Sandbox-URL.

Verwenden von Postman

1. Erstellen Sie eine neue Anfrage an https://api-m.sandbox.paypal.com/v1/oauth2/token

2. Methode auf POST setzen

3. Wählen Sie unter Autorisierung die Option „Basisauthentifizierung“ aus und geben Sie Ihre Client-ID und Ihr Client-Geheimnis ein.

4. Wählen Sie unter Body x-www-form-urlencoded aus und fügen Sie einen Schlüssel grant_type mit dem Wert client_credentials hinzu

5. Senden Sie die Anfrage

Antwort

Eine erfolgreiche Antwort sieht folgendermaßen aus:

{
  "scope": "...",
  "access_token": "Your Access Token",
  "token_type": "Bearer",
  "app_id": "APP-80W284485P519543T",
  "expires_in": 32400,
  "nonce": "..."
}

Kopieren Sie den access_token Wert zur Verwendung in Ihrer Claude Desktop-Integration.

Token-Details

• Sandbox-Token : Gültig für 3–8 Stunden

• Produktionstoken : 8 Stunden gültig

• Es wird empfohlen, vor Ablauf des Tokens eine Aktualisierungslogik zu implementieren.

Verwenden des Tokens mit Claude Desktop

Sobald Sie Ihr Zugriffstoken haben, aktualisieren Sie den Wert PAYPAL_ACCESS_TOKEN in Ihrer Claude Desktop-Connector-Konfiguration:

{
  "env": {
    "PAYPAL_ACCESS_TOKEN": "YOUR_NEW_ACCESS_TOKEN",
    "PAYPAL_ENVIRONMENT": "SANDBOX"
  }
}

Bewährte Methoden

1. Client-ID und Client-Geheimnis sicher speichern

2. Implementieren Sie eine Token-Aktualisierungslogik, um den Token-Ablauf zu handhaben

3. Verwenden Sie umgebungsspezifische Token (Sandbox zum Testen, Produktion für echte Transaktionen).

4. Vermeiden Sie die Hardcodierung von Token im Anwendungscode

Haftungsausschluss

@paypal/mcp bietet Zugriff auf KI-generierte Inhalte, die ungenau oder unvollständig sein können. Nutzer sind dafür verantwortlich, alle Informationen selbstständig zu überprüfen, bevor sie sich darauf verlassen. PayPal übernimmt keine Garantie für die Genauigkeit der Ergebnisse und haftet nicht für Entscheidungen, Handlungen oder Folgen, die sich aus deren Nutzung ergeben.