Exact Online koppelen met Claude: wat kan er met MCP?

Hoe werkt een koppeling tussen Exact Online en Claude?

Tussen de vraag en het antwoord zitten drie onderdelen.

MCP staat voor Model Context Protocol: een open protocol waarmee een AI-assistent functies buiten zichzelf aanroept. De MCP-server biedt die functies aan als tools, elk met een naam, een beschrijving en een schema voor de invoer. Claude kiest de tool op basis van die beschrijving en vult de parameters in.

In Claude voeg je de server toe als eigen connector, via Customize, Connectors en "Add custom connector". Volgens Anthropic werkt dat op Free, Pro, Max, Team en Enterprise; Free mag één eigen connector hebben. Claude maakt de verbinding vanuit de infrastructuur van Anthropic, niet vanaf je eigen computer. De MCP-server draait dus op een openbaar adres en laat alleen ingelogde gebruikers toe. Wie verder wil afschermen, beperkt inkomend verkeer tot de reeks 160.79.104.0/21 die Anthropic voor uitgaande aanroepen publiceert.

Wat levert Exact zelf, en wat niet?

Exact levert de REST API en een eigen set AI-agents binnen het pakket. Een MCP-server levert Exact niet. In de kennisbank van Exact Online gaf een zoekopdracht op "MCP", "Claude" en "ChatGPT" op 3 oktober 2026 nul resultaten.

De eigen agents van Exact werken binnen Exact, op de gegevens van de administratie waarin je werkt:

Het verschil zit in het bereik. De Financial Agent werkt op de winst-en-verliesgegevens van één administratie, de Excel Agent op CRM-gegevens. Een MCP-server bepaal je zelf: hij kan voorraad, openstaande posten en orders uit Exact combineren met gegevens uit je webshop of WMS in één antwoord. Volgens Exact blijven gegevens die je met de eigen agents deelt binnen de omgeving van Exact. Wat een MCP-server aan Claude teruggeeft, wordt door Anthropic verwerkt.

Hoe krijgt de MCP-server toegang tot Exact?

Via OAuth 2.0 met een eigen app-registratie. Exact ondersteunt alleen de grant types authorization code en implicit. Client credentials, waarmee een server zonder gebruiker inlogt, kent Exact niet. Elke verbinding hoort dus bij een Exact-gebruiker die één keer inlogt en toestemming geeft.

Het refresh token staat volgens Exact voor de rechten van de gebruiker die toestemming gaf. Het hoort versleuteld bij de MCP-server te staan, niet in Claude en niet in een gesprek. Wordt de app 30 dagen niet gebruikt, dan verloopt het refresh token en logt de gebruiker opnieuw in.

Exact vraagt een Data & Security review voordat andere klanten een app mogen koppelen of voordat hij in de App Store komt. Daarin legt de bouwer het doel, de scopes en de clouddiensten vast waar gegevens naartoe gaan. Bij een MCP-server die antwoorden aan Claude doorgeeft, hoort Anthropic in die lijst.

Wat kan Claude lezen uit Exact Online?

Alles waarvoor de REST API een endpoint heeft, binnen de scopes van de app en de rechten van de gebruiker. Een bruikbare set tools voor een groothandel:

Twee details van Exact zelf bepalen hoe de tools werken. SalesOrders en de voorraadendpoints bestaan alleen bij Wholesale & Distribution en Manufacturing. En het debiteurnummer Code in crm/Accounts is een tekst van 18 tekens met voorloopspaties. Een filter op '10432' vindt niets; de MCP-server vult zelf aan tot 18 tekens:

GET /api/v1/1234567/crm/Accounts?$filter=Code eq '             10432'&$select=ID,Name HTTP/1.1
Host: start.exactonline.nl
Authorization: Bearer eyJhbGciOi...
Accept: application/json

Met de ID uit dat antwoord filtert de volgende aanroep ReceivablesList op AccountId. Claude hoeft het formaat van het debiteurnummer niet te kennen; dat zit in de code van de tool.

Kan Claude ook schrijven in Exact Online?

Ja. SalesOrders neemt een POST aan met de verplichte velden OrderedBy (de GUID van de klant) en SalesOrderLines, waarin elke regel een Item als GUID heeft. Een afgeronde verkooporder kan via de API niet meer worden gewijzigd. Een negatief aantal op een orderregel is bij Exact een inruilregel, geen retour.

Schrijven wordt op drie plekken begrensd, van zwak naar sterk:

1. De annotatie op de tool. readOnlyHint en destructiveHint vertellen Claude wat een tool doet. De MCP-specificatie noemt dat een hint die een client niet hoeft te vertrouwen.
2. De instelling in Claude. Per tool kies je "Always allow", "Needs approval" of "Blocked". Bij Team en Enterprise legt de Owner dat vast voor de organisatie.
3. De scope in Exact. Een scope beperkt volgens Exact wat een app namens de gebruiker mag, per domein met alleen lezen of ook schrijven. De gebruiker ziet die scopes in het toestemmingsscherm van Exact.

De MCP-server logt elke aanroep met gebruiker, tool, parameters en het antwoord van Exact. Achteraf staat vast wie welke order heeft aangemaakt en met welke regels.

Hoeveel vragen passen er in de limieten?

Exact telt 60 calls per minuut en 5.000 per dag, per app en per administratie. De MCP-server is een eigen app, dus de koppeling met je webshop houdt haar eigen budget. Claude stelt daar twee grenzen naast: een toolresultaat van ongeveer 150.000 tekens en 240 seconden per aanroep. De volledige uitleg van de limieten van Exact staat in Exact Online API limieten.

Een rekenvoorbeeld voor een bedrijf met 8 gebruikers die elk 30 vragen per werkdag stellen, met gemiddeld 3 GET per vraag:

• 8 × 30 × 3 = 720 calls per dag. Dat is 14,4 procent van 5.000.
• De vraag "omzet per klant in september" op ruwe factuurregels: 3.000 regels uit SalesInvoiceLines bij 60 regels per pagina is 50 calls. Twee van die vragen in dezelfde minuut zijn 100 calls; de laatste 40 krijgen HTTP 429.
• Dezelfde 3.000 regels van gemiddeld 200 tekens zijn 600.000 tekens: vier keer wat er in één toolresultaat past.
• ReportingBalance met een filter op ReportingYear en ReportingPeriod geeft de periodetotalen per grootboekrekening. Bij 40 omzetrekeningen is dat één pagina van 60 en dus één call.

De tool rekent dus in de MCP-server en geeft Claude het resultaat, niet de regels. Telt hij wel per regel, dan passen er 5.000 / 50 = 100 van zulke vragen in een dag, voor alle gebruikers samen. Een tool die steeds een ongeldig filter stuurt, raakt na 10 fouten in een uur dat endpoint kwijt voor die gebruiker. De MCP-server vangt een 400 daarom zelf af en stuurt dezelfde fout niet opnieuw. Meer over dit soort grenzen staat in wat is een rate limit.

Wat betekent dit voor je koppeling?

Een koppeling tussen Exact Online en Claude gebruikt dezelfde REST API, dezelfde OAuth-tokens en dezelfde limieten als de koppeling tussen Exact en je webshop. Wij bouwen de MCP-server op de endpoints die bij jouw vragen horen, met de rekensommen in code, en hosten en bewaken hem daarna. Verandert Exact een endpoint of Anthropic het protocol, dan passen wij de server aan.

In het dashboard staat per aanroep welke gebruiker welke tool gebruikte en wat Exact teruggaf. Wat we verder met Exact koppelen staat op Exact Online koppelen aan je webshop; dezelfde opbouw voor AFAS staat in AFAS koppelen met Claude. Vertel welke vragen je aan Exact wilt stellen, dan hoor je welke endpoints en scopes daarvoor nodig zijn.