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

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

Zo verbind je je assistent

Je voegt de server toe aan de instellingen van je AI-assistent. De meeste programma’s gebruiken een variant van deze configuratie:

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

De server gebruikt dezelfde OAuth 2.0-autorisatie als de jortt API. Je assistent vraagt je daarom bij het eerste gebruik om in te loggen bij jortt. Op dat toestemmingsscherm kies je meteen het toegangsniveau.

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.

Wil je de rechten later aanpassen of intrekken, ga dan in jortt naar Instellingen en klik op Gebruikers.

Waarvoor je het gebruikt

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.
Let op
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.

Veelgestelde vragen over de MCP-koppeling

Heb je een vraag? Wij hebben de antwoorden!

Ja. Jortt heeft een eigen MCP-server waarmee je je administratie aan een AI-assistent koppelt, bijvoorbeeld ChatGPT, Claude of Cursor. Het adres is https://mcp.jortt.nl/mcp. De volledige technische documentatie staat op developer.jortt.nl.

De MCP-koppeling zit vanaf jortt MKB, dus ook in jortt Plus. In jortt Starter en jortt ZZP zit geen MCP-koppeling, net zoals daar ook geen API-koppeling in zit.

De server staat op https://mcp.jortt.nl/mcp. Je vult dat adres in bij de instellingen van je AI-assistent; je hoeft er in jortt zelf niets voor aan te zetten. De eerste keer dat je hem gebruikt, vraagt je assistent je om in te loggen bij jortt.

Bij het koppelen kies je zelf tussen Alleen lezen en Lezen en schrijven. Met Alleen lezen kan de assistent je hele administratie bekijken maar niets veranderen. Met Lezen en schrijven kan hij ook facturen aanmaken, uitgaven boeken en de andere wijzigingen doen die de jortt API ondersteunt.

Dat doe je in jortt bij Instellingen, Gebruikers. Daar pas je de rechten van de koppeling achteraf aan of trek je ze weer in.

De koppeling werkt met dezelfde OAuth 2.0-autorisatie als de jortt API, dus je logt zelf in en geeft zelf toestemming. Kies Alleen lezen als je de assistent alleen vragen wilt stellen. Bij Lezen en schrijven kan een assistent in korte tijd veel gegevens aanpassen, dus probeer zo'n koppeling eerst uit op een beperkt deel van je administratie.