MCP-server

Snakk med produktkatalogen din

MCP (Model Context Protocol) er den åpne standarden som lar en AI-agent koble seg trygt til en tjeneste og bruke den — akkurat som en person ville brukt Atlas selv, bare fra en samtale. Koble til under, uten å skrive en linje kode.

Koble til på ett minutt

Koble til

Koble til agenten din

Velg verktøyet du bruker. Claude Code, Cursor og andre agenter tar en API-nøkkel; Claude.ai og Claude Desktop klarer seg med en innlogging.

Én kommando. Lag først en nøkkel under Innstillinger → API-nøkler, så kjør:

bash

claude mcp add --transport http atlas https://atlas.flowretail.com/api/v1/mcp \
  --header "Authorization: Bearer atlas_live_DIN_NØKKEL"

Bytt ut atlas_live_DIN_NØKKEL med hele nøkkelen — inkludert atlas_live_-prefikset. Prefikset er en del av nøkkelen, ikke en plassholder.
Ordet Bearer og mellomrommet etter skal stå. Hele verdien blir Bearer atlas_live_…
Behold hermetegnene rundt headeren — uten dem deler skallet den ved mellomrommet.

Sjekk at den svarer med claude mcp list — Atlas skal stå som «Connected». Be den så kjøre atlas_discover for å se hvilke tilganger nøkkelen faktisk har.

Legg serveren i .cursor/mcp.json i prosjektet, eller i den globale MCP-konfigurasjonen.

.cursor/mcp.json

{
  "mcpServers": {
    "atlas": {
      "url": "https://atlas.flowretail.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer atlas_live_DIN_NØKKEL"
      }
    }
  }
}

Bytt ut atlas_live_DIN_NØKKEL med hele nøkkelen — inkludert atlas_live_-prefikset. Prefikset er en del av nøkkelen, ikke en plassholder.
Ordet Bearer og mellomrommet etter skal stå. Hele verdien blir Bearer atlas_live_…
Behold hermetegnene rundt headeren — uten dem deler skallet den ved mellomrommet.

Ingen nøkkel å hente. Du logger inn i Atlas i et vanlig nettleservindu og godkjenner tilgangen.

1Åpne Innstillinger → Tilkoblinger, og velg «Legg til tilpasset tilkobling».
2Lim inn adressen under.
3La feltene for Client ID og Client Secret stå tomme — Atlas registrerer klienten selv.
4Logg inn med Atlas-kontoen din i vinduet som åpnes, velg virksomhet hvis du blir spurt, og godkjenn.

MCP-adresse

https://atlas.flowretail.com/api/v1/mcp

Godkjenningen oppretter en helt vanlig API-nøkkel i Atlas, merket «OAuth (MCP)». Du finner og tilbakekaller den under Innstillinger → API-nøkler.

Samme framgangsmåte som på Claude.ai: åpne Innstillinger → Tilkoblinger, velg «Legg til tilpasset tilkobling», lim inn adressen under, la Client ID og Client Secret stå tomme, og logg inn i vinduet som åpnes.

MCP-adresse

https://atlas.flowretail.com/api/v1/mcp

MCP er en åpen standard, og enhver klient som snakker Streamable HTTP kan bruke serveren: POST til adressen med nøkkelen i en Authorization-header. Ingen sesjon å holde på — hvert kall står på egne bein.

bash

curl -X POST https://atlas.flowretail.com/api/v1/mcp \
  -H "Authorization: Bearer atlas_live_DIN_NØKKEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Bytt ut atlas_live_DIN_NØKKEL med hele nøkkelen — inkludert atlas_live_-prefikset. Prefikset er en del av nøkkelen, ikke en plassholder.
Ordet Bearer og mellomrommet etter skal stå. Hele verdien blir Bearer atlas_live_…
Behold hermetegnene rundt headeren — uten dem deler skallet den ved mellomrommet.

Trenger klienten stdio i stedet, kjører du @atlas/mcp som prosess — se utviklerdokumentasjonen.

Autentisering

To måter å slippe inn

Begge ender på det samme: en API-nøkkel som aldri kan gjøre mer enn kontoen din selv.

API-nøkkel som header

For Claude Code, Cursor, egen kode — og enhver annen agent. Du lager nøkkelen under Innstillinger → API-nøkler, velger hvilke tilganger den skal ha, og sender den som Authorization: Bearer. Samme nøkkel brukes mot /api/v1 — det er ikke to slags nøkler.

Innlogging i nettleseren

For klienter som støtter OAuth, som Claude.ai og Claude Desktop. Du logger inn, velger virksomhet og godkjenner — nøkkelen lages for deg. Ingenting å kopiere.

Kom i gang

Be agenten om dette

Du følger med og retter underveis, i en vanlig samtale.

Legg inn en leverandørliste

«Her er 40 produkter fra leverandøren min. Slå opp merket og produktgruppen i Atlas først, kjør en prøve, og vis meg hva som ville blitt opprettet før du skriver noe.»

Rydd opp i tekstene

«Finn produktene i Atlas som mangler beskrivelse, og skriv en kort en til hvert av dem i vår tone. Vis meg de fem første før du fortsetter.»

Bygg en variantfamilie

«Opprett denne genseren i svart, grå og marine, i størrelsene S til XL, og sett fargeprikken på hver farge. Bruk egenskapene som allerede finnes i Atlas — ikke lag nye.»

Hva serveren tilbyr

Verktøyene agenten får

Gruppert etter tilgangen de krever. Gir du nøkkelen færre tilganger, får agenten færre verktøy — og ser bare dem.

Uten egen tilgang

Les

atlas_discoverSier hvem nøkkelen tilhører, hvilke tilganger den har og hva som finnes.
atlas_read_skillHenter hele bruksanvisningen for API-et.

Lese produkter

Lesproducts:read

atlas_list_productsLister produkter, sidevis. Kan filtrere på endret siden, varekode og GTIN.
atlas_get_productHenter ett produkt med variantene sine.
atlas_list_axis_imagesViser hvilke bilder som ligger per akseverdi (typisk farge) på et konfigurerbart produkt.

Opprette og endre produkter

Skrivproducts:write

atlas_create_productsOppretter produkter og varianter. Kan kjøres som prøve først, uten å skrive noe.
atlas_update_productOppdaterer ett produkt eller én variant. Felt du sender, overskriver.
atlas_attach_product_imageHenter bilder fra URL-er og fester dem til et produkt eller en variant.
atlas_upload_imageLaster opp bildefiler fra maskinen MCP-en kjører på, og svarer med asset-id-er. Bare for en lokal tilkobling.
atlas_attach_axis_imagesFester bilder til én farge (akseverdi) på et konfigurerbart produkt — de havner på hver variant med den verdien.
atlas_archive_productArkiverer et produkt eller en variant. Kaskaderer til variantene på et hovedprodukt, og kan angres i Atlas.

Lese registre

Lesregisters:read

atlas_list_brandsLister merker.
atlas_list_product_groupsHenter produktgruppetreet.
atlas_list_categoriesHenter kategoritreet.
atlas_list_attributesLister egenskaper.
atlas_list_attribute_valuesLister verdiene på en egenskap.

Opprette registeroppføringer

Skrivregisters:write

atlas_create_brandsOppretter merker (finn-eller-opprett).
atlas_create_product_groupsOppretter produktgrupper.
atlas_create_categoriesOppretter kategorier.
atlas_create_attributesOppretter egenskaper.
atlas_add_attribute_valuesLegger til egenskapsverdier.

Generere AI-bilder

Skrivimages:generate

atlas_generate_imageGenererer AI-bilder fra referansefoto. Faktureres per bilde.

Grensene, uttalt

Ingenting slettes fysisk. Agenten kan arkivere et produkt, og du kan hente det tilbake i Atlas — og det rører aldri produktet i kassen eller nettbutikken din.
Ingen push eller synk til Flow Retail eller Shopware. Det er et eget steg du gjør i Atlas, med full oversikt før noe går ut i butikken.
Aldri mer tilgang enn din egen rolle. Nøkkelen kan aldri gjøre mer enn kontoen din selv kan, og du velger hvilke tilganger den får.
Ingen tilgang til andre virksomheter. En tilkobling gjelder én virksomhet.

Spørsmål og svar

Når noe ikke virker

Hvor får jeg API-nøkkelen, og hva må den ha?

Under Innstillinger → API-nøkler i Atlas. Brukeren må ha «API-tilgang» krysset av under Innstillinger → Brukere, og rollen må være Redaktør eller Administrator. Når du lager nøkkelen velger du hvilke tilganger den skal ha — gi den bare det agenten skal kunne. Nøkkelen vises ÉN gang; vi lagrer bare en hash, så den kan ikke hentes fram igjen.

Claude.ai spør om «OAuth Client ID» og «Client Secret». Hva skal jeg fylle inn?

Ingenting — la begge feltene stå tomme. Atlas registrerer klienten automatisk første gang du kobler til. Feltene er der for tjenester som krever at du oppretter en klient manuelt, og Atlas gjør ikke det.

Hvorfor får jeg «401» eller «ugyldig API-nøkkel»?

Tre ting må stemme: nøkkelen må finnes og ikke være tilbakekalt, rollen må være Redaktør eller Administrator, og «API-tilgang» må være krysset av på brukeren. Feilmeldingen skiller mellom dem: «ugyldig eller tilbakekalt» betyr at nøkkelen selv er problemet, mens «ingen API-tilgang» betyr at nøkkelen er riktig og det er rollen eller avkryssingen som mangler. Får du 401 uten noen melding i det hele tatt, mangler headeren — sjekk at ordet «Bearer» og mellomrommet etter står der.

Hvorfor kan jeg ikke åpne MCP-adressen i nettleseren?

Den svarer bare på POST, så en nettleser får «405 Method Not Allowed». Det er riktig oppførsel og ikke et tegn på at noe er galt — adressen er ment for en MCP-klient, ikke for et adressefelt.

Hvilken transport bruker serveren?

Streamable HTTP, uten sesjon mellom kallene. Hvert kall står på egne bein og svaret er vanlig JSON, ikke en SSE-strøm. Klienter som bare snakker den gamle SSE-transporten må bruke stdio-varianten i stedet.

Jeg har tilgang til flere virksomheter i Atlas. Hvilken kobles til?

Med en API-nøkkel er det virksomheten nøkkelen ble laget i — én nøkkel per virksomhet. Logger du inn i nettleseren i stedet, blir du spurt én gang. En tilkobling bytter aldri virksomhet underveis.

Hvordan ser jeg at tilkoblingen virket?

Be agenten kjøre atlas_discover. Den svarer med hvem nøkkelen tilhører, hvilken rolle den har, hvilke tilganger den har — og hvilke den mangler. Er det svaret riktig, virker resten også. I Claude Code kan du også kjøre «claude mcp list» og se at Atlas står som «Connected».

Hvordan trekker jeg tilgangen tilbake?

Under Innstillinger → API-nøkler. Både nøkler du har laget selv og de som opprettes ved innlogging fra en agent (merket «OAuth (MCP)») står der, og du tilbakekaller dem på samme måte. Tilgangen slutter å virke umiddelbart.

Koster det noe?

Selve tilkoblingen og verktøyene koster ingenting utover abonnementet ditt. Det ene unntaket er generering av AI-bilder, som faktureres per bilde — derfor er det en egen tilgang du kan la være å gi nøkkelen.

Kan agenten ødelegge noe?

Ingenting er permanent. Agenten kan arkivere et produkt, men ikke slette det fysisk — arkiverte produkter hentes tilbake i Atlas. Den kan ikke sende noe ut til Flow Retail eller Shopware; det steget gjør du selv. Skriveverktøyene kan overskrive felt, så be om en prøvekjøring (dry_run) først på alt som er større enn noen få rader. Vil du være helt sikker, gi nøkkelen bare lesetilgang — da får agenten ingen skriveverktøy i det hele tatt. Merk at arkivering av et hovedprodukt kaskaderer til alle variantene dets.

Full kontroll på alle produkt-data.

Opprett konto, koble til Flow Retail eller Shopware, og publiser det første produktet på minutter.

Opprett konto gratis Se priser