Kan de AI mijn administratie wijzigen?

Nee. De server heeft alleen tools die lezen. Hij kan niets aanmaken, wijzigen, versturen, boeken of verwijderen in e-Boekhouden. Een API token van e-Boekhouden heeft geen rechten, dus de token zelf zou ook kunnen schrijven, maar onze server heeft geen tool die dat doet.

Wat bewaren jullie van mijn e-Boekhouden-account?

Alleen je API token, versleuteld met AES-256. Facturen, relaties en saldi halen we live op als je AI erom vraagt, sturen we direct door en slaan we nooit op. We delen ze met niemand en er traint geen AI-model op. De token komt nooit in logs terecht en je AI krijgt hem nooit te zien.

Kan ik meerdere administraties koppelen?

Ja. Eén token hoort bij één administratie, dus je maakt per administratie een token en een koppeling. Elke koppeling krijgt een eigen URL, en je betaalt per koppeling.

Heeft e-Boekhouden zelf een MCP-server?

Bij onze laatste controle, in oktober 2026, bood e-Boekhouden zelf geen MCP-server aan. MCP Hosted is een onafhankelijke dienst die werkt via de openbare API van e-Boekhouden, en is niet verbonden aan e-Boekhouden.

e-Boekhouden koppelen aan ChatGPT en Claude

Q: Waarom staat mijn omzet als negatief bedrag?

In e-Boekhouden is debet positief en credit negatief. Omzet staat daardoor als negatief bedrag op de grootboekrekening, en kosten als positief bedrag. Een saldo van -1800 op een omzetrekening is dus 1.800 euro omzet.

Stap voor stap een API token maken in e-Boekhouden, de MCP-URL toevoegen aan Claude, ChatGPT of Cursor, en wat je daarna kunt vragen.

Door Willem-Jaap KlepperGepubliceerd op 28 oktober 2026

Wil je ChatGPT of Claude vragen wie je nog moet betalen, wat je een klant dit jaar hebt gefactureerd of wat je omzet was in het laatste kwartaal? Dan moet je AI-assistent bij je e-Boekhouden-administratie kunnen. Dat doe je met een MCP-server: een koppeling die je AI-assistent vertelt welke gegevens hij mag ophalen en hoe. In deze handleiding lees je hoe je e-Boekhouden in een paar minuten koppelt aan Claude, ChatGPT of Cursor, wat de AI daarna wel en niet kan, en waar je op let.

Wat is MCP, en wat heb je eraan?

MCP (Model Context Protocol) is de open standaard waarmee AI-assistenten met andere software praten. e-Boekhouden heeft een API, maar ChatGPT en Claude kunnen daar niet zelf mee werken. Een MCP-server zit ertussen: je AI-assistent vraagt bijvoorbeeld om de openstaande facturen, de server haalt ze live op bij e-Boekhouden en geeft het antwoord terug.

MCP Hosted draait die server voor je. Je hoeft niets te installeren en geen code te schrijven. Je maakt een API token in e-Boekhouden, plakt die in je dashboard en voegt één URL toe aan je AI-assistent.

Wat heb je nodig?

Een e-Boekhouden-account waarin je API tokens mag maken.
Een account bij MCP Hosted met een abonnement voor e-Boekhouden. Je betaalt per koppeling; de bedragen staan op de pagina Prijzen.
Een AI-assistent die remote MCP-servers ondersteunt, zoals Claude, ChatGPT of Cursor.

Stap 1: maak een API token in e-Boekhouden

Open in e-Boekhouden Beheer en ga onder Inrichting naar Koppelingen.
Open API en kies e-Boekhouden API. Kies niet de rij API/SOAP (oud) ernaast: dat is de oude koppeling, en die werkt niet met deze server. Klik op Verder.
Klik op Toevoegen en geef de token een naam die je later herkent, zoals MCP Hosted. Laat Einddatum leeg: een token met een einddatum stopt op die dag.
Kopieer de token met Kopieer en klik daarna pas op Opslaan. e-Boekhouden laat de token maar één keer zien.

Eén token hoort bij één administratie. Heb je meerdere administraties, dan maak je per administratie een token en een aparte koppeling. Elke koppeling krijgt een eigen URL, zodat je ze naast elkaar in één AI-assistent kunt gebruiken.

Een API token van e-Boekhouden heeft geen rechten of scopes. Je kunt hem dus niet beperken tot alleen lezen: met de token zelf zou je ook dingen kunnen wijzigen. Onze server heeft alleen tools die lezen. Er is geen tool die iets aanmaakt, wijzigt, verstuurt, boekt of verwijdert.

Stap 2: koppel de token in MCP Hosted

Log in bij MCP Hosted, open e-Boekhouden en plak de token. Geef de koppeling een naam, bijvoorbeeld de naam van je administratie. We controleren de token direct bij e-Boekhouden: klopt hij niet, dan zie je dat meteen en wordt er niets opgeslagen.

Daarna zie je de MCP-URL van de koppeling, zoals https://mcphosted.com/mcp/e-boekhouden/12. Die URL voeg je toe aan je AI-assistent. Een URL zonder nummer aan het eind leidt naar je eerste e-Boekhouden-koppeling.

Achter de schermen ruilen we je token bij e-Boekhouden in voor een sessie van een uur. Die sessie bewaren we versleuteld en verlengen we vanzelf. Weigert e-Boekhouden de token, dan proberen we het niet opnieuw: e-Boekhouden blokkeert een token na mislukte inlogpogingen.

Stap 3: voeg de URL toe aan je AI-assistent

De menu's van AI-assistenten veranderen vaak. Hieronder staat de route op hoofdlijnen. Zoek in je assistent naar connectors, integraties of MCP-servers als een naam net anders is.

Claude

Open de instellingen van Claude en zoek het onderdeel voor connectors. Kies daar voor een eigen connector toevoegen, plak de MCP-URL en bevestig. Claude opent dan een inlogscherm van MCP Hosted. Log in en keur de toegang goed. Daarna kun je in een gesprek de e-Boekhouden-connector aanzetten.

ChatGPT

ChatGPT ondersteunt remote MCP-servers via connectors. Of je een eigen connector mag toevoegen, hangt af van je abonnement en soms van de instellingen van je werkruimte. Zoek in de instellingen naar connectors of apps, maak een nieuwe connector aan met de MCP-URL en log in bij MCP Hosted als ChatGPT daarom vraagt.

Cursor

Open in Cursor de instellingen voor MCP en voeg een nieuwe server toe met de MCP-URL. Cursor opent je browser om in te loggen bij MCP Hosted. Daarna staan de e-Boekhouden-tools in de lijst van je agent.

Elke AI-assistent krijgt een eigen login. Onder Settings, AI clients in je dashboard zie je welke assistenten toegang hebben, en zet je er een met één klik uit.

Wat kun je vragen?

Stel je vraag gewoon in gewone taal. Een paar voorbeelden:

Welke klanten moeten ons nog betalen, en hoeveel staat er per klant open?
Welke leveranciersfacturen moeten we deze maand nog betalen?
Wat hebben we dit jaar aan Bakkerij De Vries gefactureerd?
Wat was onze omzet in het derde kwartaal, en wat waren de kosten?
Zoek de boeking bij factuur 2026-0142 en laat de btw zien.

De AI kiest zelf welke tools hij nodig heeft. Deze tools zijn er:

list_relations: zoek klanten en leveranciers op naam, code, e-mailadres of plaats.
get_relation: bekijk een klant of leverancier volledig: adres, btw-nummer, IBAN en betalingstermijn.
list_invoices: bekijk je verkoopfacturen op nummer, klant of datum, met hun totalen.
get_invoice: bekijk een volledige factuur, inclusief alle factuurregels.
list_outstanding_invoices: zie welke klanten je nog moeten betalen, en welke leveranciers jij nog moet betalen.
list_mutations: zoek boekingen op soort, datum, factuurnummer of omschrijving.
get_mutation: bekijk een boeking met de regels en de btw.
list_ledgers: bekijk je grootboekrekeningen met hun nummer en categorie.
get_ledger_balances: lees het saldo van elke grootboekrekening op een dag of over een periode, voor omzet, kosten en winst.
list_cost_centers: bekijk je kostenplaatsen.
list_products: bekijk je producten en bijbehorende prijzen.

Let op bij saldi: in e-Boekhouden is debet positief en credit negatief. Omzet staat daardoor als negatief bedrag op de grootboekrekening, en kosten als positief bedrag. Een saldo van -1800 op een omzetrekening betekent dus 1.800 euro omzet. De server vertelt je AI-assistent dat, maar zie je een omzet met een minteken, dan weet je waar het vandaan komt.

list_invoices toont alleen facturen die je met de factuurmodule van e-Boekhouden hebt gemaakt. Facturen die je op een andere manier hebt geboekt, vind je terug als boeking en, zolang ze niet betaald zijn, bij de openstaande posten.

Je key en je data

Je geeft ons de sleutel tot je boekhouding, dus dit is wat we ermee doen:

Je token: we versleutelen hem met AES-256 voordat we hem opslaan. Je AI ziet hem nooit, en met Ontkoppelen verwijder je hem direct.
Je data: elk antwoord halen we live op uit e-Boekhouden en sturen we direct door naar je AI-assistent. We bewaren geen kopie, delen het met niemand en geen enkel AI-model traint erop.
Zelf draaien: draai de server op je eigen computer, dan komen je API token en je data nooit langs onze servers.

Op de beveiligingspagina lees je hoe we dat precies doen, en welke bedrijven ons helpen de dienst te draaien.

Liever op je eigen computer?

De e-Boekhouden-server draait ook op je eigen computer, met één npx-commando en een eenmalige licentie. Je zet de token in de omgevingsvariabele EBOEKHOUDEN_API_KEY en je licentiesleutel in MCPHOSTED_LICENSE_KEY, en start de server met:

npx -y mcphosted e-boekhouden

Op de instellingenpagina van e-Boekhouden in je dashboard staan de stappen en de volledige configuratie voor je AI-assistent. Bij het starten controleert de server je licentie eenmalig bij onze betaalprovider. Je token en je data komen nooit langs onze servers.

Als het niet werkt

e-Boekhouden zegt Login failed: de token klopt niet of is verwijderd. Maak een nieuwe token onder e-Boekhouden API, niet onder API/SOAP (oud), en vervang de oude op de instellingenpagina. Blijf de oude niet proberen: e-Boekhouden blokkeert een token na mislukte inlogpogingen.
e-Boekhouden zegt Access token has expired (API_SESSION_004): de token is voorbij zijn einddatum. Maak een nieuwe token, laat Einddatum leeg en vervang de oude.
De tools verschijnen niet in je assistent: controleer of je de connector in het gesprek hebt aangezet en of je bent ingelogd bij MCP Hosted.

Meer fouten en oplossingen staan op de pagina Problemen oplossen. Wil je meer weten over wat de koppeling kan, kijk dan op de pagina over de e-Boekhouden MCP-server.