Je boekhoudpakket koppelen

Een koppeling is de verbinding tussen FinanceMCP en één omgeving van je boekhoudpakket. Het koppelen is de stap waarmee je FinanceMCP 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.

FinanceMCP 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 FinanceMCP 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 FinanceMCP 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 FinanceMCP je pakketwachtwoord nooit te zien krijgt. De leverancier geeft FinanceMCP 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 FinanceMCP 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 FinanceMCP de administraties opnieuw op: nieuwe administraties worden meteen zichtbaar, en administraties die niet meer meekomen worden automatisch op non-actief gezet.

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.

Minder administraties koppelen, en dus minder betalen

Welke administraties er achter een koppeling verschijnen bepaal je niet in FinanceMCP, maar in je boekhoudpakket: de koppeling ziet precies de administraties waar het pakketaccount waarmee je autoriseert toegang toe heeft. Staan er administraties tussen die je niet via FinanceMCP wilt bevragen, bijvoorbeeld slapende vennootschappen of oude jaren, dan hoef je daar niet voor te blijven betalen. Zo pas je het aan.

Beperk de toegang in het pakket en autoriseer opnieuw

Beperk eerst in je boekhoudpakket de toegang van het account dat je voor de koppeling gebruikt tot de administraties die je wél wilt ontsluiten. In Exact Online regel je dat via de gebruikersrechten per administratie (divisie); in Moneybird via de toegang per administratie van de gebruiker. Open daarna de koppeling in het portal en kies voor opnieuw autoriseren, met datzelfde account. FinanceMCP haalt de administraties opnieuw op en zet alles wat niet meer meekomt automatisch op non-actief.

Administraties die op non-actief staan tellen vanaf dat moment niet meer mee voor je abonnement. De aantallen worden binnen enkele uren doorgegeven aan de facturatie en de wijziging telt vanaf de eerstvolgende factuurperiode; er wordt niets met terugwerkende kracht verrekend. Koppel je een administratie later opnieuw, bijvoorbeeld omdat een vennootschap weer actief wordt, dan verschijnt hij bij de volgende autorisatie vanzelf weer, met dezelfde instellingen en toegang als voorheen.

De administratie zelf verandert hier niets van: FinanceMCP heeft alleen leesrechten en de gegevens staan gewoon in je boekhoudpakket. Non-actief betekent alleen dat de administratie niet meer via je AI-assistent te bevragen is en niet meer meetelt in je abonnement.

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. Op dit moment kun je in het portal Exact Online, Moneybird en Business Central koppelen; de overige pakketten zijn in ontwikkeling en nog niet te selecteren. De stappen die je hieronder bij die pakketten leest, beschrijven de beoogde werkwijze, zodat je alvast weet wat je straks nodig hebt. De volgorde waarin pakketten beschikbaar komen is vraaggestuurd, en de actuele dekking houden we bij op de pakkettenpagina van de marketingsite, zie financemcp.nl/pakketten.

Exact Online (live)

Let op: koppelen met apps uit de Exact Online App Store kan vanaf het Plus-abonnement van Exact. Met het Essentials-abonnement weigert Exact de koppeling na de autorisatie met de melding "The Customer is blocked". Accountants die met FinanceMCP willen werken hebben dus Plus of hoger nodig op de omgeving die ze koppelen.

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.

Moneybird (live)

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. FinanceMCP 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.

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 (live)

Business Central koppelt anders dan de andere pakketten: niet met een persoonlijk account, maar met een eenmalige goedkeuring door de beheerder van jullie Microsoft-omgeving. Daardoor loopt de koppeling niet via iemands login en blijft hij werken als medewerkers wisselen. Het kost drie stappen, waarvan twee eenmalig.

Registreer eerst in Business Central de app: zoek op de pagina "Microsoft Entra-toepassingen", voeg de FinanceMCP-app toe met client-ID ed479398-e509-43bf-8dc3-bf08d8adb11e, zet de status op Ingeschakeld en ken de machtigingenset D365 READ toe. Goed om te weten: FinanceMCP heeft zelf geen schrijffuncties, want er bestaat in de dienst simpelweg geen pad dat iets in je administratie kan wijzigen, dus ook met ruimere machtigingen zou er nooit iets geschreven worden. Met D365 READ leg je diezelfde grens ook nog eens vast in je eigen pakket, zodat je zelf in control blijft over wat de koppeling mag.
Kies in het portal voor Business Central en vul twee gegevens in: jullie Microsoft Entra-tenant (de tenant-ID of het domein, bijvoorbeeld bedrijf.onmicrosoft.com) en de naam van de Business Central-environment (die zie je in het Business Central-beheercentrum; vaak "Production").
Klik op autoriseren. Een beheerder van jullie Microsoft-omgeving logt in en keurt de koppeling eenmalig goed (admin consent); kies daarbij een account dat in dezelfde tenant leeft als de Business Central-omgeving. Er wordt geen wachtwoord met FinanceMCP gedeeld en de toestemming is per direct weer in te trekken via jullie eigen Entra-beheer.

Direct na de goedkeuring verschijnen de companies automatisch als administraties in het portal. Sla je stap 1 over, dan meldt het portal na de goedkeuring een geweigerde toegang; voer de registratie alsnog uit en kies daarna opnieuw autoriseren. De btw wordt afgeleid uit de boekingsgegevens.

RGS-mapping: rapporteren op RGS-niveau

Business Central kent geen RGS-codes (Referentie Grootboekschema). Wil je rapportages die over administraties en pakketten heen vergelijkbaar zijn, vul dan eenmalig de RGS-mapping in: open in het portal bij de koppeling het menu (⋯) en kies "RGS-mapping". Je ziet daar het volledige rekeningschema en vult per rekening de RGS 3.7-code in. De knop "Voorstel invullen" zet alvast grove voorstellen neer (hoofdrubrieken zoals BVor, BSch en WOmz) op basis van het type en de naam van elke rekening; die controleer en verfijn je daarna. Rekeningen zonder mapping blijven gewoon werken, maar rapporteren op rekeningnummerniveau.

Sneller en preciezer gaat het met je AI-assistent: die kan het rekeningschema lezen en een volledige mapping voorstellen die je in het scherm plakt (onder "Voorstel van je AI-assistent plakken"). Gebruik bijvoorbeeld deze prompt:

Haal met get_ledger_accounts het volledige rekeningschema op van administratie [naam of administrationId]. Stel voor elke rekening de best passende RGS 3.7-code voor: zo specifiek als je zeker weet, anders de hoofdrubriek (zoals BVor, BVrd, BLim, BEiv, BSch, BLas, WOmz, WKpr, WPer, WAfs, WBed). Geef het resultaat uitsluitend als regels in de vorm rekeningnummer;RGS-code, zonder toelichting, zodat ik het kan plakken in het RGS-mappingscherm van FinanceMCP.

Controleer het geplakte voorstel altijd voordat je opslaat: de mapping bepaalt hoe je rapportages gerubriceerd worden, en jij (of je accountant) blijft daarvoor verantwoordelijk.

Dynamics 365 Finance & Operations (in ontwikkeling)

Een beheerder van jullie Microsoft-omgeving keurt de koppeling eenmalig goed (admin consent).
De bedrijven en administraties verschijnen in het portal. De btw wordt afgeleid uit de boekingsgegevens.

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.
Moneybird	Live	Inloggen bij Moneybird en toestemming geven via OAuth	Journaalposten worden gereconstrueerd uit mutaties en als zodanig gemarkeerd in het antwoord.
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	Live	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.
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.