KI-Anbindung (MCP)

Mit dem Model Context Protocol arbeitet ein KI-Assistent wie Claude oder ChatGPT mit den Daten eines Vereins. Der Benutzer meldet sich bei Ledenboek an, und der Assistent sieht danach nicht mehr, als dieser Benutzer in der App sieht.

Die Adresse des Connectors:

URL

https://ledenboek.nl/mcp

Verbinden in Claude

Öffnen Sie in Claude die Einstellungen und gehen Sie zu Connectors.
Wählen Sie Benutzerdefinierten Connector hinzufügen, nennen Sie ihn Ledenboek und tragen Sie die Adresse oben ein.
Klicken Sie auf Verbinden. Sie landen auf der Anmeldeseite von Ledenboek.
Melden Sie sich an oder erstellen Sie ein Konto, und wählen Sie, für welchen Verein der Assistent arbeiten darf.

Danach stellen Sie Fragen in normaler Sprache, etwa „welche Mitglieder haben ihren Beitrag noch nicht bezahlt?“.

Verbinden in ChatGPT

Schalten Sie in den Einstellungen von ChatGPT unter Apps und Connectors den Entwicklermodus ein (in den erweiterten Einstellungen).
Erstellen Sie einen neuen Connector mit der Adresse oben und wählen Sie OAuth als Authentifizierung.
Melden Sie sich bei Ledenboek an und wählen Sie den Verein.

Die Menüs von Claude und ChatGPT ändern sich regelmäßig. Sehen Sie einen anderen Namen, suchen Sie in den Einstellungen nach Connectors oder MCP.

Was der Assistent darf

Der Assistent arbeitet mit den Rechten des angemeldeten Benutzers, innerhalb eines Vereins. Ein Kassenwart sieht die Finanzen, ein normales Mitglied nicht.
Ein Tool für ein Modul, das der Verein nicht aktiviert hat, erscheint nicht.
Tools, die etwas ändern, sind als solche gekennzeichnet. Claude und ChatGPT fragen dann bei jedem Aufruf nach einer Bestätigung.
Der Benutzer sieht die verbundenen Assistenten in seinem Profil in Ledenboek und kann sie dort widerrufen.

OAuth

Für alle, die selbst einen MCP-Client bauen:

Authorization-Code-Flow mit PKCE (S256 Pflicht). Tokens haben den Scope mcp.
Ein Client registriert sich selbst mit POST https://ledenboek.nl/oauth/register (Dynamic Client Registration).
Die Metadaten stehen unter /.well-known/oauth-authorization-server und /.well-known/oauth-protected-resource.
Ein Access Token ist eine Stunde gültig; danach erneuern Sie es mit dem Refresh Token. Ein Token gehört zu einem Benutzer und einem Verein.

API oder MCP?

MCP ist für einen Menschen, der zusammen mit einem Assistenten arbeitet. Für eine Anbindung zwischen zwei Systemen ohne jemanden dazwischen, etwa eine Website, die neue Mitglieder weiterleitet, verwenden Sie die API mit einem eigenen Schlüssel.

Tools

Diese Liste kommt direkt aus dem Code des Connectors. Die Beschreibungen sind die Texte, die der Assistent selbst liest.

Die Beschreibungen sind auf Niederländisch: So stehen sie im Connector, und so liest der Assistent sie.

Tool	Beschreibung
`abonnement_status` liest	Abonnement bei Ledenboek Toont het abonnement van de vereniging bij Ledenboek: plan, status, proefperiode tot wanneer en hoeveel dagen nog, of er betaald moet worden om de toegang te houden, en de link naar de abonnementspagina. Deze tool betaalt niets; toon de link zodat de bestuurder daar zelf een plan kiest en afrekent.
`bestuur_overzicht` liest	Toont het huidige bestuur: wie welke rol heeft en sinds wanneer.
`commissie_overzicht` liest	Toont alle commissies en hun huidige leden.
`contributie_instellen` ändert	Beiträge einrichten Maakt een contributie (lidmaatschapsproduct) aan of wijzigt er een: naam, bedrag, termijn (annual, semi_annual, quarterly, monthly) en of het de standaardcontributie is. Met id of een bestaande naam wordt die contributie gewijzigd, anders komt er een nieuwe bij. Verwijderen kan hier niet. Leden koppelen en factureren gaat daarna in de app.
`declaraties` liest	Toont declaraties met indiener, omschrijving, bedrag en status: ingediend (te beoordelen), goedgekeurd, uitbetaald of geweigerd. Met een telling en totaalbedrag per status.
`evenementen_overzicht` liest	Toont aankomende evenementen met datum, locatie en aantal inschrijvingen.
`financieel_overzicht` liest	Toont het financieel overzicht voor een jaar: inkomsten, uitgaven, resultaat, en maandoverzicht.
`groepen_overzicht` liest	Toont de groepen en lessen met dag, tijd, locatie en aantal leden. Met inclusief_leden of een groepsnaam ook de leden van de groep.
`inrichting_status` liest	Einrichtung: aktueller Stand Laat zien hoe ver de vereniging is met inrichten en wat de logische volgende stap is: aantal leden, contributie ingesteld, betaalmethode (Mollie of incasso), leden aan een contributie gekoppeld, eerste factuur, aanmeldformulier, welke onderdelen aan staan en de proefperiode of het abonnement. Met per stap een link naar het scherm in de app. Gebruik dit als eerste bij het inrichten van een nieuwe vereniging.
`leden_statistieken` liest	Toont ledenaantal per status, nieuwe leden dit jaar, en opzeggers dit jaar.
`leden_toevoegen` ändert	Mitglieder hinzufügen Voegt leden toe aan de vereniging, maximaal 200 per aanroep. Per lid: voornaam, achternaam (verplicht), email, telefoon, straat, huisnummer, postcode, plaats, land, geboortedatum en lid_sinds (JJJJ-MM-DD). Een lid met een e-mailadres dat al bij de vereniging bekend is wordt overgeslagen. De leden krijgen geen mail. Let op: de ledengegevens lopen hierbij via de AI-dienst. Voor een groot bestand of als de gegevens niet via de AI-dienst mogen, is het importscherm in Ledenboek de route (de link staat in het antwoord). Geeft terug hoeveel leden zijn toegevoegd en welke zijn overgeslagen, met reden.
`lid_details` liest	Haal alle details op van een specifiek lid: contactgegevens, adres, rollen, commissies, en betalingsstatus.
`nieuwsbrieven` liest	Toont nieuwsbrieven en mailings: onderwerp, doelgroep, status (concept, verzenden of verzonden), verzenddatum, aantal ontvangers en aantal verzonden.
`onderdelen_instellen` ändert	Module einstellen Zet onderdelen van Ledenboek aan of uit, zoals onder Instellingen > Onderdelen. Beschikbare onderdelen: has_groepen, has_deelnemers, has_relaties, has_wachtlijsten, has_lidkaart, has_commissies, has_evenementen, has_ledenevenementen, has_agenda, has_voordelen, has_advertenties, has_contributies, has_kascommissie, has_grootboek, winkel_actief, has_tijdschrift, has_meldingen, has_stemmingen, has_eenheden, has_objecten, has_werkuren, has_fondsen, has_mjop, has_klussen, has_contracten, has_dossiers, has_documenten. Optioneel een sjabloon per soort vereniging (haven, volkstuin, harmonie, kynologie, manege, sportclub, vve): dat zet voorbeeldsoorten plekken, objecten en werkuren neer met de bijbehorende onderdelen; wat er al staat blijft staan. Zonder argumenten toont de tool welke onderdelen nu aan staan. Uitzetten verwijdert geen gegevens, het onderdeel verdwijnt alleen uit het menu.
`openstaande_facturen` liest	Toont een overzicht van openstaande facturen: aantal, totaalbedrag, en per lid.
`plekken_overzicht` liest	Toont de plekken (tuinen, ligplaatsen, stallen en andere eenheden) per soort: hoeveel vrij, verhuurd, verkocht of geboekt, en per plek de huurder of eigenaar en sinds wanneer.
`reserveringen` liest	Toont reserveringen van plekken en ruimtes in een periode: welke plek, wie, van wanneer tot wanneer, status, bedrag en of er betaald is. Standaard de komende 30 dagen.
`transactie_analyse` liest	Analyseer transacties per label/categorie: totaal, aantal, gemiddelde, maandoverzicht, en top tegenpartijen. Zonder label_naam: overzicht van alle labels.
`transactie_details` liest	Toont volledige details van een banktransactie: bedrag, omschrijving, tegenpartij, labels, opmerkingen, gekoppeld lid, factuur en sub-transacties.
`transactie_labels` liest	Overzicht van alle transactielabels met categorie, kleur, budgetinfo en transactieaantallen.
`vereniging_info` liest	Toont basisinformatie over de vereniging: naam, website, aantal leden, en beschikbare functies.
`vereniging_instellen` ändert	Verein einrichten Wijzigt de basisgegevens van de vereniging: naam, beschrijving, website en de twee huisstijlkleuren (hexcode zoals #1E40AF). Geef alleen de velden mee die moeten veranderen. Sleutels, maildomein, betaalkoppelingen en land zijn hier niet te wijzigen; die staan op het instellingenscherm.
`wachtlijsten` liest	Toont de wachtlijsten met per lijst het aantal wachtenden en de volgorde: plek in de rij, naam, ingeschreven sinds, status en een eventueel aangeboden plek.
`werkuren` liest	Toont de werkuren per jaar (werkbeurten, tuindiensten, bardiensten): per verplichting het aantal verplichte uren, en per lid gemaakt en tekort. Optioneel alleen de leden die achterlopen.
`zoek_leden` liest	Zoek leden op naam, email, of status. Geeft een lijst met naam, email, lidnummer, status en lid_sinds.
`zoek_transacties` liest	Zoek en filter banktransacties op omschrijving, tegenpartij, type, label, periode, en meer. Geeft een lijst met datum, bedrag, omschrijving, tegenpartij en labels.