Connexion IA (MCP)

Avec le Model Context Protocol, un assistant IA comme Claude ou ChatGPT travaille avec les données d'une association. L'utilisateur se connecte à Ledenboek, et l'assistant ne voit ensuite pas plus que ce que cet utilisateur voit dans l'application.

L'adresse du connecteur :

URL

https://ledenboek.nl/mcp

Connecter dans Claude

Dans Claude, ouvrez les paramètres et allez à Connecteurs.
Choisissez Ajouter un connecteur personnalisé, nommez-le Ledenboek et saisissez l'adresse ci-dessus.
Cliquez sur Connecter. Vous arrivez sur la page de connexion de Ledenboek.
Connectez-vous ou créez un compte, puis choisissez l'association pour laquelle l'assistant peut travailler.

Ensuite, posez vos questions en langage courant, par exemple « quels membres n'ont pas encore payé leur cotisation ? ».

Connecter dans ChatGPT

Dans les paramètres de ChatGPT, sous Applications et connecteurs, activez le mode développeur (dans les paramètres avancés).
Créez un nouveau connecteur avec l'adresse ci-dessus et choisissez OAuth comme authentification.
Connectez-vous à Ledenboek et choisissez l'association.

Les menus de Claude et de ChatGPT changent régulièrement. Si vous voyez un autre nom, cherchez Connecteurs ou MCP dans les paramètres.

Ce que l'assistant peut faire

L'assistant travaille avec les droits de l'utilisateur connecté, au sein d'une association. Un trésorier voit les finances, un membre ordinaire non.
Un outil pour un module que l'association n'a pas activé n'apparaît pas.
Les outils qui modifient quelque chose sont signalés comme tels. Claude et ChatGPT demandent alors une confirmation à chaque appel.
L'utilisateur voit les assistants connectés sur son profil dans Ledenboek et peut les y révoquer.

OAuth

Pour qui construit son propre client MCP :

Flux authorization code avec PKCE (S256 obligatoire). Les jetons ont le scope mcp.
Un client s'enregistre lui-même avec POST https://ledenboek.nl/oauth/register (Dynamic Client Registration).
Les métadonnées se trouvent à /.well-known/oauth-authorization-server et /.well-known/oauth-protected-resource.
Un jeton d'accès est valable une heure ; renouvelez-le ensuite avec le jeton de rafraîchissement. Un jeton appartient à un utilisateur et à une association.

API ou MCP ?

MCP s'adresse à une personne qui travaille avec un assistant. Pour une intégration entre deux systèmes sans personne entre les deux, par exemple un site qui transmet les nouveaux membres, utilisez l'API avec sa propre clé.

Outils

Cette liste provient directement du code du connecteur. Les descriptions sont les textes que l'assistant lit lui-même.

Les descriptions sont en néerlandais : c'est ainsi qu'elles figurent dans le connecteur et que l'assistant les lit.

Outil	Description
`abonnement_status` lit	Abonnement 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` lit	Toont het huidige bestuur: wie welke rol heeft en sinds wanneer.
`commissie_overzicht` lit	Toont alle commissies en hun huidige leden.
`contributie_instellen` modifie	Configurer les cotisations 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` lit	Toont declaraties met indiener, omschrijving, bedrag en status: ingediend (te beoordelen), goedgekeurd, uitbetaald of geweigerd. Met een telling en totaalbedrag per status.
`evenementen_overzicht` lit	Toont aankomende evenementen met datum, locatie en aantal inschrijvingen.
`financieel_overzicht` lit	Toont het financieel overzicht voor een jaar: inkomsten, uitgaven, resultaat, en maandoverzicht.
`groepen_overzicht` lit	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` lit	Configuration : état actuel 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` lit	Toont ledenaantal per status, nieuwe leden dit jaar, en opzeggers dit jaar.
`leden_toevoegen` modifie	Ajouter des membres 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` lit	Haal alle details op van een specifiek lid: contactgegevens, adres, rollen, commissies, en betalingsstatus.
`nieuwsbrieven` lit	Toont nieuwsbrieven en mailings: onderwerp, doelgroep, status (concept, verzenden of verzonden), verzenddatum, aantal ontvangers en aantal verzonden.
`onderdelen_instellen` modifie	Configurer les modules 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` lit	Toont een overzicht van openstaande facturen: aantal, totaalbedrag, en per lid.
`plekken_overzicht` lit	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` lit	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` lit	Analyseer transacties per label/categorie: totaal, aantal, gemiddelde, maandoverzicht, en top tegenpartijen. Zonder label_naam: overzicht van alle labels.
`transactie_details` lit	Toont volledige details van een banktransactie: bedrag, omschrijving, tegenpartij, labels, opmerkingen, gekoppeld lid, factuur en sub-transacties.
`transactie_labels` lit	Overzicht van alle transactielabels met categorie, kleur, budgetinfo en transactieaantallen.
`vereniging_info` lit	Toont basisinformatie over de vereniging: naam, website, aantal leden, en beschikbare functies.
`vereniging_instellen` modifie	Configurer l'association 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` lit	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` lit	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` lit	Zoek leden op naam, email, of status. Geeft een lijst met naam, email, lidnummer, status en lid_sinds.
`zoek_transacties` lit	Zoek en filter banktransacties op omschrijving, tegenpartij, type, label, periode, en meer. Geeft een lijst met datum, bedrag, omschrijving, tegenpartij en labels.