← MCP-katalogen

Adyen MCP-server

beta

Adyen publicerar en egen MCP-server, i alfaversion, som kör lokalt och översätter instruktioner i naturligt språk till anrop mot Checkout API och Management API. Den fungerar mot både test- och livemiljö med en API-nyckel från Adyens kundportal.

Vad en agent kan göra

  • → Skapa betalsessioner och betallänkar
  • → Återbetala eller avbryta betalningar
  • → Läsa handlarkonton och betalmetoder
  • → Hantera terminaler och deras inställningar
  • → Lista och testa webhooks

Servern är i alfa och har skrivbehörighet som standard. Begränsa API-nyckelns roller och starta bara de verktyg ni behöver med flaggan --tools innan den kopplas mot livemiljön.

Om Adyen MCP-server

Adyens MCP-server är ett öppet projekt som Adyen själva publicerar på GitHub, med märkningen Alpha. Den körs lokalt på er egen dator eller server och startas med ett npx-kommando. Därifrån låter den en AI-assistent anropa Adyens Checkout API och Management API med instruktioner i vanlig text. Adyen skriver att fler API:er och ändpunkter är planerade.

Ett betalteam använder den för att skapa betalsessioner och betallänkar, kontrollera status på en länk eller tvinga den att löpa ut, och för att avbryta en auktoriserad betalning eller återbetala en debiterad. På administrationssidan listar den handlarkonton, betalmetoder, användare, API-uppgifter och webhooks, testar en webhook och hanterar betalterminaler: lista, flytta, schemalägga åtgärder och ändra inställningar.

Åtkomsten styrs helt av API-nyckeln och de roller dess webservice-användare har. Adyen rekommenderar en ny användare och en ny nyckel som bara används här, med roller som motsvarar de verktyg ni använder. Med flaggan --tools startar ni bara ett urval av verktygen. Servern arbetar mot testmiljön eller livemiljön, och live kräver dessutom ert prefix för live-adresser.

Saker att be om

  • Skapa en betallänk på 1 200 kronor för order 4471 i testmiljön.
  • Vilka betalmetoder är aktiverade på vårt handlarkonto?
  • Lista alla webhooks på företagskontot och testa den som går till ordersystemet.
  • Vilka terminaler har vi, och vilken butik är var och en kopplad till?
  • Tvinga betallänken med det här id:t att löpa ut och bekräfta dess status efteråt.

Så kopplar du in Adyen

  1. Skapa en ny webservice-användare i Adyens Customer Area och generera en API-nyckel som bara används för MCP-servern. Ge användaren enbart de roller som verktygen ni tänker använda kräver.
  2. Lägg nyckeln i miljövariabeln ADYEN_API_KEY, utan att den hamnar i kommandohistoriken.
  3. Lägg till servern i er MCP-klient som en lokal server med kommandot npx -y @adyen/mcp --env=TEST.
  4. För livemiljön: använd --env=LIVE och lägg till --livePrefix med ert prefix, som finns i live Customer Area under Developers, API URLs, Prefix.
  5. Begränsa gärna till de verktyg ni behöver med --tools, till exempel --tools=list_all_company_webhooks,list_all_merchant_webhooks.

Ingår i paketen

Adyen ingår i de här Walma-paketen.

Frågor om Adyen MCP

Är Adyens MCP-server gratis?+

Koden är öppen och ligger på GitHub med MIT-licens. Adyen anger ingen avgift för själva servern, men ni behöver ett Adyen-konto och en API-nyckel för att den ska kunna göra något. Adyen anger inga särskilda användningsgränser för servern.

Vilken adress har Adyens MCP-server?+

Det finns ingen. Adyen beskriver bara en server som körs lokalt, och nämner ingen hostad variant. Paketet heter @adyen/mcp och startas med npx -y @adyen/mcp --env=TEST. Källkoden finns på github.com/Adyen/adyen-mcp.

Hur loggar man in på Adyens MCP-server?+

Med en API-nyckel från Adyens Customer Area, som servern läser från miljövariabeln ADYEN_API_KEY. Det finns ingen inloggning med OAuth. Nyckeln behövs både för att starta servern och för att autentisera anropen, och vad den får göra bestäms av rollerna på dess webservice-användare.

Är Adyens MCP-server skrivskyddad?+

Nej. Den kan skapa betalsessioner och betallänkar, avbryta och återbetala betalningar, flytta terminaler, schemalägga terminalåtgärder och ändra terminalinställningar. Adyen beskriver inget särskilt läsläge. Ni begränsar servern genom att bara starta vissa verktyg med --tools och genom att ge API-nyckeln färre roller.

Vilka AI-assistenter fungerar Adyens MCP-server med?+

Adyens dokumentation säger att ni kan använda en valfri LLM-klient. Det enda konfigurationsexemplet i projektets README gäller VS Code, där servern läggs in som en lokal stdio-server. Adyen nämner inte Claude, ChatGPT eller Cursor vid namn.

Fungerar Adyens MCP-server mot livemiljön?+

Ja. Med --env=TEST räcker API-nyckeln. Med --env=LIVE måste ni också ange ert prefix för live-adresser med --livePrefix. Prefixet finns i live Customer Area under Developers, API URLs, Prefix. Projektet är märkt Alpha, så prova i testmiljön först.

Vilka roller behöver API-nyckeln?+

Det beror på verktygen. Adyen listar bland annat Checkout Webservice Role, Merchant PAL Webservice Role och Management API-roller för konton, betalmetoder, terminaler, terminalåtgärder, terminalinställningar, webhooks och API-uppgifter. Adyen råder er att begränsa rollerna till de verktyg ni faktiskt använder.

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.