Adyen MCP-Server: KI-Agenten aus der EU mit Adyen verbinden

Die Adyen N.V. ist eine Zahlungsplattform aus Amsterdam, die große Händler, Marktplätze und Reiseunternehmen für Online-, In-App- und Ladenzahlungen nutzen. Ihr MCP-Server @adyen/mcp wird von Adyen auf GitHub unter MIT-Lizenz veröffentlicht und auf docs.adyen.com dokumentiert.

Der Server ist im Alpha-Stadium und läuft lokal per stdio mit npx. Er deckt Checkout-Sitzungen, Zahlungslinks und Modifications ab sowie Bereiche der Management-API für Konten, Terminals, Webhooks, Zahlungsarten und Benutzer. Neuere Versionen kennzeichnen jedes Tool als lesend, idempotent oder destruktiv.

Ein Kundenservice-Agent ruft eine Zahlungssitzung ab und bereitet für eine Retoure eine Erstattung mit der richtigen PSP-Referenz vor, die eine Person bestätigt. Ein Vertriebsteam legt für eine B2B-Bestellung einen Zahlungslink an und prüft später, ob bezahlt wurde.

Operations-Teams verwalten damit die Filialgeräte: welches Terminal in welchem Laden steht, welche Einstellungen gelten und welche Aktionen wie App-Installationen geplant sind. Entwickler listen und testen Webhooks beim Debuggen einer Integration, ohne für jede Prüfung die Customer Area zu öffnen.

Adyen empfiehlt, für den MCP-Server einen neuen Webservice-Benutzer anzulegen, ihm nur die Rollen der geplanten Tools zu geben und dafür einen API-Schlüssel zu erzeugen. Fügen Sie auf inference.eu den Adyen-Connector zu einem Agenten hinzu und hinterlegen Sie diesen Schlüssel; er wird verschlüsselt in der EU gespeichert.

Wählen Sie zuerst die Umgebung TEST. Für LIVE geben Sie zusätzlich Ihr Live-URL-Präfix aus der Customer Area an. Mit der Option --tools stellen Sie nur die Tools bereit, die ein Ablauf braucht, etwa Webhook-Tools für einen Entwickler-Agenten.

Der Server ruft die Adyen-APIs direkt auf, Zahlungs- und Terminaldaten fließen also zwischen Ihnen und Adyen, einem niederländischen Unternehmen, genau wie bei Ihrer bestehenden Integration. Adyen ist in beiden Fällen der verarbeitende Zahlungsdienstleister.

Auf inference.eu läuft das Modell, das Zahlungsdetails liest, in Rechenzentren in der EU, und Ihr API-Schlüssel wird verschlüsselt in der EU gespeichert. Zahlungssitzungen und Erstattungen können Namen, E-Mail-Adressen und Teile von Kartendaten enthalten; geben Sie den Connector nur den Agenten und Personen, die heute schon Zahlungen bearbeiten.

Erstattungen, Stornierungen, Zahlungslinks und Terminaländerungen haben echte Folgen, und der Server ist noch Alpha. Nutzen Sie einen Webservice-Benutzer mit engen Rollen, beginnen Sie in der Testumgebung und aktivieren Sie nur benötigte Tools.

Auf inference.eu verlangen Sie für jedes als destruktiv markierte Tool eine Freigabe durch eine Person, etwa Erstattungen, Stornierungen, Terminal-Zuordnungen und Einstellungsänderungen. Lesende Tools wie das Auflisten von Webhooks oder Zahlungsarten laufen selbstständig. Den Endzustand prüfen Menschen weiterhin in der Adyen Customer Area.