De jortt MCP-koppeling voor AI-assistenten

Het Model Context Protocol (MCP) is een open standaard om AI-assistenten te verbinden met de systemen waar je gegevens staan. Jortt heeft een eigen MCP-server. Daarmee kan een assistent zoals ChatGPT, Claude of elke andere AI-tool rechtstreeks bij je klanten, facturen, offertes, uitgaven, categorieën en rapporten, zonder dat je die eerst zelf exporteert.

De MCP-server ontsluit dezelfde gegevens als de jortt API, maar dan beschreven op een manier die een AI-assistent kan lezen. Je hoeft er dus geen koppeling voor te bouwen.

Kan ik mijn boekhouding koppelen aan ChatGPT of Claude?

Ja. Je koppelt je administratie aan ChatGPT, aan Claude of aan elke andere AI-assistent die MCP ondersteunt, via de MCP-server van jortt op https://mcp.jortt.nl/mcp. Je hoeft daarvoor niets te bouwen en geen API key aan te vragen: je zet de server één keer in je assistent en geeft via OAuth toegang.

Daarna kun je in gewone taal vragen stellen over je eigen cijfers. Bijvoorbeeld: welke facturen staan er nog open, hoeveel omzet had ik vorig kwartaal, of welke uitgaven staan nog zonder categorie. De assistent leest die gegevens rechtstreeks uit je administratie, dus je hoeft niets te exporteren en niets te kopiëren.

Je bepaalt zelf hoeveel de assistent mag. Geef je alleen leesrechten, dan kan hij kijken en niets wijzigen. Hoe je dat instelt staat onder Kies je toegangsniveau.

Vanaf welk abonnement

De MCP-koppeling is beschikbaar vanaf jortt MKB, dus ook met jortt Plus. In jortt Starter en jortt ZZP zit geen MCP-koppeling. Dat is dezelfde grens als bij de API-koppeling. Wil je upgraden, dan lees je hier hoe dat werkt: Je account upgraden.

Waar de server staat

Het adres van de MCP-server is:

https://mcp.jortt.nl/mcp

Je hebt geen API key nodig

Dit is de vraag die we het vaakst krijgen, dus hij staat hier bovenaan: er is geen API key voor de MCP-koppeling. Je hoeft er niets aan te vragen en niets te kopiëren.

De hele configuratie bestaat uit een naam en een adres. Vraagt je assistent om een API key, een token, een secret of een Authorization-header, laat dat veld dan leeg.

Waarom die vraag zo vaak komt, snappen we. Twee dingen wijzen de verkeerde kant op:

• De jortt API werkt wél met sleutels. Bouw je zelf een koppeling tegen api.jortt.nl, dan vraag je een client ID en een client secret aan. Voor MCP is dat niet nodig. Dat is het verschil tussen de twee koppelingen.
• Voorbeeldconfiguraties op internet staan vol met een Authorization-header. Dat komt doordat veel MCP-servers geen OAuth ondersteunen en dan een sleutel nodig hebben. De jortt MCP-server ondersteunt OAuth wel.

Wat OAuth is, in gewone taal

OAuth is de standaard achter knoppen als “inloggen met Google”. Je geeft geen wachtwoord en geen sleutel af. In plaats daarvan log je zelf in bij jortt, en op een toestemmingsscherm geef je aan wat het andere programma mag. Jortt geeft dat programma daarna een eigen toegangsbewijs, dat alleen voor jouw administratie geldt en alleen voor het niveau dat je koos.

Het verschil met een sleutel, in één beeld:

• Een API key is een sleutel van je voordeur. Wie hem heeft komt binnen, alles staat open, en dat blijft zo tot je het slot verandert. Raakt zo’n sleutel zwerven, dan merk je dat niet.
• OAuth is een bezoekerspas. Je meldt je zelf bij de balie, je zegt waar de bezoeker mag komen, de pas staat op naam, en je blokkeert hem wanneer je wilt.

Concreet betekent dat drie dingen:

1. Je assistent ziet je wachtwoord nooit. Je typt het in op een pagina van jortt, niet in je assistent.
2. Jij bepaalt het niveau. Op het toestemmingsscherm kies je Alleen lezen of Lezen en schrijven.
3. Je kunt het intrekken. In jortt bij Instellingen en dan Gebruikers. Daarna werkt de koppeling niet meer, zonder dat je een wachtwoord hoeft te veranderen.

Zo verbind je je assistent, stap voor stap

De namen van de menu’s verschillen per programma, de stappen zijn overal hetzelfde.

1. Zoek in je assistent de instellingen voor MCP-servers of connectors.
2. Voeg een server toe. Als naam vul je jortt in.
3. Vul als adres in: https://mcp.jortt.nl/mcp. Let op het tweede deel /mcp, dat hoort erbij.
4. Laat elk veld voor een API key, token of header leeg. Zie hierboven.
5. Klik op verbinden. Je assistent stuurt je door naar jortt, waar je inlogt met je eigen jortt-account.
6. Op het toestemmingsscherm kies je Alleen lezen of Lezen en schrijven, en bevestig je.

Klaar. In jortt hoef je niets aan te zetten en niets voor te bereiden.

Werk je met een programma waarin je de configuratie als tekst invult, dan ziet die er zo uit. Meer dan dit is het niet:

{
  "mcpServers": {
    "jortt": {
      "url": "https://mcp.jortt.nl/mcp"
    }
  }
}

Kies je toegangsniveau

Bij het koppelen kies je tussen twee niveaus:

• Alleen lezen. De assistent mag je hele administratie bekijken, maar verandert er niets aan. Dit is de veilige keuze als je alleen antwoorden wilt.
• Lezen en schrijven. De assistent mag daarnaast facturen aanmaken, uitgaven boeken en de overige wijzigingen doen die de jortt API ondersteunt.

Loopt het mis?

Waarvoor je het gebruikt

Wil je eerst zien wat je ermee kunt, kijk dan bij je AI-assistent op je boekhouding. Deze pagina gaat over het instellen.

Een paar dingen die klanten met de koppeling doen:

• Vragen stellen over je boekhouding. “Welke facturen staan langer dan 30 dagen open, en voor hoeveel?” of “Wat gaf ik vorig kwartaal per categorie uit?” De assistent haalt de cijfers uit je administratie in plaats van dat je ze eerst exporteert.
• Werken met echte cijfers. Een betalingsherinnering opstellen op basis van de daadwerkelijk openstaande facturen van een klant, of een btw-aangifte naast de geboekte uitgaven leggen, zonder bedragen tussen schermen over te typen.
• Losse vragen zonder koppeling te bouwen. Voor rapportages en eenmalige vragen is een eigen koppeling tegen api.jortt.nl vaak meer werk dan het antwoord waard is.

Een MCP-koppeling is krachtig: een assistent kan geautomatiseerd en in grote aantallen gegevens aanmaken, wijzigen en verwijderen, en zet daarbij veel stappen achter elkaar zonder dat je meekijkt. Probeer een koppeling daarom eerst uit op een beperkt deel van je administratie en controleer het resultaat. Je gebruikt de koppeling op eigen risico; jortt geeft geen ondersteuning op de technische integratie. Zie artikel 14 van de algemene voorwaarden.

Meer lezen

De volledige technische documentatie, inclusief de beschikbare scopes en alle endpoints, staat op developer.jortt.nl. Wil je liever een gewone koppeling in plaats van een AI-assistent, kijk dan bij De jortt API en koppelingen bouwen of bij Koppelingen met jortt.