Klarna MCP-Server
CommunityKlarnas eigener MCP-Server deckt die Produktsuche für Endkunden ab, deshalb hat Walma für die Händlerseite klarna-mcp gebaut, als Open Source. Er liest Bestellungen, Auszahlungen, Abrechnungstransaktionen und Streitfälle, und seine Schreibwerkzeuge gibt es nur, wenn sie ausdrücklich eingeschaltet werden.
Was ein Agent tun kann
- → Bestellungen, Erfassungen und Erstattungen lesen
- → Auszahlungen pro Zeitraum und Währung summieren
- → Abrechnungstransaktionen pro Auszahlung auflisten
- → Streitfälle und Fristen verfolgen
- → Erfassen und erstatten, nur per Schalter
Gegen Klarnas veröffentlichte API-Referenz gebaut und gegen simulierte Antworten getestet, aber noch nicht mit einem echten Klarna-Konto geprüft. Nutzen Sie zuerst Klarnas Testumgebung.
Über den Klarna MCP-Server
klarna-mcp ist ein kleiner MCP-Server, den Walma gebaut und als Open Source unter MIT-Lizenz veröffentlicht hat. Er gibt Claude, Cursor, Claude Code und anderen MCP-Clients Zugriff auf die Händler-APIs von Klarna: Bestellungen, Zahlungserfassungen, Erstattungen, Auszahlungen, Abrechnungstransaktionen, Streitfälle und Zahlungssitzungen. Das Projekt ist inoffiziell, also weder von Klarna erstellt noch freigegeben oder unterstützt, und läuft auf Ihrem eigenen Rechner oder Server.
E-Commerce- und Finanzteams sehen damit, was bei einer Bestellung autorisiert, erfasst und erstattet ist und wann die Autorisierung abläuft, summieren Auszahlungen pro Währung für einen Zeitraum, prüfen, welche Gebühren und Retouren in einer bestimmten Auszahlung stecken, und listen offene Streitfälle mit den nächsten Fristen auf. Auszahlungsberichte lassen sich als CSV abrufen und mit dem eigenen Export des Shops abgleichen.
Standardmäßig liest der Server nur. Die Schreibwerkzeuge existieren auf dem Server erst, wenn KLARNA_ENABLE_WRITES auf true steht, und er startet gegen Klarnas Testumgebung, bis Sie die Produktion wählen. Zugangsdaten werden aus Umgebungsvariablen gelesen und nur im Authorization-Header gesendet, und alles, was nach Zugangsdaten aussieht, wird aus Fehlermeldungen entfernt. PDF-Berichte, Bestelländerungen, Antworten auf Streitfälle und das Anlegen von Bestellungen oder Zahlungssitzungen fehlen bewusst.
Das können Sie fragen
- Listen Sie die Auszahlungen von gestern und die Summen pro Währung auf.
- Welche Streitfälle haben diese Woche eine Frist?
- Zeigen Sie den Status einer Bestellung: was erfasst, erstattet und offen ist.
- Geben Sie mir die Abrechnungstransaktionen zu einer Auszahlungsreferenz.
Werkzeuge des Servers
- get_order
- list_captures
- get_capture
- get_refund
- list_payouts
- get_payout
- get_payout_summary
- list_transactions
- get_payout_report_csv
- get_payouts_summary_report_csv
- list_disputes
- get_dispute
- get_payment_session
- capture_order
- refund_order
- extend_authorization_time
- cancel_order
- release_remaining_authorization
Enthalten in diesen Paketen
Klarna ist in diesen Walma-Paketen enthalten.
Fragen zu Klarna MCP
Hat Klarna einen offiziellen MCP-Server?+
Klarnas eigener MCP-Server deckt die Produktsuche für Endkunden ab. Für die Händlerseite, also Bestellungen, Auszahlungen und Streitfälle, hat Walma klarna-mcp als Open Source unter MIT-Lizenz gebaut. Er ist inoffiziell und weder von Klarna erstellt noch freigegeben.
Ist der Server schreibgeschützt?+
Standardmäßig ja: 13 Lesewerkzeuge. Die fünf Schreibwerkzeuge (erfassen, erstatten, Autorisierung verlängern, stornieren, Restbetrag freigeben) werden nur registriert, wenn KLARNA_ENABLE_WRITES auf true steht. Ohne diese Einstellung gibt es sie auf dem Server nicht, egal was der Prompt verlangt.
Welche Zugangsdaten braucht der Server?+
Zugangsdaten aus dem Klarna-Händlerportal: Benutzername und Passwort oder einen Schlüssel, der mit klarna_test_api_ oder klarna_live_api_ beginnt. Sie werden aus Umgebungsvariablen gelesen und gelangen nie in die Unterhaltung. Legen Sie eigene Zugangsdaten für den Agenten an, damit sie sich einzeln widerrufen lassen.
Mit welchen Clients funktioniert er?+
Claude Code, Claude Desktop, Cursor und andere MCP-Clients, die einen lokalen Server starten können. Er benötigt Node 20 oder neuer und wird aus GitHub gebaut, da das Paket nicht auf npm liegt.
Wurde er gegen das echte Klarna getestet?+
Er ist gegen Klarnas veröffentlichte API-Referenz gebaut und gegen simulierte Antworten getestet, aber noch nicht mit einem echten Klarna-Konto geprüft. Der Server startet deshalb standardmäßig in Klarnas Testumgebung. Nutzen Sie ihn zuerst dort.
Welche Klarna-Regionen und Umgebungen unterstützt der Server?+
Drei Regionen, gewählt über KLARNA_REGION: eu (Standard), na und oc. Die Umgebung wird über KLARNA_ENV gewählt: playground (Standard) oder production. Zusammen ergeben sie die von Klarna dokumentierten Adressen, zum Beispiel api.klarna.com und api.playground.klarna.com für Europa. Klarnas Referenz zur Disputes API v4 nennt nur die EU-Adressen, und Streitfälle setzen voraus, dass das Händlerkonto für diese API freigeschaltet ist.
Wie sind Schreibvorgänge gegen Dubletten und Fehler abgesichert?+
Jeder Schreibvorgang sendet einen Idempotenzschlüssel an Klarna. Das Werkzeug erzeugt einen, wenn Sie keinen angeben, und gibt ihn im Ergebnis zurück. Wiederholen Sie einen fehlgeschlagenen Schreibvorgang mit demselben Schlüssel, führt Klarna ihn höchstens einmal aus, die Schlüssel werden 24 Stunden aufbewahrt. Werkzeuge, die Geld bewegen oder sich nicht rückgängig machen lassen, sind als destruktiv markiert, sodass Clients, die das beachten, vorher nachfragen.
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.