Quickstart (Self-Service)
- Konto anlegen auf ledgerbotje.nl/app. Die 14-tägige Testphase startet sofort, ohne Kreditkarte, auf Advanced-Niveau (lesen + schreiben, bis zu 10 Verwaltungen).
- Exact Online verbinden per OAuth: Sie autorisieren Ledger Botje einmalig für Ihre Verwaltung(en).
- MCP-Server hinzufügen im KI-Client mit dieser URL:
https://www.ledgerbotje.nl/app/mcp. Pro Client (ChatGPT, Claude, Copilot, Cursor und mehr) erklärt auf MCP verbinden.
Der KI-Client durchläuft den OAuth-Flow anschließend selbst; es gibt keine API-Keys zu verwalten.
Authentifizierung: OAuth 2.1 mit PKCE
- Authorization-Code-Flow mit verpflichtendem PKCE (S256); Scope
mcp:tools. - Dynamic Client Registration (RFC 7591): Clients registrieren sich selbst über das Registration-Endpoint - keine manuelle Anmeldung nötig.
- Tokens: Access-Tokens sind 1 Stunde gültig; Refresh-Tokens 30 Tage, rotierend.
- Alle Endpoints stehen in den Discovery-Dokumenten unten; eine 401 trägt einen
WWW-Authenticate-Header mitresource_metadata(RFC 9728), sodass ein Agent die Auth-Anforderungen aus einem einzigen Request lernt.
Maschinenlesbare Ressourcen
| openapi.json | OpenAPI 3.1-Beschreibung der HTTP-Surface: MCP-Endpoint, Dokumentupload-API und Discovery-Dokumente. |
|---|---|
| MCP Server-Card | Servername, Transport (Streamable HTTP), Authentifizierung und Capabilities. |
| llms.txt | Kompaktes Faktenblatt für KI-Assistenten; llms-full.txt listet alle 294 Tools. |
| oauth-protected-resource | RFC 9728-Metadaten: Resource, Authorization-Server, Scopes. |
| oauth-authorization-server | RFC 8414-Metadaten: Authorize-, Token- und Registration-Endpoint, PKCE-Methoden. |
| sitemap.xml | Alle indexierbaren Seiten, mit lastmod-Daten. |
Die vollständige Toolliste mit Beschreibungen steht auf MCP-Tools (294 Tools: 124 read-only, 170 schreibend) und ist programmatisch über tools/list am MCP-Endpoint abrufbar.
Dokumente hochladen
Für das Anliefern von Dateien (zum Beispiel Eingangsrechnungen) gibt es einen zweistufigen Upload-Flow: das MCP-Tool documents_request_upload_url gibt eine einmalige Upload-URL aus, danach wird die Datei mit einem gewöhnlichen HTTP-Request angeliefert:
curl -X PUT "https://ledgerbotje.nl/app/documentuploadapi.php?token=<64-zeichen-token>" \
--data-binary @rechnung.pdfDie Antwort ist JSON ({"success": true, ...}); das MCP-Tool documents_upload hängt die Datei anschließend über fileReference an Exact Online an.
Rate Limits
Limits sind informativ, nie blockierend: jede Tool-Antwort trägt ein rateLimit-Objekt und die X-RateLimit-*-Header, sodass ein Agent sein Tempo anpassen kann, ohne abgewiesene Calls. Richtwerte: 60 Calls pro Minute; pro Monat 5.000 (Basic) oder 8.000 (Advanced), erweiterbar mit Add-ons. Siehe Preise.
Testen Sie es mit Ihrer eigenen Verwaltung
14 Tage kostenlos, keine Kreditkarte erforderlich. Innerhalb von 5 Minuten stellt Ihr KI-Assistent Exact Online die erste Frage.
14 Tage kostenlos testen