Adyen MCP Server

Der Adyen MCP Server verbindet einen KI-Assistenten mit den Schnittstellen des Zahlungsdienstleisters Adyen. Statt für jede Aufgabe die API-Dokumentation zu lesen und Anfragen von Hand zu bauen, beschreiben Sie im Chat oder im Editor, was Sie brauchen, etwa einen Zahlungslink für 49 Euro erstellen, eine Zahlung erstatten oder prüfen, welche Webhooks für ein Händlerkonto eingerichtet sind. Der Server übersetzt solche Anweisungen in die passenden API-Aufrufe. Betreiber ist Adyen selbst; der Quelltext liegt als MIT-lizenziertes TypeScript-Projekt im Repository Adyen/adyen-mcp. Laut Anbieter befindet sich der Server im Alpha-Stadium, es kann sich also noch vieles ändern.

Was ist der Adyen MCP Server?

MCP, das Model Context Protocol, ist ein offener Standard, über den KI-Assistenten Werkzeuge externer Dienste aufrufen können. Der Adyen-Server läuft lokal auf Ihrem Rechner und wird per npx -y @adyen/mcp gestartet; die Kommunikation mit dem MCP-Client erfolgt über stdio. Er spricht im Auftrag des Assistenten mit der Checkout-API und der Management-API von Adyen. Weitere Schnittstellen sind laut Dokumentation in Arbeit.

Welche Werkzeuge gibt es?

Die README listet Werkzeuge in mehreren Gruppen. In der Checkout-API können Sie Zahlungssitzungen anlegen und ihr Ergebnis abfragen, verfügbare Zahlungsarten ermitteln, Zahlungslinks erstellen, deren Status lesen oder sie vorzeitig ablaufen lassen sowie autorisierte Zahlungen stornieren und erfasste Zahlungen erstatten. Die Management-API deckt Händlerkonten, Kassenterminals samt Android-Apps, Zertifikaten, Terminalaktionen und Terminaleinstellungen ab, außerdem Webhooks inklusive Testauslösung, Zahlungsmethoden, Benutzer, API-Zugangsdaten und erlaubte Ursprünge. Viele davon sind reine Leseabfragen, einige ändern aber Daten, etwa Erstattungen, Stornierungen, Terminal-Neuzuweisungen oder Einstellungsänderungen.

Wofür ist er besonders nützlich?

Der größte Nutzen liegt bei Support, Betrieb und Tests. Eine Mitarbeiterin im Kundendienst kann einen Zahlungslink erzeugen, ohne ins Kundenportal zu wechseln. Entwicklerinnen und Entwickler prüfen im Testsystem, welche Zahlungsarten für ein Konto aktiv sind oder ob ein Webhook ankommt. Wer Kassenterminals betreibt, kann Terminals auflisten und Aktionen planen. Gegenüber einem eigenen Skript gegen die REST-API sparen Sie die Einarbeitung in die Pfade und Parameter, gegenüber dem Kundenportal die Klickwege.

Einrichtung und Umgebungen

Sie benötigen Node.js, einen Adyen-API-Key und einen MCP-Client. Den Schlüssel setzen Sie als Umgebungsvariable ADYEN_API_KEY; die README empfiehlt, ihn mit read -s einzulesen, damit er nicht in der Shell-Historie landet. Für das Testsystem starten Sie npx -y @adyen/mcp --env=TEST. Für die Live-Umgebung geben Sie zusätzlich Ihr Live-URL-Präfix an: --env=LIVE --livePrefix=IHR_PRÄFIX. Das Präfix finden Sie im Customer Area unter Developers und API URLs.

Berechtigungen und Sicherheit

Das API-Credential braucht Rollen für die genutzten Bereiche, etwa Checkout, Zahlungsmethoden, Konten, Terminals und Webhooks. Adyen empfiehlt, für den Server einen eigenen Webservice-Benutzer mit eigenem Schlüssel anzulegen und die Rollen auf das Nötige zu beschränken. Mit dem Parameter --tools= laden Sie nur die Werkzeuge, die Sie wirklich brauchen, zum Beispiel ausschließlich Webhook-Abfragen. Das verkleinert das Risiko, dass der Assistent versehentlich eine Erstattung auslöst.

Kosten

Der Server ist kostenlos und quelloffen. Nutzen können ihn aber nur Adyen-Kunden mit API-Zugang; die Konditionen für Zahlungen regelt der Vertrag mit Adyen. Details nennt die offizielle Adyen-Website.

Für wen lohnt sich der Adyen MCP Server?

Er lohnt sich für Händler, Plattformen und Entwicklungsteams, die bereits mit Adyen arbeiten und wiederkehrende Aufgaben wie Zahlungslinks, Statusabfragen und Webhook-Prüfungen im Gespräch erledigen möchten. Wegen des Alpha-Status empfiehlt sich der Einstieg im Testsystem mit eingeschränkten Rollen und einer kleinen Werkzeugauswahl. Wer Adyen nicht einsetzt, hat keinen Nutzen davon, denn der Server ist keine eigenständige Zahlungslösung.

Node.js, ein Adyen-Konto mit API-Key (Webservice-Benutzer mit passenden Rollen), für die Live-Umgebung das Live-URL-Präfix und ein MCP-Client mit stdio-Unterstützung.

Mit dem Adyen MCP Server nutzt ein KI-Assistent die Checkout- und Management-API von Adyen. Dieser Ratgeber führt von den Zugangsdaten bis zur ersten Abfrage im Testsystem.

Schritt 1: Voraussetzungen prüfen

Sie benötigen Node.js, ein Adyen-Konto mit einem API-Key und einen MCP-Client wie Claude Code, Claude Desktop oder Cursor. Der Server ist laut Anbieter im Alpha-Stadium; planen Sie also nicht, ihn zuerst gegen Ihre Live-Daten laufen zu lassen.

API-Key mit passenden Rollen anlegen

Legen Sie im Customer Area einen eigenen Webservice-Benutzer für den Server an. Adyen empfiehlt, die Rollen auf die genutzten Werkzeuge zu begrenzen, etwa Lesezugriff auf Konten und Zahlungsmethoden oder die Checkout-Rolle für Zahlungslinks. Ein eigener Schlüssel erleichtert es, den Zugang später zu widerrufen.

Schritt 2: Schlüssel setzen

Geben Sie den Schlüssel so ein, dass er nicht in der Shell-Historie landet: read -s ADYEN_API_KEY und danach export ADYEN_API_KEY.

export ADYEN_API_KEY

Schritt 3: Server im Testsystem starten

Der Start erfolgt mit npx -y @adyen/mcp --env=TEST. In Claude Code tragen Sie ihn mit claude mcp add adyen -- npx -y @adyen/mcp --env=TEST ein; die Umgebungsvariable muss dabei im selben Terminal gesetzt sein. In Cursor oder VS Code hinterlegen Sie in der MCP-Konfiguration einen Eintrag vom Typ stdio mit demselben Befehl.

npx -y @adyen/mcp --env=TEST
claude mcp add adyen -- npx -y @adyen/mcp --env=TEST

Werkzeuge einschränken

Mit --tools= laden Sie nur ausgewählte Werkzeuge, zum Beispiel --tools=list_all_company_webhooks,list_all_merchant_webhooks. Das hält den Kontext des Modells klein und verhindert, dass der Assistent Funktionen wie Erstattungen überhaupt sieht.

Schritt 4: Erste Anfragen

Beginnen Sie lesend: „Welche Händlerkonten gehören zu meinem Unternehmen?“ oder „Welche Webhooks sind für dieses Konto eingerichtet?“. Danach können Sie im Testsystem einen Zahlungslink erstellen lassen und dessen Status abfragen.

Live-Umgebung

Für Live starten Sie mit --env=LIVE --livePrefix=IHR_PRÄFIX. Das Präfix finden Sie im Customer Area unter Developers und API URLs. Prüfen Sie vorher die Rollen des Schlüssels und bestätigen Sie schreibende Aufrufe wie Erstattungen einzeln, statt sie automatisch freizugeben.

Adyen-API-Key in der Umgebungsvariable ADYEN_API_KEY; der Schlüssel gehört zu einem Webservice-Benutzer, dessen Rollen bestimmen, was der Server darf.

Zugriff auf Checkout- und Management-API im Rahmen der Rollen des API-Credentials: Zahlungen, Zahlungslinks, Erstattungen, Konten, Terminals, Webhooks, Zahlungsmethoden und Benutzer. Über --tools lässt sich die Werkzeugauswahl einschränken.

Der Server läuft lokal und ruft die Adyen-Schnittstellen mit Ihrem Schlüssel auf. Abgerufene Zahlungs-, Konto- und Benutzerdaten gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Unbeabsichtigte Erstattungen, Stornierungen oder Terminaländerungen, besonders in der Live-Umgebung und bei automatisch bestätigten Aufrufen, sowie Weitergabe von Zahlungs- und Personendaten an den Modellanbieter.