Klarna MCP-server
communityKlarnas egen MCP-server gäller produktsök för konsumenter, så för handlarsidan har Walma byggt klarna-mcp, öppen källkod. Den läser ordrar, utbetalningar, avräkningstransaktioner och tvister, och skrivverktygen finns bara när de slås på uttryckligen.
Vad en agent kan göra
- → Läsa ordrar, debiteringar och återbetalningar
- → Summera utbetalningar per period och valuta
- → Lista avräkningstransaktioner per utbetalning
- → Följa upp tvister och deras deadlines
- → Debitera och återbetala, bara med flagga
Byggd mot Klarnas publicerade API-referens och testad mot mockade svar, men ännu inte verifierad mot ett riktigt Klarna-konto. Kör den i Klarnas testmiljö först.
Om Klarna MCP-server
klarna-mcp är en liten MCP-server som Walma har byggt och släppt som öppen källkod med MIT-licens. Den ger Claude, Cursor, Claude Code och andra MCP-klienter tillgång till Klarnas handlar-API:er: ordrar, debiteringar, återbetalningar, utbetalningar, avräkningstransaktioner, tvister och betalsessioner. Projektet är inofficiellt, alltså varken gjort, godkänt eller supportat av Klarna, och det körs på er egen dator eller server.
E-handels- och ekonomiteam använder den för att se vad som är auktoriserat, debiterat och återbetalt på en order och när auktoriseringen går ut, summera utbetalningar per valuta för en period, se vilka avgifter och returer som ingår i en viss utbetalning och lista öppna tvister med närmaste deadline. Utbetalningsrapporter kan hämtas som CSV och stämmas av mot butikens egen export.
Servern läser bara som standard. Skrivverktygen finns inte ens på servern förrän KLARNA_ENABLE_WRITES är satt till true, och den startar mot Klarnas testmiljö tills ni väljer produktion. API-uppgifterna läses från miljövariabler och skickas bara i Authorization-huvudet, och allt som liknar en uppgift tas bort ur felmeddelanden. PDF-rapporter, orderändringar, svar på tvister och att skapa ordrar eller betalsessioner är medvetet utelämnade.
Saker att be om
- Lista gårdagens utbetalningar och summorna per valuta.
- Vilka tvister har en deadline den här veckan?
- Visa status för en order: vad som är debiterat, återbetalt och kvar.
- Ge mig avräkningstransaktionerna bakom en utbetalningsreferens.
Verktyg som servern har
- 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
Ingår i paketen
Klarna ingår i de här Walma-paketen.
Frågor om Klarna MCP
Har Klarna en officiell MCP-server?+
Klarnas egen MCP-server gäller produktsök för konsumenter. För handlarens sida, alltså ordrar, utbetalningar och tvister, har Walma byggt klarna-mcp som öppen källkod med MIT-licens. Den är inofficiell och varken gjord eller godkänd av Klarna.
Är servern skrivskyddad?+
Som standard ja: 13 läsverktyg. De fem skrivverktygen (debitera, återbetala, förlänga auktorisering, avbryta, släppa resterande belopp) registreras bara om KLARNA_ENABLE_WRITES är satt till true. Utan den finns de inte på servern, vad än prompten säger.
Vilka uppgifter behöver servern?+
En API-uppgift från Klarnas handlarportal: användarnamn och lösenord, eller en nyckel som börjar med klarna_test_api_ eller klarna_live_api_. Den läses från miljövariabler och hamnar aldrig i konversationen. Skapa en egen uppgift för agenten så att den går att dra in separat.
Vilka klienter fungerar den med?+
Claude Code, Claude Desktop, Cursor och andra MCP-klienter som kan starta en lokal server. Den kräver Node 20 eller nyare och byggs från GitHub, eftersom paketet inte ligger på npm.
Är den testad mot Klarna på riktigt?+
Den är byggd mot Klarnas publicerade API-referens och testad mot mockade svar, men ännu inte verifierad mot ett riktigt Klarna-konto. Servern startar därför i Klarnas testmiljö som standard. Kör den där först.
Vilka Klarna-regioner och miljöer stöder servern?+
Tre regioner, som väljs med KLARNA_REGION: eu (standard), na och oc. Miljön väljs med KLARNA_ENV: playground (standard) eller production. Tillsammans pekar de ut Klarnas dokumenterade adresser, till exempel api.klarna.com och api.playground.klarna.com för Europa. Klarnas referens för Disputes API v4 listar bara EU-adresserna, och tvister kräver att handlarkontot är anslutet till det API:et.
Hur skyddas skrivningar mot dubbletter och misstag?+
Varje skrivning skickar en idempotensnyckel till Klarna. Verktyget skapar en om ni inte anger någon och returnerar den i svaret. Gör ni om en misslyckad skrivning med samma nyckel utför Klarna den högst en gång, och nycklarna sparas i 24 timmar. Verktyg som flyttar pengar eller inte går att ångra är märkta som destruktiva, så klienter som följer märkningen frågar först.
Saknar ni en koppling?
Vi bygger och granskar MCP-servrar åt team som behöver dem, och kör dem bakom samma policy och logg som resten av gatewayen.