Claude AFAS-koppeling: zo zet je het veilig op, stap voor stap

Stand van zaken

Bestaat er een Claude-connector voor AFAS?

Nee, niet van AFAS zelf en niet door AFAS goedgekeurd. AFAS schrijft op zijn klantportal dat AI-koppelingen mogen, maar alleen als ze gecertificeerd zijn, en dat er op het moment van publicatie (juni 2026) nog geen enkele AI-integratie gecertificeerd is. Ook niet van AFAS-partners. Een MCP-server of AI-agent die zich als "AFAS-oplossing" presenteert, noemt AFAS ongetest en "volledig voor eigen risico". Wel onderzoekt AFAS zelf een officiële MCP-server of een speciaal type connector voor externe AI. Een MCP-server is het programmaatje dat een AI-assistent veilig met een ander systeem laat praten.

En in de connectordirectory van Claude?

In de officiële connectorlijst van Anthropic zat op 1 augustus 2026 geen AFAS-koppeling, net zo min als andere Nederlandse boekhoud- en salarispakketten; dat staat uitgewerkt op MCP en connectors. Kijk zelf in Claude bij Customize, Connectors, Browse of daar sinds onze controle iets is bijgekomen. Staat er iets met AFAS in de naam, controleer dan op partner.afas.nl/koppelingen of het gecertificeerd is.

Wat de open-source servers doen

Beide GitHub-projecten praten met de Profit REST API via een token van een app connector. De server van Schuberg Philis (Python, Apache-2.0, aangemaakt in september 2026) is standaard alleen-lezen: schrijfacties bestaan pas als je AFAS_ALLOW_WRITES=true zet. Het project zegt zelf dat het niet aan AFAS gelieerd is en stond op 28 oktober 2026 nog niet op PyPI. De server van RemcoE33 (Go) maakt van elke GetConnector een tool en kan data in een lokale database zetten voor SQL-analyse. Geen van beide is door AFAS gecertificeerd.

Waarom AFAS zo voorzichtig is

Een token is de sleutel tot je AFAS-omgeving. Wie hem heeft, kan gegevens inzien, wijzigen en soms alles beheren. AFAS ziet dat mensen een bestaand token "even" hergebruiken voor een AI-koppeling, en daarmee continu toegang weggeven. Een AI-agent die verkeerd schrijft, maakt in seconden fouten die je niet altijd kunt terugdraaien. Daarom begint deze tutorial bij de route zonder token.

Voorbereiding

Wat heb je nodig om Claude met AFAS te laten werken?

Kies eerst je route. Route A (export) is voor iedereen die een weergave in AFAS mag openen en exporteren. Route B (live, alleen-lezen) is voor een functioneel beheerder die app connectoren mag aanmaken en die een terminal niet eng vindt.

Waarom Team of Enterprise

Op Team en Enterprise gelden de zakelijke voorwaarden van Anthropic: je invoer wordt standaard niet gebruikt voor training en de verwerkersovereenkomst zit automatisch in die voorwaarden. Op Free, Pro en Max is er geen verwerkersovereenkomst met jouw organisatie en staat training aan tot je hem uitzet. Voor een export met debiteurnummers en bedragen is dat verschil klein; voor alles met namen van personen is het groot. Lees de details op Claude privacy en zakelijk gebruik.

Waarom je het AFAS-omgevingsnummer nodig hebt (route B)

Het nummer staat in het webadres van je AFAS Online-omgeving, bijvoorbeeld 12345 in 12345.afasonline.com. De REST API van die omgeving zit dan op 12345.rest.afas.online. De testomgeving gebruikt resttest in plaats van rest. Zonder dat nummer weet de server niet welke omgeving hij moet aanspreken.

Route A

Route A: een AFAS-export in Claude analyseren, stap voor stap

Dit is de route die we elk mkb-team als eerste laten doen. Je geeft Claude geen toegang tot AFAS, alleen een bestand dat je zelf hebt opgeschoond. Het voorbeeld is de ouderdomsanalyse van debiteuren: wie betaalt te laat en wie bel je deze week.

Waarom geen live koppeling als eerste stap

Een export is een momentopname: wat je daarna in AFAS wijzigt, zie je niet terug. Dat klinkt als een nadeel, maar voor de meeste vragen (wie belt de controller deze week, hoe staan de projecturen er per maand voor) is een wekelijkse export ruim voldoende. Je leert zo welke vragen echt waarde hebben, voordat je een token uitgeeft. Werk je vaker met spreadsheets in Claude, kijk dan ook bij Claude in Excel.

Vaste vragen? Zet de prompt in een project

Doe je dit elke week, maak dan in Claude een project "Debiteuren" en zet de prompt in de projectinstructies. Je uploadt dan alleen nog de nieuwe export en vraagt: "Maak de bellijst van deze week."

Route B

Route B: een alleen-lezen live koppeling tussen Claude en AFAS

Deze route geeft Claude live leestoegang tot één GetConnector, via een open-source MCP-server op je eigen computer. Lees eerst dit: dit is een niet door AFAS gecertificeerde integratie, en AFAS raadt die sterk af. Doe het alleen met akkoord van de directie, alleen-lezen, met zo min mogelijk velden en bij voorkeur eerst in een testomgeving. Een GetConnector is een zelfgemaakt eindpunt in AFAS dat precies de velden teruggeeft die jij kiest.

Het configuratieblok voor Claude Desktop

{
"mcpServers": {
"afas": {
"command": "uvx",
"args": ["--from", "git+https://github.com/schubergphilis/afas_mcp_server", "afas-mcp-server"],
"env": {
"AFAS_MEMBER_ID": "12345",
"AFAS_ENVIRONMENT": "test",
"AFAS_TOKEN": "<token><version>1</version><data>JOUW_TOKEN</data></token>"
}
}
}
}
Haal AFAS_ENVIRONMENT weg of zet hem op production als je na het testen naar je echte omgeving gaat. Het token staat zo leesbaar in een bestand op je computer: gebruik dit alleen op een versleutelde laptop die alleen van jou is.

Liever in Claude Code?

Het project geeft ook de variant voor Claude Code: claude mcp add afas -e AFAS_MEMBER_ID=12345 -e AFAS_TOKEN='...' -- uvx afas-mcp-server. Zolang het pakket niet op PyPI staat, vervang je het laatste deel door de --from git+...-variant uit stap 6. De algemene uitleg over servers toevoegen staat in MCP-server toevoegen.

Waarom lokaal en niet als custom connector in claude.ai

Een custom connector in claude.ai verbindt vanuit de cloud van Anthropic, dus de server moet publiek op internet staan. Anthropic waarschuwt ook dat een vaste sleutel in een gedeelde connector iedereen in je Team- of Enterprise-organisatie dezelfde toegang geeft. Een AFAS-token met een server op het open internet is precies wat AFAS niet wil. Lokaal op één laptop, voor één persoon, is de kleinste versie van dit risico.

Houd rekening met de tokenwissel in 2027

AFAS maakt OAuth de standaard voor eigen koppelingen. Bestaande classic tokens kregen in september 2026 een einddatum van 1 mei 2027, nieuwe classic tokens kun je uitgeven tot uiterlijk 31 augustus 2027. De open-source server werkt met een classic token. Plan dus nu al wanneer je stopt of overstapt. App connectoren die zes maanden niet gebruikt zijn, blokkeert AFAS automatisch.

Controle

Werkt het? De eerste prompt en hoe je de uitkomst controleert

Je weet dat het werkt als Claude een getal noemt dat je in AFAS kunt terugvinden. Begin daarom met een vraag waarvan je het antwoord al kent, en pas daarna met de vraag die je eigenlijk hebt.

Eerste prompt voor route A (plak na het uploaden)

#CONTEXT
Je bent een ervaren credit controller in een Nederlands mkb-bedrijf. Bijgevoegd is een export van de ouderdomsanalyse debiteuren uit AFAS Profit. Namen zijn vervangen door debiteurnummers. De uitkomst gaat naar onze directeur, die wil weten waar het geld blijft hangen en wie we deze week bellen.
#DOEL
Een belprioriteit voor deze week.
#WERKWIJZE
1. Noem eerst de kolommen die je ziet en de peildatum. Vraag om bevestiging als een kolom onduidelijk is.
2. Tel het totaal openstaand en het deel ouder dan 60 dagen.
3. Rangschik de debiteuren op bedrag en ouderdom samen.
#OUTPUT
Een tabel met debiteurnummer, openstaand incl. btw, oudste post in dagen en een voorgestelde actie. Daaronder drie zinnen voor de directeur.
#BELANGRIJKE REGELS
Reken alleen met getallen uit het bestand. Verzin geen namen of oorzaken. Controleer aan het eind of je totaal gelijk is aan de som van de kolom met het openstaand saldo en meld elk verschil.
#BEPERKINGEN
Maximaal tien debiteuren in de tabel.

Welke regel het verschil maakt

Stap 1 van de werkwijze dwingt Claude om eerst te laten zien wat hij in je bestand ziet. Leest hij een kolom verkeerd, dan zie je dat voordat er een bellijst op staat. De zelfcontrole op het totaal geeft jou één getal om naast AFAS te leggen: klopt het totaal met de weergave, dan heeft Claude geen regels overgeslagen.

Eerste vragen voor route B

Vraag eerst: "Welke AFAS-connectoren kun je gebruiken?" Claude hoort precies jouw ene GetConnector te noemen; noemt hij er meer, dan heeft je app connector te veel rechten. Vraag daarna: "Hoeveel regels geeft deze connector terug met het vaste filter?" en vergelijk dat met het aantal bij Voorbeeld in AFAS. Pas als beide kloppen, stel je je echte vraag. Anthropic raadt aan elk goedkeuringsverzoek voor een tool te lezen en voorzichtig te zijn met "Allow always".

Problemen

Problemen met Claude en AFAS: melding, oorzaak, oplossing

Dit zijn de meldingen waar je bij deze twee routes het vaakst op vastloopt. De eerste vier horen bij de export, de rest bij de live koppeling.

AVG en HR

Welke AFAS-gegevens je nooit via een AI-koppeling ontsluit

AFAS is voor veel mkb-bedrijven het systeem met de gevoeligste gegevens in huis: salarissen, verzuim, BSN, sollicitaties. Dat maakt de keuze welke data je laat zien belangrijker dan de techniek. Onze regel: begin bij financiële en projectdata op nummer, en houd HR en salaris buiten elke AI-koppeling die je zelf bouwt.

Wie er allemaal meekijkt

Elke partij tussen AFAS en Claude ziet je gegevens. Bij route A is dat alleen Anthropic. Bij een gehoste MCP-koppeling van een leverancier, of bij Make of n8n in de cloud, komt daar een partij bij, en met elke partij heb je een verwerkersovereenkomst nodig. Vraag ook waar die partij de data verwerkt: AFAS adviseert opslag en verwerking binnen de EU waar dat kan.

Rechten minimaal, ook als het lastig is

Een GetConnector op een brede gegevensverzameling met alle velden is sneller gebouwd dan een smalle. Doe het toch smal. Claude leest alles wat de connector teruggeeft, ook velden waar je vraag niets mee te maken heeft, en die velden staan dan in het gesprek. Wat niet in de GetConnector zit, kan ook niet uitlekken. Wil je HR-vragen met AI beantwoorden, kijk dan eerst wat Jonas in AFAS al kan: die data verlaat AFAS dan niet. Meer over AI in HR lees je in AI voor HR.

Mkb-voorbeeld

Voorbeeld: debiteuren en projecturen bij een installatiebedrijf

Neem een installatiebedrijf met dertig medewerkers. Financiën, HR en projecten draaien in AFAS Profit; het team werkt in Microsoft 365 en heeft Claude Team. De controller wil elke maandag weten wie hij moet bellen. De projectleider wil weten welke projecten over hun urenbudget gaan.

De controller: route A, elke maandag

Hij heeft een eigen weergave van de ouderdomsanalyse zonder contactgegevens, met een filter op posten ouder dan 30 dagen. Maandag om negen uur: Ctrl+E, namen eruit, uploaden in het Claude-project "Debiteuren", vraag "bellijst van deze week". Hij legt het totaal naast AFAS, belt de bovenste vijf en verwijdert het bestand. Hier is geen token nodig en niemand hoeft iets te bouwen.

De projectleider: route B, alleen-lezen

Zij wil dit vaker per week en live. De beheerder bouwt één GetConnector met projectnummer, projectomschrijving, begrote uren, geboekte uren en week. Er staat geen medewerkernaam in. De app connector heeft alleen die GetConnector, geen UpdateConnector, een token van negentig dagen en een IP-restrictie op kantoor. De directeur tekent het besluit. Haar vraag aan Claude: "Welke projecten zitten boven 80 procent van hun begrote uren terwijl ze minder dan 80 procent klaar zijn volgens de planning? Geef projectnummer en het verschil in uren."

Wat ze bewust niet doen

Geen verzuimcijfers in Claude, ook niet "even" om een trend te zien. Geen schrijfrechten om uren automatisch te laten corrigeren. En geen gedeelde connector voor het hele team met één token: dan zou iedereen in de organisatie dezelfde toegang krijgen, ook mensen die die projectdata in AFAS zelf niet mogen zien.

Ons oordeel

Ons oordeel: wanneer je Claude aan AFAS koppelt en wanneer niet

Begin met route A. In onze trainingen zien we dat de meeste AFAS-vragen van mkb-teams over een vaste lijst gaan die één keer per week ververst mag worden. Daar is een export sneller, goedkoper en veiliger dan een koppeling.

Doe het wel als

Je een terugkerende vraag hebt over financiële of projectdata, die je kunt beantwoorden zonder namen van personen. Of als je beheerder een smalle, alleen-lezen GetConnector kan bouwen en de directie bewust ja zegt tegen een niet-gecertificeerde koppeling, met een einddatum.

Doe het niet als

De vraag over HR, salaris, verzuim of sollicitanten gaat. Als iemand Claude wil laten schrijven in AFAS: boekingen, uren of medewerkergegevens. Of als je organisatie onder de Cyberbeveiligingswet valt (de Nederlandse uitwerking van NIS2) en je AI-koppelingen nog niet in je leveranciersbeleid hebt opgenomen. Wacht dan op de officiële voorziening waar AFAS aan werkt.

De fout die we beginners het vaakst zien maken

Een bestaand token hergebruiken. Er draait al een koppeling met een webshop of een BI-tool, het token staat ergens in een notitie, en dat wordt "even" in een AI-tool geplakt. Dat token hangt aan een app connector met UpdateConnectoren en brede GetConnectoren, en is vaak onbeperkt geldig. AFAS noemt precies dit patroon als groot risico. Maak voor Claude altijd een eigen app connector met een eigen token, zodat je hem los kunt intrekken.

Wat nu?

Wat nu? Vervolgstappen na je eerste AFAS-analyse in Claude

Werkt route A, laat de vraag dan een paar weken lopen voordat je iets bouwt. Je merkt vanzelf of de wekelijkse export knelt of dat hij gewoon goed genoeg is.

Verder lezen in de gids

MCP en connectors legt uit hoe koppelingen in Claude werken en welke Nederlandse systemen ontbreken. MCP-server toevoegen doet route B voor elke server. Claude Desktop helpt bij de app zelf. Voor de privacy-afspraken lees je Claude privacy en zakelijk gebruik.

Zelf een server bouwen

Wil je weten wat er in zo'n MCP-server zit, lees dan MCP-server maken. Leg je spelregels vast in je AI-beleid voordat iemand anders een token deelt. En wil je dat je team zo'n koppeling zelf leert bouwen, smal en alleen-lezen, dan is dat waar we in de Agent Sprint twee weken aan werken.