The MCP connection works fine — until it suddenly does not. Expired token, an Exact Online password changed, a new administration your AI assistant has no access to. This article walks through the most common error messages and how to fix each in a few minutes.
1. "Reauthentication required" or 401 Unauthorized
By far the most common error. The OAuth token Ledger Botje uses on your behalf has expired or been revoked. This happens after 60 days of inactivity, after a password change, or when an admin altered your permissions.
Fix: log into your Ledger Botje account, go to Settings → Exact Online connection and click Re-authorize. You will be redirected to the Exact Online sign-in page; after approval the connection works again.
2. "Division not found" or administration unavailable
The AI assistant refers to an administration that no longer exists or that your account does not have rights to. Often this happens after an administration was renamed, decommissioned, or moved to a different license.
Fix: phrase your question with the explicit administration name. For example: "In administration Trading BV, what are the outstanding invoices?" If you do not see any administrations at all, check in Exact Online under My Own Administration → Users whether your user is still linked.
3. "Tool not allowed" on write actions
You ask ChatGPT to create a sales order and get an error that the tool is not available. This is because the Basic subscription only allows read tools — write actions are reserved for Advanced.
Fix: upgrade to Advanced via the pricing page. Or rephrase your question as a read action: "draft the text of a sales order for customer X, I will enter it myself".
4. "Rate limit exceeded" — too many questions
Every subscription has a monthly question limit (400 for Basic, 800 for Advanced). When exceeded you get a polite message and further queries are blocked until the next month.
Fix: check your usage in the Ledger Botje dashboard. Tip to save calls: ask compound questions instead of five separate ones. "Per quarter, give revenue, outstanding invoices and largest customer" costs one call, not three.
5. AI hallucinates invoice numbers or customer names
Sometimes an AI assistant invents an order number or amount that does not exist. This is rarely the MCP connection — more often it is loose prompt phrasing, and the AI fills gaps with fabricated data.
Fix: always refer to concrete identifiers. "Show invoice F2026-00123" works better than "show the latest invoice". Read our 5 tips for better prompts.
6. ChatGPT says: "I have no access to external tools"
This means the MCP server is not (correctly) linked in ChatGPT. Often you simply forgot to enable the connector for this conversation, or you are on the wrong ChatGPT plan.
Fix: restart the chat, open Settings → Connectors and enable the Ledger Botje connector. Claude and Copilot follow similar steps — see our step-by-step setup guide.
7. Slow responses or timeouts
Large queries on large administrations take time. If you ask "show all invoices from the past 5 years", Ledger Botje fetches thousands of rows and the AI may time out.
Fix: narrow the query with dates and filters: "invoices from Q1 2026 above €5,000". Faster and gives a more useful answer.
Need help?
Stuck? Check the FAQ first — it covers most edge cases. For harder issues, contact support via your dashboard. Include the exact error, the time, and which AI assistant you are using — that lets us help faster.
All running again? Great. This may be a good moment to read our MCP security explainer or the 10 ready-made prompts to get more out of your setup.