Koble rapportene til en KI-assistent (MCP)

MCP (Model Context Protocol) er en standard som lar en KI-assistent hente data fra andre systemer. Med MCP kan du eller regnskapsføreren spørre en KI-assistent som Claude om tall fra butikken – for eksempel «Hvordan gikk salget i september sammenlignet med i fjor?» – og assistenten henter svaret fra rapportene dine.

Tilgangen gir kun lesetilgang. Ingenting kan endres gjennom MCP.

Før du starter

• MCP må være slått på for butikken av Cmerce. Er den ikke det, viser siden «Ikke aktivert» med teksten «Rapporter via MCP er ikke slått på for butikken din.» Ta kontakt med Cmerce for å få det aktivert.
• Du trenger tilgangen «Opprette API-tilgang for rapporter (MCP)». Rollene Eier, Administrator og Regnskapsfører har den som standard.
• Du trenger en KI-klient som støtter eksterne MCP-servere over HTTP med en egen Authorization-header, for eksempel Claude Code.

Slik gjør du det

1. Lag en tilgangsnøkkel

1. Gå til «Integrasjoner» → «API-tilgang for rapporter».
2. Trykk «Opprett tilgangsnøkkel».
3. Gi nøkkelen et «Navn» du kjenner igjen, for eksempel «Claude – regnskapsfører».
4. Velg hvor lenge den skal være «Gyldig i»: 30, 90, 180 eller 365 dager.
5. Trykk «Opprett».
6. Trykk «Kopier» og lagre nøkkelen et trygt sted. Trykk «Ferdig».

2. Koble til KI-klienten

Under «Slik kobler du til» står adressen til butikkens MCP-server. Gi KI-klienten adressen og nøkkelen som en Authorization: Bearer-header. I Claude Code ser det slik ut (bytt ut adressen og nøkkelen med dine egne):

claude mcp add --transport http cmerce-rapporter https://minbutikk.cmerce.no/mcp/v1/reports --header "Authorization: Bearer DIN-NØKKEL"

Andre klienter har egne innstillinger for dette. Se dokumentasjonen til klienten du bruker.

Hva KI-assistenten får tilgang til

• rapportene du selv har tilgang til, med periode, filtre og sammenligning
• nøkkeltallene fra rapportoversikten
• ordrehoder og ordrelinjer (krever tilgang til ordrer)
• Z-rapporter (krever tilgang til kasserapporter)
• produktsøk på navn og SKU

Alle tall er informasjon. Unntaket er Z-rapporten, som hentes slik den ble signert, og som er det gjeldende dagsoppgjøret for kassen.

Hva den aldri får

• kundenavn, e-post, telefon eller adresser – kunder vises bare som en anonym ID
• hvem som har jobbet i kassen, eller tall per ansatt
• gavekortkoder, rabattkoder, kortdata eller betalingsreferanser
• passord, nøkler og andre hemmeligheter
• signaturer og innhold fra den elektroniske journalen
• data fra andre butikker

Kunderapportene og rapporten «Operatører» er ikke tilgjengelige over MCP.

Godt å vite

• Nøkkelen har dine rettigheter – aldri mer. Den virker som brukeren som laget den. Mister brukeren tilgangen, slutter nøkkelen å virke med én gang.
• Tilbakekall en nøkkel med «Tilbakekall» i tabellen. Neste forsøk blir avvist.
• Oversikt: Tabellen viser «Navn», «Eier», «Opprettet», «Sist brukt» og «Utløper» for hver nøkkel.
• Grenser: 60 kall i minuttet per nøkkel og 2 000 kall per døgn for butikken.
• Logging: Hvert kall registreres i kontrollsporet med hvilken rapport og periode som ble hentet – men aldri tallene som ble sendt tilbake.
• Ikke det samme som KI-innsikt. MCP er din egen KI-assistent som henter tall. KI-innsikt er en kommentar på rapportoversikten. Se KI-innsikt.

Vanlige spørsmål

Kan regnskapsføreren bruke sin egen KI-assistent?

Ja. En bruker med rollen Regnskapsfører kan lage sin egen nøkkel. Assistenten ser da det regnskapsføreren har tilgang til.

KI-assistenten svarer med feil tall – hva nå?

KI-assistenten kan misforstå eller regne feil. Kontroller viktige tall i rapportene, og bruk alltid Z-rapporten for kassens gjeldende tall.