API og MCP — koble dine egne verktøy til regnskapet

REST-API: det samme du kan gjøre i appen

Appen er bygd på det samme API-et du får tilgang til. Alle endepunktene under /api/ er beskrevet i en OpenAPI 3-spesifikasjon som ligger åpent ute, uten innlogging:

• Swagger UI — bla i endepunktene og se parametere og svar.
• /v3/api-docs — maskinlesbar spesifikasjon (JSON) til kodegeneratorer og Postman.

Område	Eksempler
Bilag og kontoplan	Registrere og søke i bilag, slå opp kontoer
Rapporter	Saldobalanse, resultat, balanse, hovedbok og MVA for en valgfri periode
Faktura og reskontro	Utgående fakturaer, åpne poster på kunder og leverandører
Bilag inn	Laste opp en PDF eller et bilde som blir et konteringsforslag i Innboks
Bank	Import av kontoutskrift og avstemming
Kassesalg (v1)	Dagsoppgjør og kvitteringer fra kassesystem, POS og nettbutikk: /api/v1/salgsimport
Lønn, timer, reiser og utlegg	Ansatte, lønnskjøringer, timeregistrering, reiseregninger
Driftsmidler, årsoppgjør og skattemelding	Avskrivninger, årsavslutning og statusflyten fram mot innsending

Alle kall går mot selskapet til brukeren som eier tokenet. Ingen parameter kan peke på et annet selskap — ber du om noe som ikke er ditt, svarer API-et 404.

curl -H "Authorization: Bearer <token>" \
  "https://macct.no/api/rapport/saldobalanse?fra=2026-01-01&til=2026-09-30"

Kassesalg fra kassesystem, POS og nettbutikk

POST /api/v1/salgsimport/batcher tar imot dagsoppgjør eller enkeltsalg som JSON, med summer per MVA-kode og per betalingsmåte. Macct validerer og lagrer innsendingen, men bokfører ingenting: bokføringen bekreftes av en innlogget bruker under Kassesalg. Send Idempotency-Key — samme nøkkel og innhold gir samme innsending tilbake, og samme eksterne ID blir aldri bokført to ganger, verken via API eller fil. Lag tokenet med «Bare salgsimport (kassesystem)» under Innstillinger → API-tokens: da kan kassesystemet bare sende salg og lese status på egne innsendinger, ikke lese regnskapet eller gjøre noe annet.

curl -X POST -H "Authorization: Bearer <token>" -H "Idempotency-Key: z-2026-10-10-k1" \
  -H "Content-Type: application/json" https://macct.no/api/v1/salgsimport/batcher -d '{
  "kilde": "Kassesystem", "importtype": "DAGSOPPGJOR",
  "transaksjoner": [{ "eksternId": "Z-1042", "dato": "2026-10-10", "kasse": "K1",
    "mvaLinjer": [{ "mvaKode": "3", "netto": 1000.00, "mva": 250.00, "brutto": 1250.00 }],
    "betalinger": [{ "betalingsmaate": "KORT", "belop": 1000.00 }, { "betalingsmaate": "KONTANT", "belop": 250.00 }] }]
}'

MCP: la Claude jobbe i regnskapet ditt

MCP (Model Context Protocol) er en åpen standard for å gi AI-assistenter tilgang til verktøy. Macct er en MCP-server på https://macct.no/api/mcp. Kobler du Claude til den, kan du si «her er fakturaen fra Adobe — legg den inn i Macct», og Claude sender den gjennom den samme flyten som Innboks: tolking, leverandøroppslag, kontering og kontroller. Claude viser deg forslaget, og bokfører først når du sier ja — med mindre du selv slår på automatisk bokføring i innstillingene. Det samme gjelder i ChatGPT og andre MCP-klienter.

Verktøyene

Verktøy	Hva det gjør
last_opp_bilag	Sender en faktura eller kvittering inn og lager et forslag
hent_innboks, hent_forslag	Viser forslagene: konto, MVA, varsler og en forklaring på hvorfor
godkjenn_forslag, forkast_forslag	Bokfører eller forkaster — bare etter at du har bekreftet
hent_noekkeltall, hent_saldobalanse, hent_hovedbok, sok_bilag	Svarer på spørsmål om tallene dine
hent_reskontro, hent_aapne_fakturaer, hent_uavstemt_bank	Hvem skylder hva, og hva som står uavstemt i banken
hent_frister, hent_mva_termin	Frister og MVA for inneværende termin
hent_regnskapshelse	Regnskapshelsen: hvilke av de åtte sjekkene som er røde, hva som er galt, og hvor det ordnes
sok_kontoplan, foreslaa_kontering	Finner riktig konto for en utgift

Serveren tilbyr også prompten behandle_innboks. I Claude Code blir den kommandoen /mcp__macct__behandle_innboks, som går gjennom Innboks forslag for forslag og spør deg om hvert enkelt.

Koble til fra claude.ai, Claude Desktop, mobilappen eller ChatGPT — med innlogging

Dette er den enkleste veien, og den som virker i nettleseren og på mobilen. Du limer ikke inn noe token — koblingen bruker den samme innloggingen som appen (OAuth 2.1), også tofaktor-koden hvis du har slått den på under Sikkerhet — logger du inn med Google, gjelder Google-kontoens totrinnsbekreftelse i stedet.

1. I claude.ai: Innstillinger → Koblinger (Connectors) → Legg til egen kobling, og lim inn https://macct.no/api/mcp. I ChatGPT: legg til Macct som app. Claude Desktop og mobilappen bruker de samme koblingene som claude.ai.
2. Du sendes til Macct og logger inn som vanlig.
3. Macct viser en samtykkeside: hvem som spør, hvilket selskap det gjelder, og om tilgangen skal være lese eller lese og bokføre. Trykk Godta.
4. Ferdig. Spør Claude om tallene dine, eller slipp en faktura inn i samtalen.

Tilgangen gjelder nøyaktig ett selskap — er du regnskapsbyrå, velg klienten under Byrå → Klienter før du kobler til. Den vises under Innstillinger → API-tokens merket «OAuth» med klientnavnet, og kan slettes der når du vil. Da mister klienten tilgangen med en gang. Tilgangen fornyes automatisk i opptil 90 dager uten ny innlogging.

Koble til fra Claude Code — med token

Claude Code i terminalen kobler til med et API-token du lager under Innstillinger (se under):

claude mcp add --transport http macct https://macct.no/api/mcp \
  --header "Authorization: Bearer <token>"

Etter at du har laget et token, viser Innstillinger snutten med tokenet ferdig fylt inn. Andre MCP-klienter som støtter HTTP-transport med en Authorization-header, kobles til på samme måte. Claude Desktop kan også kobles slik, via broen mcp-remote — men innloggingen over er enklere.

Lag og bruk et API-token

1. Logg inn og gå til Innstillinger → Integrasjoner og rapportering → API-tokens.
2. Gi tokenet et navn, for eksempel «Claude på jobb-PC-en».
3. Kryss av for Kun lesende hvis klienten bare skal lese og svare på spørsmål.
4. Kopier tokenet med en gang — det vises bare én gang.

Tokenet sendes som Authorization: Bearer <token> på hvert kall, både mot REST-API-et og mot MCP-serveren. Det gjelder i ett år, og du kan slette det i den samme listen når du vil — da mister klienten tilgangen med en gang. Både opprettelse og sletting logges i selskapets sikkerhetslogg.

Tilgang	Hva tokenet kan
Kun lesende	Lese rapporter, innboks, reskontro og bilag. Alt som endrer noe, avvises — både over REST og i MCP.
Full	Det samme som du kan gjøre i appen med din bruker, også å registrere og slette.

Et token er knyttet til deg og ditt selskap. Behandler du ikke tokenet som et passord, kan andre bruke tilgangen din.

Begrensninger og krav

• MCP bokfører ikke uten ditt ja — med mindre du selv slår på automatisk bokføring i innstillingene. Da bokføres et bilag uten varsler med en gang, akkurat som når du laster det opp i appen eller sender det på e-post. Ellers gjelder: godkjenn_forslag krever at klienten sier at du har bekreftet, at forslaget ikke er endret siden du så det, og — hvis forslaget har et blokkerende varsel, som mulig duplikat — at du har bekreftet det spesielt. Dette sjekkes i koden, ikke bare i en instruks.
• REST med fullt token er som å bruke appen. Et skript med fullt token kan registrere bilag direkte, uten forslag og godkjenning. Skal en AI bare svare på spørsmål, gi den et lesende token.
• Innsending går via godkjenning. MCP-serveren har ingen verktøy for å sende noe til Altinn. Over REST følger skattemeldingen den samme statusflyten som i appen: utkast → klar → godkjent → sendt.
• Én tilgang, ett selskap. En kobling fra claude.ai eller ChatGPT gjelder selskapet du valgte på samtykkesiden. Vil du jobbe i et annet selskap, koble til på nytt og velg det der. Tilgangen «lese» kan aldri bokføre, uansett hva assistenten blir bedt om.
• 100 kall per minutt per IP-adresse mot /api/. Over grensen svarer API-et 429.
• Store filer: last_opp_bilag tar filen som base64 i selve kallet. Det passer skript; for filer du har på disken, er curl -F fil=@faktura.pdf https://macct.no/api/ocr/scan-faktura eller e-post-inntaket enklere. Tolkingen tar typisk 10–15 sekunder per bilag.
• Ingen webhooks ennå: vil du vite om noe nytt, spør du API-et.

Eksempler på bruk

• Bilag fra samtalen: dra en faktura inn i claude.ai og si «legg den inn i Macct». Du ser konto og MVA før noe bokføres — med mindre du selv slår på automatisk bokføring i innstillingene.
• Spørsmål om tallene: «Hvem skylder oss penger?», «Hva blir MVA-en denne terminen?», «Hva brukte vi på programvare i fjor?» — svarene kommer fra ditt eget regnskap.
• Innboks-runden: kjør /mcp__macct__behandle_innboks på fredag og gå gjennom ukens bilag ett for ett.
• Kvitteringer fra en mappe: et lite skript som sender alle PDF-ene i en mappe til /api/ocr/scan-faktura, så ligger de klare i Innboks.
• Eget dashbord: hent saldobalanse eller resultat hver måned med et lesende token og legg tallene i regnearket eller BI-verktøyet ditt.