Met AI-koppelingen (MCP) kun je AI-tools zoals ChatGPT, Cursor, Mistral of Claude verbinden met Moneybird. Zo kan je AI-taken uitvoeren in je administratie, zoals facturen maken of gegevens controleren. Let op: gebruik en configuratie van de koppeling zijn je eigen verantwoordelijkheid.

Opzetten van de AI-koppeling in de AI-tool

Hoe de koppeling precies werkt, is voor elke tool anders. Ook ondersteunen sommige tools dit (nog) niet, of alleen buiten Europa. Vaak heb je voor het gebruik van deze functionaliteit een betaald abonnement nodig van de AI-tool. Wij bieden twee manieren van authenticatie aan voor onze MCP. De meeste clients ondersteunen de OAuth flow die we nu aanbieden. Het blijft wel mogelijk om voor een custom connectie een API-token mee te geven in de header.

Voor het opzetten van de koppeling bieden we twee varianten aan: read-only en read-write. Met de read-only variant is het alleen mogelijk om data uit te lezen uit je administratie, de AI koppeling kan dan geen aanpassingen maken aan je gegevens. Met de read-write variant is dit wel mogelijk. Het kiezen van de variant doe je tijdens het configureren. We ondersteunen geen verwijder acties in de read-write variant.

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. Voor het configureren van de Moneybird AI-koppeling doorloop je de volgende stappen:

Klik in ChatGPT linksonder op je naam en ga naar Instellingen
Ga naar 'Apps & connectoren'
Ga naar 'Geavanceerde instellingen' en schakel 'Ontwikkelaarsmodus' in
Ga terug en klik rechtsboven op 'Maken'
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? Vervangen 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.

Risico's

De AI-tools en hoe deze geconfigureerd en gebruikt moeten worden, zijn aan verandering onderhevig. Net zoals bij onze API geldt ook voor de AI-koppeling dat jij als gebruiker bepaalt hoe je deze inzet. Het gebruik van AI kan risico’s met zich meebrengen, bijvoorbeeld dat een AI-tool de gegevens die jij opvraagt ook op een andere manier gebruikt. Via de koppeling is het bovendien mogelijk om gegevens in je Moneybird-administratie aan te maken of aan te passen. We raden je daarom aan hier zorgvuldig mee om te gaan en goed af te wegen wat je deelt.

Onze ondersteuning beperkt zich tot het aanmaken van de token in Moneybird; het instellen en gebruiken van de koppeling in je AI-tool is je eigen verantwoordelijkheid. Het is mogelijk om onze Moneybird MCP te koppelen met andere AI-tools, maar we kunnen niet garanderen dat deze koppelingen altijd werken.