WeFact koppelen aan ChatGPT en Claude

Stap voor stap een API key maken in WeFact, ons IP-adres op de whitelist zetten, de MCP-URL toevoegen aan Claude, ChatGPT of Cursor, en kiezen wat de AI mag wijzigen.

Door Gepubliceerd op

Wil je ChatGPT of Claude vragen welke facturen nog openstaan, wat een klant dit jaar betaalde of welke abonnementen er lopen? Dan moet je AI-assistent bij je WeFact-administratie kunnen. Dat doe je met een MCP-server: een koppeling die je AI-assistent vertelt welke gegevens hij mag ophalen en hoe. In deze handleiding lees je hoe je WeFact in een paar minuten koppelt aan Claude, ChatGPT of Cursor, wat je daarna kunt vragen, en hoe je zelf bepaalt wat de AI in WeFact mag wijzigen.

Wat is MCP, en wat heb je eraan?

MCP (Model Context Protocol) is de open standaard waarmee AI-assistenten met andere software praten. WeFact heeft een API, maar ChatGPT en Claude kunnen daar niet zelf mee werken. Een MCP-server zit ertussen: je AI-assistent vraagt bijvoorbeeld om de openstaande facturen, de server haalt ze live op bij WeFact en geeft het antwoord terug.

WeFact heeft zelf een AI-chatbot achter de knop HELP, maar die beantwoordt alleen vragen over het gebruik van WeFact en kijkt niet mee in je administratie. Wil je AI die je eigen facturen en klanten kent, dan heb je een MCP-server nodig.

MCP Hosted draait die server voor je. Je hoeft niets te installeren en geen code te schrijven. Je maakt een API key in WeFact, zet ons IP-adres op de whitelist, plakt de key in je dashboard en voegt één URL toe aan je AI-assistent.

Wat heb je nodig?

  • Een WeFact-account waarin je bij de API-instellingen mag.
  • Een account bij MCP Hosted met een abonnement voor WeFact. De bedragen staan op de pagina Prijzen.
  • Een AI-assistent die remote MCP-servers ondersteunt, zoals Claude, ChatGPT of Cursor.

Stap 1: kopieer je API key in WeFact

  1. Ga in WeFact naar Instellingen en daarna naar API.
  2. Kopieer de API key. WeFact noemt die ook wel de beveiligingscode.

Een WeFact API key kun je niet beperken: met de key zelf kun je alles in je administratie lezen en wijzigen. Daarom bepaal je in stap 3 bij ons wat de AI mag, en controleert onze server dat bij elke vraag.

Stap 2: zet ons IP-adres op de whitelist

WeFact beantwoordt alleen API-verzoeken van IP-adressen die op de whitelist van je account staan. Zet daarom op dezelfde pagina in WeFact, onder Instellingen en daarna API, ons IP-adres op de whitelist. Het adres staat op de instellingenpagina van WeFact in je dashboard. Sla je deze stap over, dan zegt WeFact dat er geen toegang is tot de API.

Stap 3: koppel de key in MCP Hosted en kies wat de AI mag

Log in bij MCP Hosted, open WeFact en plak de API key. Geef de koppeling een naam, bijvoorbeeld de naam van je administratie. We controleren de key direct bij WeFact: klopt hij niet, dan zie je dat meteen en wordt er niets opgeslagen.

Een nieuwe koppeling is read-only: de AI kan alles lezen, maar niets wijzigen. Wil je dat de AI ook werk voor je doet, dan vink je aan wat hij mag, in vier groepen:

  • Aanmaken en wijzigen: klanten, producten en abonnementen toevoegen en wijzigen, en conceptfacturen opstellen.
  • Versturen naar klanten: facturen en betalingsherinneringen naar je klanten mailen.
  • Betalingen: betalingen registreren, en facturen als betaald of onbetaald markeren.
  • Verwijderen en stopzetten: conceptfacturen verwijderen, facturen crediteren en abonnementen beëindigen.

Open een groep om alleen losse acties daarbinnen toe te staan, bijvoorbeeld wel herinneringen versturen maar geen facturen. Later iets veranderen? Klik op Bewerken naast de koppeling. De URL blijft hetzelfde.

Daarna zie je de MCP-URL van de koppeling, zoals https://mcphosted.com/mcp/wefact/12. Die URL voeg je toe aan je AI-assistent. Een URL zonder nummer aan het eind leidt naar je eerste WeFact-koppeling. Heb je meerdere administraties, dan maak je per administratie een koppeling, elk met een eigen URL en eigen rechten.

Stap 4: voeg de URL toe aan je AI-assistent

De menu's van AI-assistenten veranderen vaak. Hieronder staat de route op hoofdlijnen. Zoek in je assistent naar connectors, integraties of MCP-servers als een naam net anders is.

Claude

Open de instellingen van Claude en zoek het onderdeel voor connectors. Kies daar voor een eigen connector toevoegen, plak de MCP-URL en bevestig. Claude opent dan een inlogscherm van MCP Hosted. Log in en keur de toegang goed. Daarna kun je in een gesprek de WeFact-connector aanzetten.

ChatGPT

ChatGPT ondersteunt remote MCP-servers via connectors. Of je een eigen connector mag toevoegen, hangt af van je abonnement en soms van de instellingen van je werkruimte. Zoek in de instellingen naar connectors of apps, maak een nieuwe connector aan met de MCP-URL en log in bij MCP Hosted als ChatGPT daarom vraagt.

Cursor

Open in Cursor de instellingen voor MCP en voeg een nieuwe server toe met de MCP-URL. Cursor opent je browser om in te loggen bij MCP Hosted. Daarna staan de WeFact-tools in de lijst van je agent.

Elke AI-assistent krijgt een eigen login. Onder Settings, AI clients in je dashboard zie je welke assistenten toegang hebben, en zet je er een met één klik uit.

Wat kun je vragen?

Stel je vraag gewoon in gewone taal. Een paar voorbeelden die met een read-only koppeling werken:

  • Welke facturen staan nog open, en hoeveel staat er in totaal open?
  • Laat alles zien wat we dit jaar aan Jansen BV hebben gefactureerd.
  • Welke klanten hebben een actief abonnement, en wat brengt dat per maand op?
  • Wat kost ons hostingpakket?
  • Zoek het e-mailadres en de betalingstermijn van klant Bakkerij De Vries.

Sta je wijzigingen toe, dan kan de AI ook het routinewerk doen:

  • Maak een conceptfactuur voor Jansen BV met tien uur advies en laat me de regels zien.
  • Stuur een betalingsherinnering voor elke factuur die langer dan 30 dagen openstaat.
  • Factuur 2026-0142 is vandaag betaald, zet hem op betaald.
  • Verhoog de prijs van het abonnement van Bakkerij De Vries naar 45 euro per maand.

De AI kiest zelf welke tools hij nodig heeft. Deze tools lezen, en werken altijd:

  • list_debtors en get_debtor: zoek klanten op naam, bedrijf of debiteurnummer, en bekijk hun contactgegevens, adres en betalingstermijn.
  • list_invoices en get_invoice: bekijk facturen met het betaalde en het openstaande bedrag, en een volledige factuur regel voor regel.
  • list_products: bekijk je producten en hun prijzen.
  • list_subscriptions: zie welke klanten een abonnement hebben en wat het factureert.

Deze tools wijzigen iets, en werken alleen als je hun groep of de losse tool hebt aangevinkt:

  • Aanmaken en wijzigen: create_debtor, update_debtor, create_invoice, update_invoice, create_product, update_product, create_subscription en update_subscription.
  • Versturen naar klanten: send_invoice, per e-mail of via Peppol, en send_invoice_reminder.
  • Betalingen: register_invoice_payment, mark_invoice_paid en mark_invoice_unpaid.
  • Verwijderen en stopzetten: delete_invoice, credit_invoice en terminate_subscription.

Een factuur die de AI maakt, is altijd eerst een concept: er gaat niets naar een klant tot je hem laat versturen. Versturen kun je niet terugdraaien, dus de server vraagt je AI-assistent om je de factuur eerst te laten zien en om bevestiging te vragen. Tools die iets verwijderen of versturen, zijn daarvoor ook gemarkeerd, zodat je assistent je om toestemming vraagt.

Je key en je data

Je geeft ons de sleutel tot je facturatie, dus dit is wat we ermee doen:

  • Je key: we versleutelen hem met AES-256 voordat we hem opslaan. Je AI ziet hem nooit, en met Ontkoppelen verwijder je hem direct.
  • Je data: elk antwoord halen we live op uit WeFact en sturen we direct door naar je AI-assistent. We bewaren geen kopie, delen het met niemand en geen enkel AI-model traint erop.
  • Zelf draaien: draai de server op je eigen computer, dan komen je API key en je data nooit langs onze servers.

Op de beveiligingspagina lees je hoe we dat precies doen, en welke bedrijven ons helpen de dienst te draaien.

Liever op je eigen computer?

De WeFact-server draait ook op je eigen computer, met één npx-commando en een eenmalige licentie. Je zet de API key in de omgevingsvariabele WEFACT_API_KEY en je licentiesleutel in MCPHOSTED_LICENSE_KEY, en start de server met:

npx -y mcphosted wefact

Zet dan het publieke IP-adres van je eigen computer op de whitelist in WeFact, in plaats van het onze. De server is ook daar read-only. Wil je dat de AI iets wijzigt, zet dan de groepen die hij mag gebruiken in MCPHOSTED_PERMISSIONS, gescheiden door komma's: create, send, payments of delete. Losse tools, zoals mark_invoice_paid, werken ook.

Op de instellingenpagina van WeFact in je dashboard staan de stappen en de volledige configuratie voor je AI-assistent. Bij het starten controleert de server je licentie eenmalig bij onze betaalprovider. Je API key en je data komen nooit langs onze servers.

Als het niet werkt

  • WeFact zegt dat er geen toegang is tot de API: ons IP-adres staat niet op de whitelist. Zet het erop in WeFact onder Instellingen en daarna API. Draai je de server op je eigen computer, zet dan het publieke IP-adres van die computer erop.
  • De koppeling mag deze tool niet gebruiken, dus er is niets gewijzigd: je hebt de groep van die tool niet aangevinkt. Klik op Bewerken naast de koppeling en vink de groep aan, of open de groep om alleen die tool toe te staan.
  • De tools verschijnen niet in je assistent: controleer of je de connector in het gesprek hebt aangezet en of je bent ingelogd bij MCP Hosted.

Meer fouten en oplossingen staan op de pagina Problemen oplossen. Wil je meer weten over wat de koppeling kan, kijk dan op de pagina over de WeFact MCP-server. Gebruik je naast WeFact ook een boekhoudpakket, lees dan hoe je met je boekhouding praat via AI.

Veelgestelde vragen

WeFact heeft sinds april 2026 een AI-chatbot achter de knop HELP. Die beantwoordt vragen over het gebruik van WeFact, maar kijkt niet mee in je administratie. Bij onze laatste controle, in oktober 2026, bood WeFact zelf geen MCP-server en geen koppeling met ChatGPT of Claude aan. MCP Hosted is een onafhankelijke dienst die werkt via de openbare API van WeFact, en is niet verbonden aan WeFact.

Alleen wat jij toestaat. Elke koppeling is read-only tot je aanvinkt wat hij mag wijzigen: aanmaken en wijzigen, versturen naar klanten, betalingen, of verwijderen en stopzetten, of losse acties daarbinnen. Een WeFact API key kan niet beperkt worden, dus onze server dwingt je keuze af: hij weigert elke wijziging die je niet toestond voordat er iets bij WeFact aankomt.

WeFact beantwoordt alleen API-verzoeken van IP-adressen die op de whitelist van je account staan. Onze server praat met WeFact vanaf één vast IP-adres, dat je ziet op de instellingenpagina van WeFact in je dashboard. Staat het er niet op, dan zegt WeFact dat er geen toegang is tot de API.

Alleen je API key, versleuteld met AES-256. Facturen en klantgegevens halen we live op als je AI erom vraagt, sturen we direct door en slaan we nooit op. We delen ze met niemand en er traint geen AI-model op. De key komt nooit in logs terecht en je AI krijgt hem nooit te zien.

Ja. Je maakt per administratie een koppeling met de API key van die administratie. Elke koppeling krijgt een eigen URL en eigen rechten, zodat je ze naast elkaar in één AI-assistent kunt gebruiken.

Koppel WeFact

Plak je key, voeg één URL toe aan je AI-assistent en stel je eerste vraag.

Aan de slag