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 werkt via de jortt API: de vaste ingang waarlangs andere software met jortt praat. Hij beschrijft die gegevens 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.

Koppelen doe je zelf, met je eigen jortt-account. Dat kan als je in de administratie de rol Beheerder of Boekhouder hebt, of als administratiekantoor. Heb je een andere rol, zoals Lid of Meekijker, dan kun je wel inloggen, maar krijgt de assistent geen toegang.

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 geldt voor de administraties en het niveau waarvoor jij toestemming gaf.

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. Achteraf pas je het per module aan bij Gebruikers.
3. Je kunt het intrekken. Bij Instellingen, onder Koppelingen; zie De koppeling verbreken. 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.

In jortt staat je assistent daarna bij Instellingen, Gebruikers, met de rol AI-agent. De naam is die van de assistent met jouw naam erachter, bijvoorbeeld Claude (J. Jansen). De beheerders van de administratie krijgen een e-mail dat er een gebruiker bij is gekomen. Zo ziet iedereen die meebeheert dat er een assistent meekijkt.

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 waar de rol medewerker voor nodig is, zoals Factuur medewerker en Financieel medewerker.

Twee grenzen gelden altijd, welk niveau je ook kiest:

• Bij de bedrijfsinstellingen komt een AI-agent nooit. Ook labels aanmaken kan een assistent niet; een label maak je zelf aan in jortt, daarna kan de assistent het wel op een boeking zetten.
• De assistent kan nooit meer dan jij. Jortt toetst elke vraag van de assistent aan zijn eigen rechten én aan die van jou, de persoon die toestemming gaf.

Per module aanpassen bij Gebruikers

Wil je de assistent wel laten boeken maar geen facturen laten maken, of andersom? Dan stel je dat per module in.

1. Ga naar Instellingen linksonder in het hoofdmenu.
2. Kies onder Bedrijfsinstellingen voor Gebruikers.
3. Klik bij Gebruikers van deze administratie op je assistent, met de rol AI-agent. Het venster Verander rol opent.
4. Kies bij Rechten per module per module wat de assistent mag, bijvoorbeeld Financieel medewerker bij Boekhouden.
5. Klik op Opslaan.

De rol zelf blijft AI-agent, en Bedrijfsinstellingen staat vast op Geen toegang. Geef je ergens schrijfrechten, dan toont jortt een waarschuwing dat de AI-agent je administratie dan zelf kan aanpassen.

Koppel je dezelfde assistent later opnieuw en kies je een ander niveau op het toestemmingsscherm, dan geldt het niveau van die laatste toestemming. Meer over rollen en rechten lees je bij gebruikers toevoegen en beheren.

Meer administraties met één koppeling

Werk je in meer administraties, bijvoorbeeld als boekhouder of als ondernemer met een holding en een werkmaatschappij, dan kan één koppeling bij al die administraties. Voorwaarde is dat je in elke administratie Beheerder of Boekhouder bent, of het administratiekantoor, en dat de administratie jortt MKB of jortt Plus heeft.

In elke administratie staat de assistent apart bij Gebruikers, met eigen rechten per module. Je kunt hem dus in de ene administratie laten boeken en in de andere alleen laten lezen. Bij elke opdracht kiest de assistent in welke administratie hij werkt. Noem daarom de bedrijfsnaam in je vraag als je er meer hebt.

De koppeling verbreken

Een AI-agent heeft bij Gebruikers geen knop Verwijder. Je verbreekt de koppeling op de plek waar ook de koppelingen met andere software staan:

1. Ga naar Instellingen linksonder in het hoofdmenu.
2. Kies onder Koppelingen voor Jortt API-koppeling en daarna API-koppeling met softwareleveranciers.
3. Klik op de naam van je assistent.
4. Klik op Toegang intrekken en bevestig.

De assistent kan daarna niets meer lezen of schrijven in deze administratie en staat niet meer bij je gebruikers. Heeft dezelfde koppeling toegang tot meer administraties, dan blijft die toegang staan tot je hem daar ook intrekt.

Gebruik je de koppeling 30 dagen niet, dan ruimt jortt hem zelf op. Wil je hem daarna weer gebruiken, dan koppel je opnieuw en geef je opnieuw toestemming.

Loopt het mis?

Werkt jortt zelf niet goed, stel je vraag dan aan Femke op de contactpagina, of mail naar support@jortt.nl. Bij het instellen van je assistent zelf kan het supportteam niet helpen; zie hieronder.

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.
• Boekingen laten maken uit een overzicht. Geef je assistent het maandoverzicht van je creditcard, laat hem eerst een voorstel tonen en daarna de boekingen maken en betaald zetten met de creditcard. Zie het uitgewerkte voorbeeld: je creditcard laten boeken.
• 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 MCP-server werkt via de jortt API. De technische documentatie van die API, met 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.