Naar de inhoud

MCP-server

Koppel je AI-assistent aan EenFactuurMaken.nl met de MCP-server. Maak, controleer en verstuur Nederlandse facturen in een gesprek met ChatGPT, Claude, Cursor, Gemini CLI of Copilot.

Het Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten veilig met andere software werken. Met de MCP-server van EenFactuurMaken.nl maakt je assistent facturen, zoekt hij klanten op, maakt hij creditnota's en stuurt hij herinneringen, gewoon in een gesprek. Alle Nederlandse regels zitten erin. De MCP-server zit in elk plan.

Server-URL

text
https://eenfactuurmaken.nl/mcp

Transport: Streamable HTTP (zonder sessies, alleen POST). Je hoeft niets te installeren. Open je de URL in je browser, dan krijg je een foutmelding (405): dat klopt, alleen MCP-apps kunnen ermee praten.

Inloggen: OAuth of API-sleutel

OAuth (aanbevolen voor ChatGPT en Claude)

Je voegt alleen de URL toe. Je app opent een EenFactuurMaken.nl-venster waarin je inlogt en toestemming geeft. Je hoeft geen sleutel te kopiëren.

  • De app krijgt alleen toegang tot de MCP-server (rechten invoices en offline_access), niet tot de REST API.
  • Een toegangstoken is 1 uur geldig. De app vernieuwt het zelf; dat kan 60 dagen lang zonder opnieuw in te loggen.
  • Je krijgt een e-mail als er een app gekoppeld wordt.
  • Je ziet gekoppelde apps bij Instellingen → API & AI → Verbonden apps, en koppelt ze daar los.

API-sleutel (voor Claude Code, Cursor, VS Code en Gemini CLI)

Maak een sleutel bij Instellingen → API & AI en stuur hem mee als Authorization: Bearer efm_…. Handig voor tools op je eigen computer. Zie API-sleutels en apps.

Instellen per app

AppInloggenHandleiding
ChatGPTOAuthChatGPT
Claude.ai en Claude DesktopOAuth (of API-sleutel in Desktop)Claude
Claude CodeOAuth of API-sleutelClaude
CursorAPI-sleutelCursor
Gemini CLIOAuth of API-sleutelGemini CLI
GitHub Copilot in VS CodeAPI-sleutelVS Code

Gebruik je een andere app die MCP ondersteunt? Kies dan "Streamable HTTP" of "HTTP" als transport en vul de server-URL in, met OAuth of de Authorization-header.

Wat kan je assistent?

24 tools, onder andere: facturen maken, wijzigen, controleren, definitief maken en mailen; creditnota's; klanten en producten; herinneringen; betalingen; downloadlinks voor PDF en UBL; en je btw-cijfers per kwartaal. Plus kant-en-klare prompts. Het complete overzicht met voorbeelden staat bij Alle tools.

Bedragen mag je assistent gewoon in euro's opgeven ("85" of "85,50"); de server rekent om naar centen.

Voorbeelden

Maak een factuur voor Bakkerij De Gouden Korst: 12 uur webdesign à € 85 en een jaar hosting voor € 120.

Je assistent maakt een concept, controleert het en laat het totaal zien (€ 1.379,40 incl. 21% btw). Hij vraagt of hij het definitief mag maken en mailen.

Ik heb onderaanneming gedaan voor Bouwbedrijf Pietersen, € 2.500. Btw verlegd.

Hij maakt een factuur met btw verlegd, vraagt om het btw-nummer van de klant als dat ontbreekt en zet "Btw verlegd" op de factuur.

Welke facturen zijn te laat? Stuur een herinnering voor alles wat meer dan 14 dagen over tijd is.

Hij zoekt de openstaande facturen, laat ze zien en stuurt na jouw akkoord de herinneringen.

Factuur 2026-0012 was € 200 te hoog. Crediteer dat.

Hij maakt een gedeeltelijke creditnota van € 200 die verwijst naar 2026-0012.

Meer prompts vind je in de promptbibliotheek.

Veiligheid

  • Nieuwe facturen zijn altijd eerst een concept. Pas bij issue_invoice krijgen ze een nummer en liggen ze vast.
  • Tools die iets versturen of definitief maken, zijn als zodanig gemarkeerd. De meeste AI-apps vragen dan eerst om je toestemming. Laat dat aan staan.
  • Je assistent ziet alleen jouw gegevens, met jouw rechten en de limieten van je plan. Betaalgegevens (IBAN en dergelijke) kan hij niet wijzigen.
  • Downloadlinks werken 15 minuten (maximaal 60) en alleen voor die ene factuur.
  • Trek een API-sleutel in als je hem niet meer gebruikt, en koppel apps los die je niet meer gebruikt.

Problemen oplossen

MeldingOplossing
401De sleutel of het token ontbreekt, is ingetrokken of verlopen. Controleer de header, of log opnieuw in via je app.
402Deze functie zit in Pro, of je hebt je 5 gratis facturen van deze maand gebruikt.
403 insufficient_scopeHet OAuth-token mist het recht invoices. Koppel de app opnieuw.
405 in je browserKlopt: de server accepteert alleen POST-verzoeken van een MCP-app.
429Even te veel verzoeken. Wacht een minuut.
De app ziet geen toolsHerstart de app na het wijzigen van de configuratie, en controleer of de server aan staat in de instellingen van de app.

Meer bij Problemen oplossen.

Laatst bijgewerkt op 13 oktober 2026

Kom je er niet uit?

Mail ons op support@eenfactuurmaken.nl. Vertel wat je probeerde en wat er gebeurde, dan helpen we je verder.

support@eenfactuurmaken.nl