Koppla Kontiq till ChatGPT

Läs det här först

Kontiq autentiserar med en fast token i headern Authorization: Bearer …. ChatGPT har länge bara stött OAuth eller ingen autentisering för egna kopplingar, och OpenAI ändrar den här delen ofta. Hittar du inget fält för en token eller API-nyckel i din version av ChatGPT går kopplingen inte att göra där – då använder du ChatGPT-appen på datorn, eller Claude, som stöder bearer-token rakt av.

Steg 1 av 3

Skapa en MCP-token i Kontiq

Samma första steg oavsett vilken väg du sedan väljer.

1

Öppna Administration → MCP-åtkomst

Logga in i Kontiq som administratör, välj rätt bolag och klicka på MCP-åtkomst i vänstermenyn under ADMINISTRATION.

2

Välj behörighet och omfattning

Ge tokenet ett namn du känner igen ("ChatGPT"). Behåll read om ChatGPT bara ska läsa och svara på frågor; kryssa i draft om den också ska få förbereda konteringar. Lås gärna tokenet till ett enda bolag, och sätt giltigheten till 90 dagar till att börja med.

3

Kopiera token direkt

Den visas en enda gång. Kontiq lagrar bara en SHA-256-hash, så den kan inte tas fram igen – men du kan alltid återkalla den och skapa en ny.

Steg 2 av 3

Välj väg in i ChatGPT

A. ChatGPT-appen på datorn

Har stöd för MCP-servrar med bearer-token. Den väg som passar Kontiqs autentisering bäst.

Rekommenderas

B. ChatGPT på webben

Kräver utvecklarläge och en egen connector. Fungerar bara om din version erbjuder ett autentiseringsval som skickar en fast token.

Beror på version

Väg A

ChatGPT-appen på datorn

1

Öppna Inställningar → MCP-servrar

Menyn heter MCP servers i den engelska versionen. Klicka på Lägg till server.

2

Välj typen Streamable HTTP

Du får välja mellan en lokal process (STDIO) och en adress över HTTP. Kontiq är en HTTP-endpoint, så välj Streamable HTTP – inte STDIO.

3

Fyll i adress och token

Namn: kontiq. Adress och autentisering enligt tabellen nedan.

Fält	Värde
Namn	`kontiq`
Typ / transport	Streamable HTTP
URL	`https://kontiq.se/api/mcp.php`
Autentisering	Bearer token – klistra in tokenet från Kontiq. Ber fältet om en hel header skriver du `Authorization: Bearer din-token`

4

Spara och starta om

Spara servern och välj Starta om när appen ber om det. Verktygen blir tillgängliga först efter omstarten.

Väg B

ChatGPT på webben – utvecklarläge

1

Slå på utvecklarläget

Öppna Inställningar i ChatGPT på webben och leta upp utvecklarläget – det ligger under appar och kopplingar respektive säkerhet, beroende på version. Läget finns för Plus, Pro, Business, Enterprise och Edu, inte i gratisversionen.

2

Skapa en egen koppling

Välj att lägga till en ny app eller connector. Du får fylla i ett namn, en beskrivning och serverns adress.

Fält	Värde
Namn	`Kontiq`
Beskrivning	"Min bokföring i Kontiq – verifikat, rapporter och momsunderlag." Modellen läser beskrivningen när den avgör om kopplingen ska användas, så var konkret.
MCP-serverns URL	`https://kontiq.se/api/mcp.php`
Autentisering	Välj alternativet för åtkomsttoken eller API-nyckel och klistra in tokenet från Kontiq. Finns bara OAuth och "ingen autentisering" i din version går kopplingen inte att göra – se rutan högst upp.

3

Spara och aktivera i chatten

Kopplingen hamnar bland dina appar. I ett nytt samtal aktiverar du den innan du frågar något – i utvecklarläget blir alla verktyg som servern exponerar tillgängliga, inte bara sök och hämta.

Steg 3 av 3

Verifiera att kopplingen lever

Ställ den här frågan:

Vilka bolag når du i Kontiq?

ChatGPT anropar list_companies och svarar med ditt bolag. Du kan också kontrollera från Kontiq-sidan: under MCP-åtkomst fylls kolumnen Senast använd i så snart tokenet använts.

Vill du testa utan att gå via ChatGPT alls fungerar det här kommandot i en terminal:

curl -s https://kontiq.se/api/mcp.php \
  -H "Authorization: Bearer din-token-här" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Får du tillbaka en lista med verktyg är servern och tokenet i sin ordning, och felet ligger i klientens inställningar.

Felsökning

Om något inte fungerar

Symtom	Vad du gör
ChatGPT säger att servern inte svarar	Kontrollera att adressen är komplett, inklusive `/api/mcp.php`, och att den börjar med `https://`. ChatGPT når aldrig localhost, och Kontiq avvisar okrypterad HTTP.
401 / "Saknar Authorization: Bearer"	Tokenet kommer inte fram. Testa curl-kommandot ovan: fungerar det där ligger felet i ChatGPT:s autentiseringsval. Fungerar det inte heller där kan webbservern strippa headern – öppna `https://kontiq.se/api/mcp.php?diag=headers`, som visar vilka källor som fanns utan att någonsin visa något värde.
"Ogiltig token"	Återkallad, utgången eller ofullständigt kopierad. Kontrollera raden i MCP-åtkomst och skapa ett nytt token vid behov.
Klienten kräver en SSE-adress	Kontiq svarar på begäran och svar över POST, inte serverinitierad SSE. Välj alternativet Streamable HTTP. En `GET` mot endpointen svarar med `405` – det är enligt specifikationen och inget fel.
ChatGPT använder inte kopplingen trots att den finns	Aktivera den i det aktuella samtalet, och skriv gärna "slå upp i Kontiq" i frågan. En tydlig beskrivning på kopplingen hjälper modellen att välja den.

Efter kopplingen

Vad du kan fråga om

Vad blev resultatet i tredje kvartalet jämfört med i fjol?

Hur mycket moms ska jag redovisa för november?

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

Vilka bokförda verifikat saknar underlag i år?

Stäm av oktober och peka ut konton som sticker ut.

Verifikat 87 blev fel – förbered en rättelse.

De två sista leder till ett utkast i Kontiq, aldrig till en bokförd post. Inget MCP-verktyg kan bokföra, ändra eller radera – och varje anrop hamnar i revisionsloggen med prefixet mcp.

Vanliga frågor

Frågor och svar

Vilken ChatGPT-version behöver jag?

Egna MCP-kopplingar är inte en funktion i gratisversionen. På webben ligger de bakom utvecklarläget, som OpenAI anger som tillgängligt för Plus, Pro, Business, Enterprise och Edu. I ChatGPT-appen för dator ligger MCP-servrar under inställningarna. Vilka val du ser beror på din version – OpenAI ändrar den här delen ofta.

Varför kan jag inte klistra in min Kontiq-token?

ChatGPT har historiskt bara erbjudit OAuth eller ingen autentisering för egna connectors, och Kontiq använder en fast bearer-token. Nyare versioner har ett val i stil med "Access token / API key" som skickar Authorization: Bearer på varje anrop – det är det du ska välja. Saknas det valet i din version går kopplingen inte att göra på webben; använd ChatGPT-appen för datorn i stället.

Kan jag välja "ingen autentisering" för att komma runt det?

Nej, och det skulle inte fungera. Kontiqs MCP-endpoint kräver en giltig token och svarar 401 på allt annat. Din bokföring ligger alltså inte öppen ens om en klient ansluter utan token – men kopplingen blir heller inte användbar.

Vad kan ChatGPT göra med min bokföring?

Exakt samma som vilken annan MCP-klient som helst: läsa rapporter, verifikat, huvudbok och momsunderlag, och – om token har behörigheten draft – förbereda ett verifikatutkast som du själv granskar och bokför. Det finns inget verktyg som bokför, ändrar eller raderar.

Måste jag ha en publik adress?

Ja. ChatGPT på webben når bara servrar på publik HTTPS-adress, aldrig localhost. Kontiq körs på en publik adress med HTTPS, så det är uppfyllt. Kontiqs endpoint avvisar dessutom anrop över okrypterad HTTP.