AFAS koppelen met Claude: wat kan er met MCP en connectoren?

Hoe werkt een koppeling tussen AFAS en Claude?

Er zitten drie onderdelen tussen de vraag en het antwoord.

MCP staat voor Model Context Protocol, een open protocol waarmee een AI-assistent software buiten zichzelf aanroept. Een MCP-server biedt drie soorten dingen aan: tools (functies die de assistent aanroept), resources (gegevens om te lezen) en prompts (vaste instructies). Voor AFAS gaat het om tools. De verbinding loopt over Streamable HTTP; de huidige versie van de specificatie is 2026-07-28.

In Claude voeg je de server toe als eigen connector: Customize, Connectors, "Add custom connector", met het adres van de server. Volgens Anthropic werkt dat op Free, Pro, Max, Team en Enterprise, met op Free een maximum van één eigen connector. Bij Team en Enterprise voegt een Owner hem toe onder Organization settings.

Eén detail bepaalt de inrichting: Claude legt de verbinding vanuit de infrastructuur van Anthropic en niet vanaf je eigen computer. De MCP-server draait dus op een adres dat Anthropic kan bereiken, en hij logt elke gebruiker in via OAuth voordat er één tool beschikbaar is.

Zo ziet een tool eruit die de MCP-server aan Claude aanbiedt:

{
  "name": "voorraad_per_artikel",
  "description": "Geeft de voorraad per magazijn voor één artikelcode.",
  "inputSchema": {
    "type": "object",
    "properties": { "itemcode": { "type": "string" } },
    "required": ["itemcode"]
  },
  "annotations": { "readOnlyHint": true }
}

Wat levert AFAS zelf, en wat niet?

AFAS levert de REST API en de connectoren. Een MCP-server levert AFAS niet. Op de themapagina over AI van AFAS (nagelezen op 3 oktober 2026) staat dat AFAS onderzoekt of het een officiële MCP-server gaat aanbieden, of een speciaal type connector voor externe AI-koppelingen. Op dezelfde pagina staat dat er in juni 2026 nog geen AI-koppeling was gecertificeerd en dat AFAS het gebruik van een niet-gecertificeerde koppeling sterk afraadt, omdat AFAS dan niet kan controleren wat er met de gegevens gebeurt.

De risico's die AFAS noemt zijn concreet: gegevens die worden gewijzigd zonder weg terug, tokens met te ruime rechten, persoonsgegevens die zonder grondslag worden gedeeld en gegevens die buiten de EU terechtkomen. Tegenover elk daarvan staat een instelling in de app connector of een afspraak over welke velden meegaan. Die staan in de secties hieronder.

De bouwstenen aan de kant van AFAS:

Voor tokens loopt een overgang. Bestaande classic tokens krijgen een einddatum: het helpcentrum van AFAS noemt 15 februari 2027, de ontwikkelaarsdocumentatie 1 mei 2027. Reken met de eerste datum. Vanaf 1 september 2027 werken eigen app connectoren alleen nog met OAuth, via de authorization code flow of client credentials. De uitleg van de connectoren zelf staat in AFAS-connectoren.

Wat kan Claude lezen uit AFAS?

Alles waar een GetConnector voor bestaat, en niets daarbuiten. Een GetConnector is een definitie die de AFAS-beheerder samenstelt: welke velden, uit welke gegevensverzameling. AFAS levert standaarddefinities mee, zoals Profit_Article, en de beheerder maakt eigen definities. De MCP-server zet elke tool om naar één aanroep:

GET /profitrestservices/connectors/Assistent_Voorraad?filterfieldids=Itemcode&filtervalues=10482&operatortypes=1&skip=0&take=100 HTTP/1.1
Host: 12345.rest.afas.online
Authorization: AfasToken PHRva2VuPjx2ZXJzaW9uPjE8L3ZlcnNpb24+PGRhdGE+...

operatortypes=1 betekent "is gelijk aan"; 6 is "bevat" en 2 is "groter dan of gelijk aan". skip en take bladeren door het resultaat. De waarde na AfasToken is het token als Base64-tekst.

Een bruikbare set tools voor een handelsbedrijf:

Claude kiest de tool op basis van de naam en de beschrijving. Een tool met een smalle taak en een duidelijke beschrijving wordt vaker goed gekozen dan één tool die "alles uit AFAS" ophaalt.

De filterautorisatie van AFAS blijft gelden: de GetConnectoren in de app connector halen alleen records op die de gebruikersgroep achter het token mag zien. De gegevens die een tool teruggeeft, gaan naar Claude en dus naar Anthropic. Een GetConnector voor de assistent bevat daarom alleen de velden die voor het antwoord nodig zijn, zonder persoonsgegevens uit HRM of salarisverwerking.

Kan Claude ook schrijven in AFAS?

Ja, via een UpdateConnector. FbSales maakt een verkooporder aan, KnSalesRelationOrg een verkooprelatie, FbItemArticle een artikel. Een POST voegt toe, een PUT wijzigt en een DELETE verwijdert.

Er zijn drie plekken waar schrijven wordt begrensd, van zwak naar sterk:

1. De annotatie op de tool. readOnlyHint en destructiveHint vertellen Claude wat een tool doet. De MCP-specificatie noemt het zelf een hint: een client hoort annotaties van een server die hij niet vertrouwt als onbetrouwbaar te behandelen.
2. De instelling in Claude. Per tool kies je "Always allow", "Needs approval" of "Blocked". Bij Team en Enterprise stelt de Owner dit in voor de organisatie en kan een gebruiker het niet aanpassen.
3. De app connector in AFAS. Zit FbSales er niet in, dan weigert AFAS de aanroep, wat Claude of de MCP-server ook doet.

De derde is de enige harde grens. Een koppeling die alleen moet lezen, krijgt een app connector zonder UpdateConnectoren. Een koppeling die mag schrijven, krijgt precies de UpdateConnectoren die nodig zijn, met de tool in Claude op "Needs approval". De MCP-server logt elke aanroep met gebruiker, tool, parameters en het antwoord van AFAS, zodat achteraf vaststaat wie welke order heeft aangemaakt.

Hoeveel data past er in één antwoord?

AFAS publiceert geen aantal verzoeken per minuut. Er geldt een fair-use policy, met als voorbeeld dat AFAS contact opneemt als iemand elke minuut dezelfde dataset van 15 MB ophaalt. De harde grenzen liggen elders.

De grens van Claude is het eerst bereikt. Een rekenvoorbeeld met de vraag "welke tien klanten kochten het meest in september?":

• Ruwe factuurregels teruggeven: 8.400 regels van gemiddeld 250 tekens is 2.100.000 tekens. Dat is 14 keer de grens van 150.000. Er passen ongeveer 600 regels in één resultaat.
• Voor AFAS is dezelfde aanvraag geen probleem: 12 velden × 8.400 regels is 100.800, onder het advies van 150.000.
• De MCP-server telt zelf op en geeft tien regels van 120 tekens terug: 1.200 tekens.

De MCP-server haalt de regels dus in pagina's op bij AFAS, rekent zelf en geeft alleen de uitkomst aan Claude. Het rekenwerk blijft zo in code, waar een optelling over 8.400 regels elke keer dezelfde uitkomst geeft. De limiet aan de URL van 2.048 tekens begrenst het aantal filters per aanroep; een lijst van 300 artikelcodes past daar niet in en wordt in delen opgevraagd. Meer over dit soort grenzen staat in wat is een rate limit.

Hoe houd je de toegang dicht?

Tegenover elk risico dat AFAS noemt staat een instelling of een afspraak.

• Te ruime rechten. De app connector bevat alleen de connectoren voor de afgesproken vragen, en de gebruikersgroep achter het token krijgt alleen de bijbehorende filterautorisatie.
• Toegang door anderen. De IP-restrictie op de app connector staat op het adres van de MCP-server. De MCP-server zelf laat alleen verkeer toe uit de reeks die Anthropic voor uitgaande aanroepen publiceert, 160.79.104.0/21, en alleen voor ingelogde gebruikers.
• Wijzigingen zonder weg terug. Geen UpdateConnectoren in de app connector, of alleen met goedkeuring per aanroep.
• Persoonsgegevens en verwerking buiten de EU. Wat een tool teruggeeft, wordt door Anthropic verwerkt. De GetConnectoren voor de assistent bevatten daarom geen velden met persoonsgegevens. Welke gegevens wel meegaan, legt je eigen organisatie per connector vast.
• Het token. AFAS toont het één keer. Het hoort versleuteld bij de MCP-server te staan, niet in Claude en niet in een gesprek.

Wat betekent dit voor je koppeling?

Een koppeling tussen AFAS en Claude is dezelfde soort koppeling als die tussen AFAS en een webshop: dezelfde app connector, dezelfde GetConnectoren, dezelfde overgang naar OAuth. Wij bouwen de MCP-server op de connectoren van jouw omgeving, met de tools die bij jouw vragen passen, en hosten en bewaken hem daarna. Verandert AFAS de tokens of Anthropic het protocol, dan passen wij de server aan.

In het dashboard staat per aanroep welke gebruiker welke tool heeft gebruikt en wat AFAS teruggaf. Wat we verder met AFAS koppelen staat op AFAS koppelen aan je webshop, en het overzicht van alle stromen op koppelingen tussen je webshop en de systemen erachter. Vertel welke vragen je aan AFAS wilt stellen, dan hoor je welke connectoren daarvoor nodig zijn.