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.

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"

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.

Verktøyene

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

Claude Code (terminal):

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

Claude Desktop — via broen mcp-remote i claude_desktop_config.json (krever Node.js):

{ "mcpServers": { "macct": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://macct.no/api/mcp",
             "--header", "Authorization: Bearer <token>"] } } }

Etter at du har laget et token, viser Innstillinger begge snuttene med tokenet ferdig fylt inn. Andre MCP-klienter som støtter HTTP-transport med en Authorization-header, kobles til på samme måte.

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.

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.
• 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 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.