Mijn Boekhoudapp

Integraties

REST API en MCP-server

Koppel Mijn Boekhoudapp aan je eigen software via de REST API, of laat een AI-assistent zoals Claude of ChatGPT met je administratie werken via de MCP-server. Beide gebruiken dezelfde gegevens als de app en werken alleen met jouw account.

REST API

Lees en beheer klanten, facturen, offertes, producten, uitgaven, projecten, uren en betalingen via JSON. Je maakt een API-sleutel aan via het gebruikersmenu, onder API-sleutels, en kiest per sleutel de rechten: lezen, schrijven, verwijderen, facturen versturen, PDF downloaden, offertes omzetten en betalingen registreren.

Basis-URL: https://mijn-boekhoudapp.nl/api/v1

MCP-server

Het Model Context Protocol (MCP) laat een AI-assistent veilig acties uitvoeren in je administratie: een klant aanmaken, een factuur opstellen, uren registreren of je openstaande facturen opzoeken.

Server-URL: https://mijn-boekhoudapp.nl/mcp/bookkeeping

Wat heb je nodig?

  • Een account met een actief abonnement of credits.
  • Voor MCP: zet MCP aan op de pagina API-sleutels in het gebruikersmenu. Daar kies je ook welke tools een AI-assistent mag gebruiken.

Zo werkt inloggen (OAuth)

  1. Je voegt de server-URL toe in je AI-assistent.
  2. De assistent meldt zich automatisch aan als OAuth-client en stuurt je naar de inlogpagina van Mijn Boekhoudapp.
  3. Je logt in en geeft toestemming. Je wachtwoord deel je nooit met de assistent.
  4. De assistent krijgt een toegangstoken en kan daarna de tools gebruiken die je hebt aangezet.

Koppelen met Claude

  1. Open in Claude de instellingen en kies Connectors.
  2. Kies voor een eigen connector toevoegen en plak de server-URL.
  3. Log in bij Mijn Boekhoudapp en geef toestemming.

In Claude Code kan het ook vanaf de opdrachtregel:

claude mcp add --transport http boekhoudapp https://mijn-boekhoudapp.nl/mcp/bookkeeping

Koppelen met ChatGPT

  1. Zet in ChatGPT de ontwikkelaarsmodus aan via Instellingen en Connectors (Geavanceerd).
  2. Maak een nieuwe connector aan, plak de server-URL en kies OAuth als authenticatie.
  3. Log in bij Mijn Boekhoudapp en geef toestemming.

De menunamen in Claude en ChatGPT kunnen per versie en abonnement verschillen.

Beschikbare MCP-tools

De MCP-server biedt deze tools aan. Je bepaalt zelf welke tools aan staan.

Tool Wat doet het?
create-client-tool Maak een nieuwe klant aan in de boekhouding.
update-client-tool Werk klantgegevens bij.
create-product-tool Maak een nieuw product aan.
create-project-tool Maak een nieuw project aan.
create-invoice-tool Maak een nieuwe factuur aan voor een klant. Geef het klant-ID en de factuurregels op.
send-invoice-tool Verstuur een factuur per e-mail naar de klant. Een al verstuurde of achterstallige factuur kan opnieuw worden verstuurd (zonder extra credit); betaalde, geannuleerde en gecrediteerde facturen niet.
create-quote-tool Maak een nieuwe offerte aan voor een klant. Geef het klant-ID en de offerteregels op.
convert-quote-to-invoice-tool Zet een geaccepteerde offerte om naar een factuur.
record-expense-tool Registreer een nieuwe uitgave in de boekhouding.
upload-receipt-tool Upload een bon/receipt als base64-gecodeerd bestand en koppel deze aan een bestaande uitgave.
log-time-tool Registreer gewerkte uren op een project. Je kunt het project opgeven via ID of via projectnaam (en optioneel klantnaam).
record-payment-tool Registreer een betaling op een factuur.
download-invoice-pdf-tool Download een factuur als PDF-bestand. Retourneert de PDF als base64-gecodeerde data met factuurgegevens.
download-quote-pdf-tool Download een offerte als PDF-bestand. Retourneert de PDF als base64-gecodeerde data met offertegegevens.
search-tool Zoek door je boekhouding: klanten, facturen, offertes, uitgaven, projecten, tijdregistraties, producten of betalingen.

Meer lezen