Wat is MCP? Het Model Context Protocol uitgelegd voor je ERP

Hoe werkt MCP?

MCP verbindt drie onderdelen. De host is de AI-toepassing waarin je de vraag stelt, zoals Claude of ChatGPT. De client is het stuk in die toepassing dat de verbinding legt. De server is de software die gegevens en functies aanbiedt. Anthropic publiceerde het protocol op 25 november 2024; de huidige versie van de specificatie is 2026-07-28.

Een server kan drie soorten dingen aanbieden:

Bij een ERP gaat het bijna altijd om tools. De berichten zijn JSON-RPC 2.0, gecodeerd in UTF-8. Er zijn twee standaard transports: stdio, voor een server die als proces op dezelfde computer draait, en Streamable HTTP, waarbij elk bericht een POST naar één adres is. Een assistent in de browser gebruikt Streamable HTTP.

De client vraagt eerst met tools/list welke tools er zijn, en roept er daarna een aan met tools/call:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "voorraad_per_artikel",
    "arguments": { "itemcode": "10482" }
  }
}

Het antwoord bevat de tekst of JSON die de server teruggeeft, met isError: true als de aanroep misging. Zo'n fout gaat terug naar het model, zodat het de aanroep met een andere waarde kan herhalen, bijvoorbeeld een datum in het juiste formaat.

Wat doet een MCP-server voor een ERP?

Een MCP-server vertaalt. Een tool als openstaande_orders met als argument debiteur 10432 wordt een GET op de API van het ERP met een filter op die debiteur. Het antwoord van het ERP gaat, ingekort tot wat nodig is, terug naar de assistent.

Daaruit volgt de belangrijkste regel: MCP voegt geen gegevens toe. Wat de API van het ERP niet levert, kan geen MCP-server teruggeven. De standaard-API v2.0 van Business Central geeft bij een artikel één voorraadgetal, zonder uitsplitsing per locatie. Een MCP-server op die API kan dus ook geen voorraad per magazijn geven, tenzij er een eigen API-pagina naast komt.

Sommige ERP-leveranciers leveren zelf een MCP-server, andere niet:

Voor AFAS en Exact Online wordt een MCP-server gebouwd op de REST API van het pakket. Hoe dat per pakket werkt, staat in AFAS koppelen met Claude en Exact Online koppelen met Claude.

Wie bepaalt wat de assistent mag?

Er zijn drie lagen, van zwak naar sterk.

De annotaties op een tool. Een server kan bij elke tool aangeven wat hij doet. Zonder annotatie gelden de standaardwaarden, en die gaan uit van het ergste geval.

De specificatie noemt dit uitdrukkelijk hints: een client moet annotaties van een server die hij niet vertrouwt als onbetrouwbaar behandelen.

De instellingen in de assistent. De specificatie vraagt dat een gebruiker elke aanroep kan weigeren. In Claude kies je per tool "Always allow", "Needs approval" of "Blocked". ChatGPT behandelt een tool zonder readOnlyHint als schrijvend en vraagt standaard om bevestiging.

De rechten in het ERP. Dit is de enige harde grens. Business Central voert elke aanroep uit met de identiteit en rechten van de ingelogde gebruiker. Bij AFAS bepaalt de app connector welke UpdateConnectoren bereikbaar zijn. Wat het ERP weigert, gebeurt niet, wat de assistent ook vraagt.

Hoeveel past er in één antwoord?

De API van het ERP is zelden de eerste grens. Claude neemt van één tool ongeveer 150.000 tekens aan en geeft een aanroep 240 seconden. Een rekenvoorbeeld met de vraag "welke artikelen liggen onder de minimumvoorraad?" bij 12.000 artikelen:

• Ruwe artikelregels teruggeven: 12.000 × 120 tekens = 1.440.000 tekens. Dat is 9,6 keer de grens van Claude.
• Ophalen bij een API die 250 records per pagina geeft: 12.000 / 250 = 48 aanroepen. Bij één aanroep per seconde is dat 48 seconden, binnen de 240.
• De MCP-server filtert zelf en vindt 85 artikelen onder het minimum: 85 × 120 = 10.200 tekens naar Claude.

De MCP-server doet dus het filteren en optellen in code, en de assistent formuleert het antwoord. Een optelling in code geeft bij dezelfde gegevens elke keer dezelfde uitkomst. Die 48 aanroepen tellen wel mee voor de rate limit van het ERP. Bij Exact Online, waar de limiet per app en per administratie telt, krijgt een MCP-server met een eigen app-registratie een eigen budget, los van de koppeling met de webshop. Hoe zulke limieten werken, staat in wat is een rate limit.

Welke versie en welke verbinding?

MCP verandert nog. Een versienummer is een datum: de laatste dag waarop iets niet meer achterwaarts compatibel was.

Client en server spreken per aanvraag een versie af; een server die de gevraagde versie niet kent, geeft terug welke hij wel ondersteunt. Inloggen is in de specificatie optioneel. Waar het gebeurt, is de MCP-server een resource server in de zin van OAuth 2.1, en de assistent de client. Business Central en NetSuite gebruiken allebei de authorization code flow met PKCE. Claude legt de verbinding vanuit de infrastructuur van Anthropic, dus een eigen MCP-server draait op een adres dat van buiten bereikbaar is.

Wat betekent dit voor je koppeling?

Een MCP-server is een koppeling met het ERP, alleen met een AI-assistent aan de andere kant in plaats van een webshop. Hij heeft dezelfde onderdelen nodig: een app-registratie, tokens die verlopen, rate limits en een keuze welke velden meegaan. Heeft je ERP zelf geen MCP-server, of levert de standaard-API niet wat je wilt vragen, dan bouwen wij de server op de API van jouw pakket, met tools die bij jouw vragen passen.

Wij hosten en bewaken die server en passen hem aan als het ERP of het protocol verandert. Elke aanroep komt in de log: welke gebruiker, welke tool, welke parameters en wat het ERP terugstuurde. Het overzicht van wat we verder koppelen staat op koppelingen tussen je webshop en de systemen erachter. Vertel welke vragen je aan je ERP wilt stellen, dan hoor je welke tools daarvoor nodig zijn.