Je AI-assistent verbinden

Finance MCP werkt met elke AI-assistent die het open Model Context Protocol (MCP) voor remote servers ondersteunt. In de praktijk gaat het om assistenten als Claude, Copilot en ChatGPT, maar het protocol is bewust open, zodat ook andere clients die MCP spreken op precies dezelfde manier kunnen verbinden. Je voegt in je assistent één keer een connector toe die naar Finance MCP wijst, je logt eenmalig in met een link uit je e-mail en je geeft toestemming voor read-only toegang. Daarna stel je je vragen gewoon in het gesprek, en haalt je assistent op de achtergrond de cijfers op uit de administraties die aan jou zijn toegewezen.

Op deze pagina lopen we de hele route door: waar je de MCP-URL vindt, hoe je die als connector toevoegt in Claude, Copilot en ChatGPT, hoe de eenmalige inlog- en toestemmingsstap verloopt, hoe je je eerste vraag stelt en hoe sessies en opnieuw inloggen werken. Onderaan leggen we op hoofdlijnen uit welke techniek hieronder ligt, voor wie wil begrijpen hoe het veilig blijft.

De MCP-URL vind je in het portal

De verbinding begint altijd met één adres: de MCP-URL. Die vind je in het portal op portal.financemcp.nl, onder het onderdeel "Verbind je AI-assistent". Daar staat precies één URL die voor je hele organisatie hetzelfde is. Het is dus geen geheim dat per persoon verschilt, want de beveiliging zit niet in de URL maar in de individuele login die elke medewerker daarna doorloopt.

Het generieke patroon: connector toevoegen en URL plakken

Bij elke MCP-compatibele assistent komt het op hetzelfde neer. Je zoekt in de instellingen de plek op waar je connectors, integraties of externe tools beheert, je kiest voor het toevoegen van een eigen connector en je plakt de MCP-URL uit het portal. Vervolgens bevestig je, en de assistent neemt contact op met Finance MCP om de verbinding op te zetten. Op dat moment opent zich een browservenster voor de inlog- en toestemmingsstap, die verderop wordt beschreven.

De onderdelen die je zoekt heten per assistent net iets anders. De volgende secties wijzen je per programma de weg, zonder schermafbeeldingen, omdat de exacte schermen geregeld veranderen. Het patroon eronder blijft hetzelfde: connector toevoegen, URL plakken, bevestigen.

Verbinden vanuit Claude

Verbinden vanuit Copilot

Verbinden vanuit ChatGPT

Eenmalig inloggen en toestemming geven

Nadat je de connector hebt toegevoegd, stuurt je AI-assistent je automatisch naar de inlogpagina van Finance MCP in een browservenster. Hier werk je zonder wachtwoord. Je vult je zakelijke e-mailadres in en ontvangt daarop een eenmalige inloglink. Die link is vijftien minuten geldig en werkt precies één keer, zodat een onderschepte of doorgestuurde link daarna niets meer doet.

De toestemming die je geeft is bewust eng begrensd. Finance MCP begint bewust met alleen lezen, zodat je cijfers nooit per ongeluk veranderen, en er bestaat op dit moment geen schrijfpad om boekingen of wijzigingen door te voeren. Mocht schrijven later komen als daar vraag naar is, dan krijgt dat een eigen, expliciet toestemmingspad waar je apart akkoord voor geeft. Je assistent ziet bovendien alleen de administraties waarvoor een beheerder je heeft geautoriseerd. Er wordt geen financiële data opgeslagen, en de verwerking gebeurt in West-Europa.

Je eerste vraag stellen

Zodra de connector actief is, stel je je vragen rechtstreeks in het gesprek met je assistent, in gewone taal. Begin met iets eenvoudigs om te controleren of de verbinding werkt, bijvoorbeeld "Welke administraties kan ik bevragen?". Je assistent haalt dan op welke administraties aan jou zijn toegewezen en somt ze op. Zie je daar minder administraties dan je verwacht, dan heeft een beheerder je waarschijnlijk nog geen toegang gegeven tot de betreffende koppeling; hoe dat werkt staat bij Medewerkers en toegang.

Daarna kun je inhoudelijke vragen stellen over de cijfers. Een veelgebruikt voorbeeld is "Welke facturen staan langer dan 60 dagen open?". Je assistent vertaalt die vraag naar de juiste opvraging, haalt de gegevens read-only op uit de gekoppelde administratie en geeft het antwoord terug in het gesprek. Meer voorbeelden van wat je kunt vragen staan bij welke vragen kun je stellen.

Sessies en opnieuw inloggen

Na de eenmalige toestemming onthoudt je assistent de verbinding, zodat je niet bij elke vraag opnieuw hoeft in te loggen. De toegang loopt op de achtergrond via kortlevende sleutels die automatisch worden vernieuwd. In de praktijk merk je daar niets van: je blijft gewoon vragen stellen, en de vernieuwing gebeurt zonder dat je iets hoeft te doen.

Soms vraagt je assistent je toch opnieuw in te loggen. Dat gebeurt bijvoorbeeld als je lange tijd niets hebt gevraagd, als je op een nieuw apparaat begint of als een beheerder je toegang opnieuw moet bevestigen. In dat geval doorloop je dezelfde korte stap als de eerste keer: je e-mailadres invullen, op de inloglink klikken en toestemming geven. Dat duurt minder dan een minuut.

Meerdere assistenten naast elkaar

Je bent niet beperkt tot één assistent. Je kunt Claude, Copilot en ChatGPT prima naast elkaar gebruiken met dezelfde Finance MCP-koppeling. In elke assistent voeg je de connector één keer toe met dezelfde MCP-URL, en in elke assistent doorloop je de eenmalige inlog- en toestemmingsstap. Daarna werkt elke assistent zelfstandig met jouw eigen toegang.

Omdat elke verbinding aan jouw persoonlijke login hangt, blijven de regels overal hetzelfde: de toegang blijft bij het lezen waarmee we bewust beginnen, en je ziet alleen de administraties die aan jou zijn toegewezen. Welke assistent je ook gebruikt, je ziet nooit meer dan waar je recht op hebt, en alle opvragingen blijven herleidbaar tot jouw login.

Als je assistent geen connectors ondersteunt

Niet elke AI-assistent ondersteunt het toevoegen van een eigen MCP-connector. Ondersteunt jouw assistent dat niet, dan kun je Finance MCP er niet rechtstreeks mee koppelen. Het protocol is open, dus de ondersteuning groeit, maar op dit moment werkt de koppeling alleen met assistenten die remote MCP-servers aankunnen.

Hoe het onder de motorkap werkt

Je hoeft de techniek niet te kennen om Finance MCP te gebruiken, maar voor wie het wil begrijpen leggen we het op hoofdlijnen uit. De koppeling draait op het open Model Context Protocol voor remote servers. Dat is dezelfde standaard die je AI-assistent gebruikt om met externe bronnen te praten, waardoor de ene URL bij verschillende assistenten werkt.

Het inloggen verloopt via OAuth 2.1, de gangbare standaard voor veilige toegang zonder dat je een wachtwoord aan de assistent geeft. Daarbij gebruiken we verplicht PKCE, een mechanisme dat voorkomt dat een inlogcode onderweg kan worden misbruikt. Je assistent registreert zichzelf bovendien automatisch via dynamische client-registratie, zodat je daar zelf niets voor hoeft in te stellen.

Na je inlog ontvangt je assistent een kortlevend access token, dat ongeveer dertig minuten geldig is, plus een refresh token dat ongeveer dertig dagen meegaat. Met dat refresh token vernieuwt je assistent de toegang automatisch op de achtergrond, zodat je niet telkens opnieuw hoeft in te loggen. Doordat het access token kort leeft, blijft het venster waarin een onderschepte sleutel bruikbaar zou zijn klein.

Volgende stap: welke vragen kun je stellen.