Quickstart (self-service)
- Maak een account aan op ledgerbotje.nl/app. De proefperiode van 14 dagen start direct, zonder creditcard, op Advanced-niveau (lezen + schrijven, maximaal 10 administraties).
- Koppel Exact Online via OAuth: je autoriseert Ledger Botje eenmalig voor je administratie(s).
- Voeg de MCP-server toe aan je AI-client met deze URL:
https://www.ledgerbotje.nl/app/mcp. Per client (ChatGPT, Claude, Copilot, Cursor en meer) uitgelegd op MCP koppelen.
De AI-client doorloopt daarna zelf de OAuth-flow; er zijn geen API-keys om te beheren.
Authenticatie: OAuth 2.1 met PKCE
- Authorization code flow met verplichte PKCE (S256); scope
mcp:tools. - Dynamic client registration (RFC 7591): clients registreren zichzelf via het registration-endpoint - geen handmatige aanmelding nodig.
- Tokens: access tokens zijn 1 uur geldig; refresh tokens 30 dagen en roterend.
- Alle endpoints staan in de discovery-documenten hieronder; een 401 bevat een
WWW-Authenticate-header metresource_metadata(RFC 9728), zodat een agent de auth-vereisten uit één request leert.
Machine-leesbare bronnen
| openapi.json | OpenAPI 3.1-beschrijving van de HTTP-surface: MCP-endpoint, documentupload-API en discovery-documenten. |
|---|---|
| MCP server-card | Servernaam, transport (Streamable HTTP), authenticatie en capabilities. |
| llms.txt | Compact feitenblad voor AI-assistenten; llms-full.txt bevat alle 294 tools. |
| oauth-protected-resource | RFC 9728-metadata: resource, authorization servers, scopes. |
| oauth-authorization-server | RFC 8414-metadata: authorize-, token- en registration-endpoint, PKCE-methodes. |
| sitemap.xml | Alle indexeerbare pagina's, met lastmod-datums. |
De volledige toollijst met beschrijvingen staat op MCP-tools (294 tools: 124 alleen-lezen, 170 schrijvend) en is programmatisch op te vragen via tools/list op het MCP-endpoint.
Documenten uploaden
Voor het aanleveren van bestanden (bijvoorbeeld inkoopfacturen) bestaat een upload-flow in twee stappen: de MCP-tool documents_request_upload_url geeft een eenmalige upload-URL uit, waarna het bestand met een gewone HTTP-request wordt aangeleverd:
curl -X PUT "https://ledgerbotje.nl/app/documentuploadapi.php?token=<64-tekens-token>" \
--data-binary @factuur.pdfDe respons is JSON ({"success": true, ...}); daarna koppelt de MCP-tool documents_upload het bestand aan Exact Online via fileReference.
Rate limits
Limieten zijn informatief, niet blokkerend: elke tool-respons bevat een rateLimit-object en de X-RateLimit-*-headers, zodat een agent zijn tempo kan aanpassen zonder geweigerde calls. Richtwaarden: 60 calls per minuut; per maand 5.000 (Basic) of 8.000 (Advanced), uitbreidbaar met add-ons. Zie prijzen.
Probeer het met je eigen administratie
14 dagen gratis, geen creditcard nodig. Binnen 5 minuten stelt je AI-assistent zijn eerste vraag aan Exact Online.
Gratis 14 dagen proberen