Je boekhoudpakket koppelen

Een koppeling is de verbinding tussen Finance MCP en één omgeving van je boekhoudpakket. Het koppelen is de stap waarmee je Finance MCP toestemming geeft om de cijfers uit dat pakket te lezen, zodat je AI-assistent er vragen over kan beantwoorden. Je legt deze koppeling één keer aan in het portal, daarna gebruik je hem steeds opnieuw zonder dat je telkens opnieuw hoeft in te loggen bij je pakket.

Achter één koppeling kunnen meerdere administraties zitten. In Exact Online heten die divisies, in Business Central companies en in andere pakketten weer anders, maar de gedachte is overal hetzelfde: één koppeling staat voor één omgeving bij de leverancier, en binnen die omgeving kunnen meerdere administraties vallen. Na het koppelen verschijnen die administraties automatisch in je portal, zonder dat je ze stuk voor stuk hoeft toe te voegen.

Finance MCP begint bewust met alleen lezen, zodat we snel kunnen ontwikkelen en je cijfers nooit per ongeluk veranderen. Elke koppeling vraagt enkel de minimale leesrechten die de leverancier ondersteunt, en er bestaat op dit moment geen schrijfpad waarmee Finance MCP boekingen zou kunnen aanmaken, wijzigen of verwijderen in je pakket. Schrijfacties bouwen we later als daar vraag naar is, met een eigen expliciet toestemmingspad. Er wordt geen financiële data opgeslagen; de verwerking gebeurt in West-Europa. Wat wel bewaard wordt, is het versleutelde koppelingstoken dat nodig is om de verbinding te onderhouden.

Wat je nodig hebt voordat je begint

Het koppelen zelf duurt een paar minuten, maar het verloopt soepeler als je een aantal dingen klaar hebt liggen. Loop deze lijst even na voordat je in het portal aan de slag gaat.

Een beheerdersaccount in het Finance MCP portal. Alleen beheerders kunnen koppelingen aanmaken; gewone medewerkers krijgen pas toegang nadat een beheerder die toewijst.
Inloggegevens van het boekhoudpakket dat je wilt koppelen. Je logt straks rechtstreeks bij de leverancier in, dus gebruik een account dat toegang heeft tot de administraties die je wilt ontsluiten.
Duidelijkheid over welke omgeving je koppelt, bijvoorbeeld de productieomgeving of een testomgeving. Voor elke omgeving leg je een aparte koppeling aan.
Bij sommige pakketten een akkoord van een IT-beheerder van jullie eigen Microsoft- of pakketomgeving. Dat speelt vooral bij de Microsoft-pakketten; verderop op deze pagina staat per pakket wat er geldt.

Het koppelproces stap voor stap

Het aanmaken van een koppeling verloopt in een vaste volgorde. Je geeft de koppeling eerst een naam, je autoriseert daarna bij de leverancier, en tot slot verschijnen de administraties vanzelf in het portal. De drie stappen hieronder beschrijven dat van begin tot eind.

Stap 1: geef de koppeling een herkenbare naam

Log in op het portal, ga naar het onderdeel Koppelingen en kies voor het toevoegen van een nieuwe koppeling. Het eerste wat je doet is de koppeling een naam geven. Kies een naam die je collega's ook herkennen, want deze naam komt terug in het toegangsbeheer en in de antwoorden van je AI-assistent. Een naam als "Exact productie" of "Business Central holding" werkt beter dan een afkorting die alleen jij begrijpt, zeker als je later meerdere koppelingen naast elkaar hebt staan.

Stap 2: autoriseer bij de leverancier via OAuth

Na het opslaan stuurt het portal je door naar de inlogpagina van de leverancier. Daar log je in met je bestaande pakketaccount en geef je via de officiële koppelmethode toestemming, een procedure die in de techniek OAuth heet. Het belangrijke daarvan is dat je je wachtwoord rechtstreeks bij de leverancier invoert en dat Finance MCP je pakketwachtwoord nooit te zien krijgt. De leverancier geeft Finance MCP na jouw akkoord een afgeschermd koppelingstoken, en dat token werkt alleen voor de leesrechten die je hebt goedgekeurd. Zodra je de toestemming bevestigt, stuurt de leverancier je automatisch terug naar het portal.

Stap 3: de administraties verschijnen automatisch

Direct na de autorisatie haalt Finance MCP op welke administraties achter de koppeling zitten. Je hoeft die niet handmatig in te voeren; ze verschijnen vanzelf onder de koppeling in het portal. Bij een omgeving met meerdere administraties zie je ze allemaal in een overzicht staan, klaar om toegang aan medewerkers toe te wijzen. Vanaf dat moment is de koppeling actief en kun je verder met het verbinden van je AI-assistent.

De beheerder die de koppeling aanmaakt krijgt er zelf direct toegang toe. Collega's krijgen die toegang pas wanneer een beheerder die expliciet toewijst, en dat gebeurt per administratie. Hoe je dat regelt staat in Medewerkers en toegang.

Meerdere koppelingen naast elkaar

Je bent niet beperkt tot één koppeling. Veel organisaties hebben meerdere omgevingen of zelfs meerdere pakketten, en je legt voor elke omgeving een eigen koppeling aan. Ze staan daarna naast elkaar in het portal, elk met hun eigen naam en hun eigen set administraties. Dit is bijvoorbeeld handig wanneer je situaties als deze hebt.

Een productieomgeving en een aparte testomgeving van hetzelfde pakket, die je uit elkaar wilt houden in de antwoorden van je AI-assistent.
Meerdere ondernemingen of vestigingen die elk hun eigen omgeving bij de leverancier hebben, waardoor één koppeling niet alle administraties kan zien.
Een organisatie die in een overgangsperiode twee verschillende pakketten gebruikt en de cijfers uit beide naast elkaar wil bevragen.

Omdat alle pakketten via hetzelfde canonieke datamodel worden ontsloten, blijven je vragen hetzelfde, ook als de cijfers uit verschillende koppelingen komen. De herkenbare naam die je per koppeling kiest helpt je en je collega's om in de antwoorden te zien uit welke omgeving een bedrag komt.

Een koppeling verloopt en opnieuw autoriseren

De toestemming die je bij het koppelen geeft is niet eeuwig geldig. Een koppeling kan verlopen of ingetrokken raken, en dat is normaal. Het gebeurt bijvoorbeeld wanneer het wachtwoord van het pakketaccount wijzigt, wanneer iemand de toestemming in het pakket zelf intrekt, of wanneer de leverancier de geldigheid van het token na verloop van tijd laat aflopen. Je merkt het doordat de koppeling in het portal een andere status krijgt en je AI-assistent geen actuele cijfers meer uit die omgeving haalt.

Zo herstel je een verlopen koppeling

Het herstellen is eenvoudig en lijkt op het oorspronkelijke koppelen. Open de koppeling in het portal en kies voor opnieuw autoriseren. Je doorloopt dezelfde route langs de leverancier: je logt in met je pakketaccount en bevestigt de toestemming. De koppeling houdt zijn naam en zijn toegewezen toegang, dus je hoeft niets opnieuw in te stellen voor je medewerkers. Na de hernieuwde autorisatie staat de status weer op actief en haalt Finance MCP de administraties opnieuw op, zodat ook eventuele nieuwe administraties meteen zichtbaar worden.

Wil je een koppeling juist definitief stoppen, trek dan eerst de toestemming in bij het pakket zelf en verwijder daarna de koppeling in het portal. Bij het verwijderen wordt ook het opgeslagen koppelingstoken meteen gewist, zodat er geen verbinding meer mogelijk is.

Verbinding maken per pakket

Het koppelproces is in grote lijnen voor elk pakket gelijk, maar er zijn verschillen in wat de leverancier ondersteunt en in hoe je de toestemming verleent. Exact Online is op dit moment live en is het eerste pakket dat in de eerste release native wordt ondersteund. De overige pakketten zijn in ontwikkeling; de volgorde waarin ze beschikbaar komen is vraaggestuurd en begint bij Exact. Hieronder vind je per pakket de concrete stappen om de verbinding te maken. De actuele dekking houden we bij op de pakkettenpagina van de marketingsite, zie financemcp.nl/pakketten.

Exact Online (live)

Kies in het portal voor "Koppeling toevoegen" en geef de koppeling een herkenbare naam, bijvoorbeeld "Exact productie".
Je wordt doorgestuurd naar de inlogpagina van Exact Online; log daar in met je eigen Exact-account.
Geef in het toestemmingsscherm van Exact akkoord voor de read-only koppeling.
Je komt terug in het portal en alle divisies waar je account bij kan, verschijnen automatisch als administraties. RGS-codes komen mee als die in Exact zijn ingericht.

e-Boekhouden.nl (in ontwikkeling)

Log in op e-Boekhouden.nl en ga naar Beheer → Instellingen, naar het onderdeel voor koppelingen/API; maak daar een API-token aan voor de moderne REST-koppeling. (het precieze menupad kan per versie iets verschillen)
Kopieer het API-token.
Kies in het portal voor "Koppeling toevoegen", selecteer e-Boekhouden.nl als pakket en plak het API-token.
Je administratie verschijnt en je kunt vragen gaan stellen.

De oude SOAP-koppeling van e-Boekhouden.nl is per 1 januari 2026 uitgefaseerd, dus gebruik de moderne REST-koppeling. Het API-token werkt als een sleutel, dus deel het niet; je kunt het in e-Boekhouden altijd weer intrekken.

SnelStart (in ontwikkeling)

Open de SnelStart-webapp en ga naar Extra → Koppelingen → Maatwerk; genereer daar een maatwerksleutel. (het precieze menupad kan per versie iets verschillen)
Kopieer de maatwerksleutel.
Kies in het portal voor "Koppeling toevoegen", selecteer SnelStart als pakket, plak de maatwerksleutel en kies de administratie waarvoor de sleutel geldt.
Klaar; je kunt vragen gaan stellen.

SnelStart vernieuwt op de achtergrond elk uur een toegangstoken, daar hoef jij niets voor te doen.

Business Central en Dynamics 365 (in ontwikkeling)

Een beheerder van jullie Microsoft-omgeving keurt de koppeling eenmalig goed (admin consent).
Vul tijdens het koppelen eenmalig een RGS-mapping in zodat de cijfers op RGS-niveau beschikbaar komen; zonder die mapping vallen de rapportages terug op rekeningnummerniveau.
De bedrijven en administraties verschijnen in het portal. De btw wordt bij deze pakketten afgeleid uit de boekingsgegevens.

Moneybird (in ontwikkeling)

Kies in het portal voor "Koppeling toevoegen", selecteer Moneybird als pakket en geef de koppeling een herkenbare naam.
Je wordt doorgestuurd naar Moneybird; log in en geef toestemming via de officiële koppeling (OAuth), vergelijkbaar met Exact.
Je komt terug in het portal en je administraties verschijnen automatisch.

Moneybird werkt met mutaties in plaats van met kant-en-klare journaalposten. Finance MCP reconstrueert de journaalposten daarom uit die mutaties en markeert een gereconstrueerde post als zodanig in het antwoord van je AI-assistent, zodat je altijd ziet wanneer een journaalpost is samengesteld.

AFAS en Twinfield (in ontwikkeling)

AFAS en Twinfield staan ook op de planning. De werkwijze wordt vergelijkbaar met de andere pakketten: je geeft de koppeling een herkenbare naam en autoriseert bij de leverancier, waarna de administraties vanzelf verschijnen. De precieze stappen volgen zodra deze pakketten live gaan. Welke pakketten op welk moment beschikbaar zijn, lees je altijd het meest actueel op financemcp.nl/pakketten.

Wat er per pakket geldt in het kort

Pakket	Status	Autorisatie	Bijzonderheden
Exact Online	Live, native	Inloggen bij Exact en eenmalig akkoord geven voor de read-only koppeling via OAuth	Alle divisies waar je pakketaccount bij kan verschijnen automatisch als administraties, inclusief hun RGS-codes wanneer die in Exact zijn ingericht. Btw komt rechtstreeks uit Exact.
e-Boekhouden.nl	In ontwikkeling	API-token dat je in je e-Boekhouden-account aanmaakt en in het portal plakt	Gebruik de moderne REST-koppeling; de SOAP-koppeling is per 1 januari 2026 uitgefaseerd. Het token werkt als een sleutel die je altijd weer kunt intrekken.
SnelStart	In ontwikkeling	Maatwerksleutel die je in SnelStart onder Extra → Koppelingen → Maatwerk genereert	Je kiest bij het koppelen de administratie waarvoor de sleutel geldt. SnelStart vernieuwt het toegangstoken elk uur op de achtergrond.
Business Central	In ontwikkeling	Eenmalige goedkeuring (admin consent) door een beheerder van jullie Microsoft-omgeving	RGS via eenmalige mapping, anders op rekeningnummerniveau. Btw wordt afgeleid uit de boekingsgegevens.
Dynamics 365	In ontwikkeling	Eenmalige goedkeuring (admin consent) door een beheerder van jullie Microsoft-omgeving	RGS via eenmalige mapping, anders op rekeningnummerniveau. Btw wordt afgeleid uit de boekingsgegevens.
Moneybird	In ontwikkeling	Inloggen bij Moneybird en toestemming geven via OAuth	Journaalposten worden gereconstrueerd uit mutaties en als zodanig gemarkeerd in het antwoord.
AFAS	In ontwikkeling	Volgt	Vergelijkbare werkwijze; alle pakketten spreken hetzelfde datamodel, dus je vragen blijven dezelfde.
Twinfield	In ontwikkeling	Volgt	Vergelijkbare werkwijze; alle pakketten spreken hetzelfde datamodel, dus je vragen blijven dezelfde.

De volgorde waarin de pakketten in ontwikkeling beschikbaar komen is vraaggestuurd en begint bij Exact. Kijk voor de actuele dekking altijd op de pakkettenpagina: financemcp.nl/pakketten.

Volgende stap: je AI-assistent verbinden.