← MCP-Verzeichnis

Adyen MCP-Server

Beta

Adyen stellt einen eigenen MCP-Server in einer Alpha-Version bereit, der lokal läuft und Anweisungen in natürlicher Sprache in Aufrufe der Checkout API und Management API übersetzt. Er funktioniert mit Test- und Live-Umgebung über einen API-Schlüssel aus der Adyen Customer Area.

Was ein Agent tun kann

  • → Zahlungssitzungen und Zahlungslinks erstellen
  • → Zahlungen erstatten oder stornieren
  • → Händlerkonten und Zahlungsarten lesen
  • → Terminals und ihre Einstellungen verwalten
  • → Webhooks auflisten und testen

Der Server befindet sich im Alpha-Stadium und kann standardmäßig schreiben. Schränken Sie die Rollen des API-Schlüssels ein und starten Sie mit dem Parameter --tools nur die benötigten Werkzeuge, bevor er mit der Live-Umgebung arbeitet.

Über den Adyen MCP-Server

Der Adyen MCP-Server ist ein offenes Projekt, das Adyen selbst auf GitHub veröffentlicht, gekennzeichnet als Alpha. Er läuft lokal auf Ihrem eigenen Rechner oder Server und wird mit einem npx-Befehl gestartet. Von dort aus kann ein KI-Assistent die Checkout API und die Management API von Adyen mit geschriebenen Anweisungen aufrufen. Laut Adyen sind weitere APIs und Endpunkte geplant.

Ein Payment-Team erstellt damit Zahlungssitzungen und Zahlungslinks, prüft den Status eines Links oder lässt ihn vorzeitig ablaufen und storniert eine autorisierte Zahlung oder erstattet eine eingezogene. Auf der Verwaltungsseite listet der Server Händlerkonten, Zahlungsarten, Nutzer, API-Zugangsdaten und Webhooks auf, testet einen Webhook und verwaltet Zahlungsterminals: auflisten, neu zuweisen, Aktionen planen und Einstellungen ändern.

Der Zugriff wird vollständig über den API-Schlüssel und die Rollen seines Webservice-Nutzers gesteuert. Adyen empfiehlt einen neuen Nutzer und einen neuen Schlüssel nur für diesen Zweck, mit Rollen, die zu den genutzten Werkzeugen passen. Mit dem Parameter --tools starten Sie nur eine Auswahl der Werkzeuge. Der Server arbeitet gegen die Test- oder die Live-Umgebung, für Live ist zusätzlich Ihr Live-URL-Präfix nötig.

Das können Sie fragen

  • Erstellen Sie in der Testumgebung einen Zahlungslink über 120 Euro für Bestellung 4471.
  • Welche Zahlungsarten sind in unserem Händlerkonto aktiviert?
  • Listen Sie alle Webhooks des Unternehmenskontos auf und testen Sie den, der an das Bestellsystem geht.
  • Welche Terminals haben wir, und welchem Store ist jedes zugewiesen?
  • Lassen Sie den Zahlungslink mit dieser ID ablaufen und bestätigen Sie anschließend seinen Status.

So verbinden Sie Adyen

  1. Legen Sie in der Adyen Customer Area einen neuen Webservice-Nutzer an und erzeugen Sie einen API-Schlüssel, der nur für den MCP-Server verwendet wird. Geben Sie dem Nutzer nur die Rollen, die die geplanten Werkzeuge benötigen.
  2. Hinterlegen Sie den Schlüssel in der Umgebungsvariable ADYEN_API_KEY, ohne dass er im Befehlsverlauf landet.
  3. Fügen Sie den Server in Ihrem MCP-Client als lokalen Server mit dem Befehl npx -y @adyen/mcp --env=TEST hinzu.
  4. Für die Live-Umgebung: Verwenden Sie --env=LIVE und ergänzen Sie --livePrefix mit Ihrem Präfix aus der Live Customer Area unter Developers, API URLs, Prefix.
  5. Beschränken Sie den Server bei Bedarf mit --tools auf die benötigten Werkzeuge, zum Beispiel --tools=list_all_company_webhooks,list_all_merchant_webhooks.

Enthalten in diesen Paketen

Adyen ist in diesen Walma-Paketen enthalten.

Fragen zu Adyen MCP

Ist der Adyen MCP-Server kostenlos?+

Der Code ist quelloffen und liegt unter MIT-Lizenz auf GitHub. Eine Gebühr für den Server selbst nennt Adyen nicht, Sie benötigen aber ein Adyen-Konto und einen API-Schlüssel, damit er etwas tun kann. Eigene Nutzungsgrenzen für den Server nennt Adyen nicht.

Wie lautet die URL des Adyen MCP-Servers?+

Es gibt keine. Adyen beschreibt nur einen lokal laufenden Server und erwähnt keine gehostete Variante. Das Paket heißt @adyen/mcp und wird mit npx -y @adyen/mcp --env=TEST gestartet. Der Quellcode liegt unter github.com/Adyen/adyen-mcp.

Wie meldet man sich beim Adyen MCP-Server an?+

Mit einem API-Schlüssel aus der Adyen Customer Area, den der Server aus der Umgebungsvariable ADYEN_API_KEY liest. Eine Anmeldung per OAuth gibt es nicht. Der Schlüssel wird zum Starten des Servers und zur Authentifizierung der Aufrufe gebraucht, und was er darf, bestimmen die Rollen seines Webservice-Nutzers.

Ist der Adyen MCP-Server schreibgeschützt?+

Nein. Er kann Zahlungssitzungen und Zahlungslinks erstellen, Zahlungen stornieren und erstatten, Terminals neu zuweisen, Terminalaktionen planen und Terminaleinstellungen ändern. Einen eigenen Nur-Lese-Modus beschreibt Adyen nicht. Sie begrenzen den Server, indem Sie mit --tools nur bestimmte Werkzeuge starten und dem API-Schlüssel weniger Rollen geben.

Mit welchen KI-Assistenten funktioniert der Adyen MCP-Server?+

Laut Dokumentation von Adyen können Sie einen LLM-Client Ihrer Wahl verwenden. Das einzige Konfigurationsbeispiel in der README des Projekts gilt für VS Code, wo der Server als lokaler stdio-Server eingetragen wird. Claude, ChatGPT oder Cursor nennt Adyen nicht namentlich.

Funktioniert der Adyen MCP-Server mit der Live-Umgebung?+

Ja. Mit --env=TEST genügt der API-Schlüssel. Mit --env=LIVE müssen Sie zusätzlich Ihr Live-URL-Präfix über --livePrefix angeben. Das Präfix finden Sie in der Live Customer Area unter Developers, API URLs, Prefix. Das Projekt ist als Alpha gekennzeichnet, testen Sie daher zuerst in der Testumgebung.

Welche Rollen braucht der API-Schlüssel?+

Das hängt von den Werkzeugen ab. Adyen nennt unter anderem die Checkout Webservice Role, die Merchant PAL Webservice Role sowie Management-API-Rollen für Konten, Zahlungsarten, Terminals, Terminalaktionen, Terminaleinstellungen, Webhooks und API-Zugangsdaten. Adyen rät, die Rollen auf die tatsächlich genutzten Werkzeuge zu beschränken.

Fehlt Ihnen eine Anbindung?

Wir bauen und prüfen MCP-Server für Teams, die sie brauchen, und betreiben sie hinter derselben Richtlinie und demselben Protokoll wie das restliche Gateway.