Met een AI-koppeling verbind je een AI-tool zoals ChatGPT, Cursor, Mistral of Claude met je administratie. Je stelt dan vragen over je administratie in gewone taal, of je laat de AI-tool iets voor je aanmaken. De koppeling werkt via MCP, een standaard manier om software aan AI-tools te verbinden.

Let op: je bent zelf verantwoordelijk voor de koppelingen die je maakt en voor de manier waarop je ze gebruikt.

Wat kan een AI-koppeling wel en niet?

Een koppeling met alleen lezen haalt gegevens op. Een koppeling met lezen en schrijven kan ook gegevens aanmaken en aanpassen: contacten, producten, projecten, verkoopfacturen, terugkerende facturen, externe verkoopfacturen, offertes, aankoopfacturen, bonnen, memoriaalboekingen, uren en bedrijfsmiddelen.

Elke koppeling kan daarnaast rapporten en vaste gegevens lezen, zoals je balans, winst-en-verliesrekening, omzet per contact, btw-tarieven, categorieën, bankrekeningen en banktransacties.

Deze onderdelen hebben geen AI-koppeling:
Een factuur versturen
Een betaling registreren of koppelen
Je btw-aangifte
Bankkoppelingen en bankimports
Bijlagen bij documenten
De instellingen van je administratie

Verwijderen kan nooit via een AI-koppeling. Elke actie is gemarkeerd als lezen of als wijzigen. Je AI-tool ziet dat verschil en vraagt je bij de meeste tools eerst om toestemming.

De koppeling maken vanuit je AI-tool

Bij de meeste AI-tools begin je in de AI-tool zelf. Je vult daar het adres van de Moneybird MCP in en logt daarna in bij Moneybird. Je hebt dan geen token nodig.

Het laatste deel van het adres bepaalt de rechten:

`https://moneybird.com/mcp/v1/read_only`: de AI-tool mag alleen lezen
`https://moneybird.com/mcp/v1/read_write`: de AI-tool mag ook aanmaken en aanpassen

We adviseren om met alleen lezen te beginnen. Wil je vooral inzicht en overzicht, dan heb je meer niet nodig.

Na het inloggen zie je het toestemmingsscherm. Daar staat welke onderdelen de tool nodig heeft. Je kiest ook de administratie waarvoor de koppeling geldt. Je ziet alleen administraties waarvoor je genoeg rechten hebt. Klik op 'Toestaan' om de koppeling af te ronden.

Let op: Moneybird vraagt zelf nooit op deze manier toegang. Sta het alleen toe als je de tool vertrouwt en als je de koppeling zelf gestart hebt.

De koppeling maken met een token

Ondersteunt je tool de eerste manier niet, of bouw je iets eigen? Dan maak je in Moneybird een token aan:

Ga naar Instellingen > Koppelingen.
Klik bij AI-koppelingen op 'AI-koppeling aanmaken'.
Vul een naam in.
Kies bij Rechten voor 'Alleen lezen' of 'Lezen en schrijven'.
Selecteer bij Toegang tot onderdelen waar de koppeling bij mag: Verkoopfacturen, Offertes, Inkomende documenten, Bank, Uren en Instellingen.
Klik op 'Opslaan'.

Je ziet de token daarna één keer. Bewaar de token goed, want je kunt hem later niet meer opvragen bij Moneybird. Ben je de token kwijt? Maak dan een nieuwe koppeling aan.

Configureren van de AI-koppeling in ChatGPT

Om gebruik te maken van de AI-koppeling in ChatGPT heb je minimaal het ChatGPT Plus abonnement nodig. Doorloop de volgende stappen:

Klik in ChatGPT linksonder op 'Plug-Ins'
Klik daarna op 'Ontwikkelaarsmodus'
Schakel 'Ontwikkelaarsmodus' in
Ga terug en klik rechtsboven op '+'
Voer de naam en URL in. Laat 'Authenticatie' op OAuth staan. In de onderstaande afbeelding maken we gebruik van de read_only variant. Wil je gebruik maken van de read_write variant? Vervang dan "read_only" voor "read_write" in de url.
Vink de checkbox aan en klik vervolgens op 'Maken'.
Je wordt doorgestuurd naar een inlogpagina van Moneybird. Log hier in met je account en kies vervolgens de administratie waarmee je de koppeling wil maken.
Klik op toestaan, je wordt nu teruggestuurd naar ChatGPT en bent klaar om de koppeling te gebruiken.

Configureren van de AI-koppeling in Cursor

Ter illustratie configureren we de AI-koppeling in Cursor:

Open Cursor en ga naar Cursor Settings
Ga naar 'MCP & Integrations'
Voeg een nieuwe MCP server toe, dat doe je door in het lege configuratiebestand de volgende regels te plakken:
```
{ 
  "mcpServers": { 
    "Moneybird": {
      "url": "https://moneybird.com/mcp/v1/read_only"
    }
  }
}
```
In het bovenstaande voorbeeld maken we gebruik van de read_only variant. Wil je gebruik maken van de read_write variant? Vervang dan "read_only" voor "read_write" in de url.
Sla het bestand op en sluit deze, je kan nu via de connect knop bij Moneybird inloggen om cursor te autoriseren.
Je kan nu gebruikmaken van de koppeling door in de chat te communiceren met het model.

Configureren van de AI-koppeling in Claude

Wij raden aan om connectors te gebruiken binnen Claude. Het is echter ook mogelijk om Moneybird MCP via Claude te gebruiken met de volgende instellingen:

Open Claude Desktop
Activeer developer mode in de Instellingen

Ga naar Edit Config. Hiermee open je het configuratie bestand. Plak hierin de onderstaande regels met jouw token, en kies voor de read_write of read_only variant door de url aan te passen.

{
  "mcpServers": {
    "Moneybird": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://moneybird.com/mcp/v1/read_write"
      ]
    }
  }
}

Sla het config bestand op en herstart Claude, je kan nu gebruikmaken van de koppeling door in de chat te communiceren met het model.

Hoe je de koppeling instelt, verschilt per tool en verandert regelmatig. Voor veel AI-tools heb je een betaald abonnement nodig. Sommige tools ondersteunen dit nog niet, of alleen buiten Europa.

Je koppelingen beheren

Al je koppelingen staan bij elkaar in Instellingen > Koppelingen, onder AI-koppelingen. Je ziet daar wie de koppeling heeft gemaakt en wanneer.

Klik op een koppeling. Je ziet dan welke toegang de koppeling heeft, tot welke onderdelen, en op welke datum de toegang is gegeven. Onder 'Recente acties' zie je wat er via de koppeling is gebeurd, met het type en de datum. Klik op een actie om het document of contact te openen. Zo controleer je precies wat de AI-tool in je administratie heeft gedaan.

Wil je stoppen? Trek de toegang in. De AI-tool kan er daarna niet meer bij.

Bij 'Wie mag koppelen' bepaal je of andere gebruikers een koppeling mogen maken. Deze instelling geldt voor externe applicaties en AI-koppelingen. Alle eigenaren van de administratie krijgen een e-mail zodra er een nieuwe koppeling wordt gemaakt.

Meerdere administraties koppelen

Een koppeling geldt altijd voor één Moneybird-administratie. Werk je met meerdere administraties, dan maak je per administratie een aparte koppeling. Of dat lukt, hangt af van je AI-tool.

Bij Claude lukt dat bijvoorbeeld niet. Claude staat per server-URL maar één koppeling toe. Moneybird gebruikt voor alle administraties dezelfde URL. Hierdoor is een aparte koppeling voor een tweede administratie niet mogelijk.

Moneybird CLI

Bouw je zelf een AI-agent of automatisering? Dan is de Moneybird CLI een alternatief voor MCP. Met de CLI roep je Moneybird API-endpoints aan vanuit de terminal en geef je de uitvoer direct door aan een volgend commando of programma. Zo komt alleen de informatie die je nodig hebt in de context van het taalmodel terecht. Dat scheelt tokens en is beter voor de privacy.

Je kunt de output bovendien filteren: geef een AI-agent bijvoorbeeld alleen het factuurnummer en bedrag, zonder omschrijvingen of contactgegevens. De CLI werkt met een read-only API token en ondersteunt alle endpoints uit de Moneybird API.

Risico's

Een AI-tool is van een andere partij. Die partij bepaalt zelf wat er met je gegevens gebeurt. Een AI-tool kan de gegevens die jij opvraagt dus ook op een andere manier gebruiken. Weeg daarom goed af wat je deelt en begin met alleen lezen.

Deze techniek is nog in ontwikkeling. De koppeling werkt daarom niet altijd foutloos. Controleer wat er in je administratie gebeurt, bijvoorbeeld via 'Recente acties'. Laat je een verkoopfactuur aanmaken? Die krijgt de status Concept. Controleer de regels, het btw-tarief en het contact voordat je de factuur verstuurt.

Onze hulp gaat over het maken van de koppeling in Moneybird. Het instellen en gebruiken van de koppeling in je AI-tool doe je zelf. Je kunt onze MCP met andere AI-tools koppelen, maar we kunnen niet garanderen dat die koppelingen altijd werken.