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

Opzetten van de AI-koppeling in Moneybird

Om gebruik te maken van MCP ga je naar Instellingen > Externe Applicaties en AI koppelingen.

Als je vervolgens kiest om een AI-koppeling aan te maken, dan krijg je een scherm met informatie over de werking en de risico's van de koppeling te zien.

Je kiest tot welke onderdelen je de koppeling toegang geeft en hoe je de koppeling noemt. Wanneer je vervolgens op 'Opslaan' klikt, zie je de token die je kan gebruiken voor het maken van de koppeling. Dit is een API-token die zowel voor MCP als API gebruikt kan worden.

De token is vergelijkbaar met een wachtwoord en is slechts eenmalig zichtbaar.

Zodra je de token hebt aangemaakt, is de koppeling zichtbaar in het overzicht. Door op de koppeling te klikken zie je een overzicht van de acties die zijn uitgevoerd met de koppeling.

Opzetten van de AI-koppeling in de AI-tool

Met de token kan je vervolgens aan de slag om de koppeling op te zetten in een AI-tool naar keuze. Hoe dit 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.

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. Op het moment ondersteunen we nog geen verwijder acties in de read-write variant.

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",
      "headers": {
        "Authorization": "Plak hier je token mét 'Bearer' er voor: Bearer wrlq2pXE...."
      }
    }
  }
}
```
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, als je het juist hebt ingevuld zul je zien dat het bolletje groen is en je verbinding hebt.
Je kan nu gebruikmaken van de koppeling door in de chat te communiceren met het model.

Configureren van de AI koppeling in Claude

Wij bieden helaas nog geen support voor Connectors, maar het is al wel mogelijk om Moneybird MCP via Claude te gebruiken door middel van 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",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "JOUW TOKEN"
      }
    }
  }
}

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.