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
https://eenfactuurmaken.nl/mcpTransport: 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
invoicesenoffline_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
| App | Inloggen | Handleiding |
|---|---|---|
| ChatGPT | OAuth | ChatGPT |
| Claude.ai en Claude Desktop | OAuth (of API-sleutel in Desktop) | Claude |
| Claude Code | OAuth of API-sleutel | Claude |
| Cursor | API-sleutel | Cursor |
| Gemini CLI | OAuth of API-sleutel | Gemini CLI |
| GitHub Copilot in VS Code | API-sleutel | VS 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_invoicekrijgen 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
| Melding | Oplossing |
|---|---|
| 401 | De sleutel of het token ontbreekt, is ingetrokken of verlopen. Controleer de header, of log opnieuw in via je app. |
| 402 | Deze functie zit in Pro, of je hebt je 5 gratis facturen van deze maand gebruikt. |
403 insufficient_scope | Het OAuth-token mist het recht invoices. Koppel de app opnieuw. |
| 405 in je browser | Klopt: de server accepteert alleen POST-verzoeken van een MCP-app. |
| 429 | Even te veel verzoeken. Wacht een minuut. |
| De app ziet geen tools | Herstart 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.