Koppla Kontiq till ChatGPT och Claude (MCP)

Bakgrund

Vad MCP är – och varför det spelar roll för bokföring

En AI-chatt vet ingenting om ditt företag. Frågar du "hur mycket moms ska jag betala i november?" kan den bara svara allmänt om momsregler. MCP (Model Context Protocol) är ett öppet protokoll som låter chatten hämta riktiga uppgifter ur ett system – i det här fallet din egen bokföring i Kontiq.

Kontiqs MCP-server körs på samma server som resten av Kontiq. Du skapar en token inne i Kontiq, klistrar in den i din AI-klient, och därefter kan klienten slå upp kontoplan, verifikat, resultat- och balansräkning, huvudbok och momsunderlag – och föreslå konteringar som du granskar.

Det här kan en kopplad AI göra

Läsa rapporter, verifikat, huvudbok och momsunderlag
Hitta bokförda verifikat som saknar underlag
Kontrollera att en tänkt kontering balanserar
Skapa ett utkast som väntar på ditt godkännande
Bifoga ett underlag, eller ge dig en uppladdningslänk

Det här kan den aldrig göra

Bokföra ett verifikat
Ändra eller radera något som redan är bokfört
Ta bort en befintlig bilaga
Nå ett bolag som din token inte har behörighet till
Skicka något till Skatteverket eller Bolagsverket

Det är ett medvetet designval. Ansvaret för att bokföringen är riktig ligger enligt bokföringslagen alltid på företaget, och därför finns det helt enkelt inget verktyg som sätter status "bokförd".

Översikt

Tre steg, oavsett vilken AI du använder

1

Skapa en token i Kontiq

Logga in och gå till Administration → MCP-åtkomst. Välj behörighet, eventuell bolagslåsning och giltighetstid. Token visas exakt en gång – kopiera den direkt.

2

Peka din AI-klient mot Kontiqs endpoint

Adressen är https://kontiq.se/api/mcp.php och autentiseringen sker med Authorization: Bearer <din token>. Hur du fyller i det skiljer sig mellan klienterna – följ guiden för Claude eller ChatGPT.

3

Fråga om din bokföring

Börja med "vilka bolag når du i Kontiq?". Klienten anropar list_companies och du ser direkt att kopplingen lever. Därefter kan du fråga precis vad du vill om siffrorna.

Teknisk sammanfattning

Anslutningsuppgifter

Endpoint:   https://kontiq.se/api/mcp.php
Transport:  Streamable HTTP (JSON-RPC 2.0 över POST)
Auth:       Authorization: Bearer <token>
Krav:       HTTPS. Anrop över vanlig HTTP avvisas.

Servern implementerar begäran/svar, inte serverinitierad SSE – en GET mot endpointen svarar med 405 och Allow: POST, OPTIONS. Det är enligt specifikationen, och klienter som stöder Streamable HTTP hanterar det.

Vad AI:n kommer åt

Verktygen i Kontiqs MCP-server

Läsande – kräver behörigheten `read`

Verktyg	Svarar på
`list_companies`	Vilka bolag token når. AI:n börjar alltid här
`get_chart_of_accounts`	Kontoplanen, sökbar på nummer och namn
`list_fiscal_periods`	Perioder med start, slut och låsstatus
`get_trial_balance`	Saldobalans per konto
`get_income_statement`	Resultaträkning, med valfri jämförelseperiod
`get_balance_sheet`	Balansräkning per balansdag
`search_verifications`	Sök på datum, belopp, konto, serie, status eller fritext
`get_verification`	Ett verifikat med rader och bilagor
`get_account_ledger`	Huvudbok med ingående balans och löpande saldo
`get_vat_report`	Momsunderlag: saldon på 26-kontona, in- och utgående moms, netto
`find_missing_attachments`	Bokförda verifikat utan underlag

Förberedande – kräver `draft` och rollen accountant eller högre

Verktyg	Beteende
`validate_verification`	Kontrollerar balans, konton, momskod och periodlås utan att spara. Kräver bara `read`
`draft_verification`	Skapar ett utkast som väntar på ditt godkännande
`attach_document`	Bifogar ett underlag till ett verifikat – utkast såväl som bokfört
`create_upload_link`	Ger dig en engångslänk där du själv släpper filen
`create_correction`	Skapar en rättelseverifikation som utkast

Rapportverktygen räknar bara på bokförda verifikat – utkast och makulerade poster ingår aldrig. Utöver verktygen finns resurserna kontiq://vat-codes (alla momskoder med sats och konton) och kontiq://conventions (hur status, serier och perioder fungerar), samt de färdiga promptarna manadsavstamning, momsdeklaration och bokslutskontroll.

Säkerhet

Vad en token faktiskt ger, och hur du tar tillbaka den

Kontroll	Innebörd
Behörighet `read`	Läsa rapporter, verifikat och kontoplan. Inget annat
Behörighet `draft`	Skapa verifikatutkast. Kräver rollen accountant eller högre i bolaget
Bolagslåsning	Token kan låsas till ett enda bolag – gäller även för superadmin
Giltighet	90 dagar, 1 år eller tills vidare
Lagring	Bara en SHA-256-hash sparas. Klartexten visas en gång och kan aldrig visas igen
Återkallande	Ett klick i listan under MCP-åtkomst. Tokenet slutar fungera omedelbart
Spårbarhet	Varje anrop loggas i revisionsloggen med prefixet `mcp.` – MCP-åtgärder går att skilja från vanliga UI-åtgärder
Idempotens	Skrivande verktyg kräver en nyckel; ett omförsök skapar aldrig en dubblett

Behandla token som ett lösenord. Den ger läsåtkomst till din bokföring för den som har den. Tappar du bort den – eller byter dator – återkallar du den och skapar en ny.

Så används det

Frågor som fungerar direkt

Vad blev resultatet förra kvartalet jämfört med samma kvartal i fjol?

Hur mycket utgående och ingående moms har jag i oktober?

Vilka bokförda verifikat saknar underlag i år?

Visa huvudboken för konto 1930 i november och förklara de fem största posterna.

Jag köpte en dator för 18 400 kr inkl. moms med företagskortet – hur ska den bokföras?

Verifikat 214 blev fel konterat. Förbered en rättelse.

De två sista leder till ett utkast i Kontiq. Du öppnar det, kontrollerar konton och belopp, och bokför det själv – eller slänger det.

Vanliga frågor

Frågor och svar om MCP-kopplingen

Vad är MCP?

MCP (Model Context Protocol) är ett öppet protokoll för hur en AI-klient hämtar data från ett annat system. Kontiq kör en MCP-server på sin egen webbserver. När du kopplat din AI-klient till den kan du ställa frågor i vanlig text – "vad blev momsen i Q3?" – och klienten hämtar svaret direkt ur din bokföring i stället för att gissa.

Kan AI:n bokföra något åt mig?

Nej. Det finns inget verktyg i Kontiqs MCP-server som bokför, ändrar eller raderar. Det starkaste en kopplad AI kan göra är att skapa ett utkast som du själv granskar och bokför i Kontiq. Utkastet får inget verifikationsnummer förrän en människa godkänner det, eftersom verifikationsserien inte får ha luckor.

Vilka AI-klienter fungerar?

Claude Desktop och Claude Code fungerar direkt – de kan skicka den Authorization-header som Kontiq kräver. ChatGPT-appen för dator kan lägga till MCP-servrar med bearer-token. ChatGPT på webben kräver att du väljer ett autentiseringsläge som skickar en fast token; kan din version bara välja OAuth eller "ingen autentisering" går kopplingen inte att göra säkert.

Vad kostar det?

Ingenting utöver abonnemanget på 99 kr/mån exkl. moms. MCP-åtkomsten ingår. Du betalar din AI-leverantör för ditt Claude- eller ChatGPT-abonnemang, men frågorna går inte via Kontiqs AI-funktion och debiteras därför inte som AI-frågor (90 öre/st).

Hur säkert är det?

Åtkomsten styrs av en token som du skapar själv och kan återkalla när som helst. Token ärver dina behörigheter, kan låsas till ett enda bolag, kan begränsas till bara läsning och kan ges en utgångstid. Av token sparas bara en SHA-256-hash. Varje anrop skrivs till revisionsloggen med prefixet mcp., så du kan i efterhand se exakt vad den kopplade AI:n hämtade.

Behöver jag vara administratör?

Ja. MCP-tokens skapas under Administration → MCP-åtkomst, och den menyn kräver administratörsbehörighet i bolaget. Behörigheten draft, som låter AI:n skapa utkast, kräver dessutom rollen accountant eller högre.

Koppla Kontiq till ChatGPT och Claude