mcp-vereinonline
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-vereinonline
MCP-Server für VereinOnline, die Vereinssoftware. Er stellt die dokumentierte JSON-API von VereinOnline als MCP-Tools bereit, lokal per stdio. Der Server speichert nichts und hat keinen eigenen Cache über einen einzelnen Aufruf hinaus.
Status
Nach Dokumentation implementiert, nicht live verifiziert. Grundlage ist die öffentliche API-Dokumentation unter https://www.vereinonline.org/api. Die Tests prüfen Konfiguration, Freigaben und Aufrufe gegen eine simulierte API. Sie sagen nichts über die Antworten eines echten Vereins. Die Parameterformate sind bis zum ersten Test gegen einen echten Verein unbestätigt.
Bekannte Einschränkungen:
Zweites
GetListin der Doku ungeklärt. Die Doku nenntGetListzweimal mit identischer Beschreibung. Der zweite Eintrag steht unter einer abgeschnittenen Überschrift, sodass unklar ist, welche Funktion gemeint ist. Umgesetzt ist nur der erste, benannte Eintrag.Kontakte nur als "analog" dokumentiert.
GetContacts,GetContactundCreateContactsind in der Doku nur als "analog" zu den Mitglieder-Funktionen beschrieben. Es ist eine Annahme, dass sie dieselben Parameter wie die Mitglieder-Funktionen verwenden.UpdateContactundDeleteContactgibt es nicht, weil die Doku sie nicht beschreibt.Mailversand weiterer Funktionen unbekannt. Ob
CreateMember,CreateRegistrationundCreateSubscriberbeim Anlegen eine E-Mail versenden, ist nicht dokumentiert. Die Tool-Beschreibungen tragen deshalb den Hinweis "May send e-mail (unverified)."ChangeRegistrationmitmail: "1"ist dagegen abgesichert (siehe Abschnitt Klassen).Paginierung nur clientseitig. Die API paginiert nur
GetEvents(überlimit). Bei allen anderen Listen holt der Server alles und kürzt danach (siehe Abschnitt Antwortgröße).dataidbeiUpdateListDataist eine Annahme. Die Doku nennt die Datensatz-ID nur als "data id". Der Server verwendetdataid, weilGetListsie als_dataidzurückliefert.Parameterformate insgesamt unbestätigt, bis ein erster Test gegen einen echten Verein läuft. Das betrifft etwa Datumsformate, die
Beitrags-IDbeiDeleteMemberUserfees(vermutlich die ID der Zuordnung) und die Feldnamen indaten.Doku-Tippfehler. Im Abschnitt "Erstellen einer Rechnung/Buchung" nennt die Doku den Methodennamen fälschlich
GetInvoice. Die Überschrift und das Beispiel nennenCreateInvoice, und so ist sie umgesetzt. Ebenso nennt die Doku bei der Platzbuchung die Überschrift "DeletePlaceBooking", den Methodennamen aberDeletePlaceBookings.
Related MCP server: xmatters-mcp
Einrichtung
Voraussetzung ist Node.js 18 oder neuer. Es gibt zwei Wege, den Server einzubinden:
Direkt aus GitHub, ohne lokalen Klon (siehe nächster Abschnitt):
npxlädt den Server beim Start aus diesem Repository und baut ihn selbst.Lokaler Klon: Den Server baut man einmal mit
npm installundnpm run build. Danach zeigt man im MCP-Client aufdist/index.js. Die Beispiele weiter unten verwenden diesen Weg.
Direkt aus GitHub (npx)
Im MCP-Client steht statt des Pfads zu dist/index.js der Befehl npx mit der GitHub-Adresse. Beispiel für Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"vereinonline": {
"command": "npx",
"args": ["-y", "github:simonfieberIT/mcp-vereinonline"],
"env": {
"VEREINONLINE_URL": "https://www.vereinonline.org/IHRVEREIN/",
"VEREINONLINE_USER": "api-benutzer",
"VEREINONLINE_PASSWORD": "<Passwort des API-Benutzers>"
}
}
}
}Für Claude Code:
claude mcp add vereinonline \
-e VEREINONLINE_URL=https://www.vereinonline.org/IHRVEREIN/ \
-e VEREINONLINE_USER=api-benutzer \
-e VEREINONLINE_PASSWORD='<Passwort des API-Benutzers>' \
-- npx -y github:simonfieberIT/mcp-vereinonlineDie Umgebungsvariablen sind dieselben wie beim lokalen Klon, auch die Profildatei für mehrere Vereine funktioniert so.
Was dabei zu beachten ist:
Erster Start: Beim ersten Aufruf lädt npm das Repository, installiert die Abhängigkeiten und führt das Skript
prepareaus, das den Server baut. Mit leerem npm-Cache dauerte das in Tests 13 bis 19 Sekunden, ein weiterer Start aus dem Cache etwa 2 bis 3 Sekunden. In dieser Zeit antwortet der Server noch nicht. Ein MCP-Client mit kurzem Verbindungs-Timeout kann den ersten Versuch abbrechen. Ein zweiter Start funktioniert dann aus dem Cache.Aktualisieren: npm legt Pakete aus Git im Cache ab. Ob
npxbei jedem Start automatisch den neuesten Stand vonmainholt, ist nicht getestet. Wenn nach einem neuen Push noch der alte Stand läuft, hilft es, den npx-Cache zu leeren (rm -rf ~/.npm/_npx) und den Client neu zu starten.Fester Stand: Mit
github:simonfieberIT/mcp-vereinonline#<Tag oder Commit>läuft immer genau dieser Stand. Er muss das Skriptprepareinpackage.jsonenthalten, ältere Commits lassen sich so nicht starten.Sicherheit: Beim Einbinden von
mainläuft jeder neue Push ungeprüft mit Zugriff auf die Zugangsdaten und damit auf die Mitgliederdaten. Für den produktiven Einsatz ist ein fester Tag oder Commit sicherer.
Claude Desktop (eine Vereinsanbindung)
In claude_desktop_config.json:
{
"mcpServers": {
"vereinonline": {
"command": "node",
"args": ["/absoluter/Pfad/mcp-vereinonline/dist/index.js"],
"env": {
"VEREINONLINE_URL": "https://www.vereinonline.org/IHRVEREIN/",
"VEREINONLINE_USER": "api-benutzer",
"VEREINONLINE_PASSWORD": "<Passwort des API-Benutzers>"
}
}
}
}Den Platzhalter <Passwort des API-Benutzers> ersetzt man durch den echten Wert. Die Datei enthält dann das Passwort im Klartext. Der Zugriff auf die Datei sollte deshalb eingeschränkt sein.
Claude Code (eine Vereinsanbindung)
claude mcp add vereinonline \
-e VEREINONLINE_URL=https://www.vereinonline.org/IHRVEREIN/ \
-e VEREINONLINE_USER=api-benutzer \
-e VEREINONLINE_PASSWORD='<Passwort des API-Benutzers>' \
-- node /absoluter/Pfad/mcp-vereinonline/dist/index.jsMehrere Vereine (Profildatei)
Bei mehreren Vereinen zeigt VEREINONLINE_PROFILES auf eine JSON-Datei. Die Passwörter kommen dann aus Umgebungsvariablen, die über passwordEnv benannt werden, und stehen nicht in der Datei.
/absoluter/Pfad/vereine.json:
{
"profiles": {
"mein-verein": {
"url": "https://www.vereinonline.org/IHRVEREIN/",
"user": "api-benutzer",
"passwordEnv": "VO_PASSWORT_MEIN_VEREIN"
},
"zweiter-verein": {
"url": "https://www.vereinonline.org/ANDERERVEREIN/",
"user": "api-benutzer-2",
"passwordEnv": "VO_PASSWORT_ZWEITER_VEREIN"
}
}
}Claude Desktop, mit der Profildatei:
{
"mcpServers": {
"vereinonline": {
"command": "node",
"args": ["/absoluter/Pfad/mcp-vereinonline/dist/index.js"],
"env": {
"VEREINONLINE_PROFILES": "/absoluter/Pfad/vereine.json",
"VO_PASSWORT_MEIN_VEREIN": "<Passwort Verein 1>",
"VO_PASSWORT_ZWEITER_VEREIN": "<Passwort Verein 2>"
}
}
}
}Die Werte rechts sind Platzhalter. Dort gehören die echten Passwörter hin (Claude Desktop ersetzt keine Variablen wie ${...}). Die Variablen müssen im env-Block des Servers stehen, weil passwordEnv in der Umgebung des Serverprozesses nachschlägt.
Bei mehreren Profilen bekommt jedes Tool, auch vo_raw, einen Pflichtparameter verein mit den Profilnamen als erlaubten Werten, z. B. "verein": "mein-verein".
Profile können auch "password": "..." statt passwordEnv enthalten. Das wird vom Code akzeptiert, speichert das Passwort aber im Klartext in der Datei. passwordEnv ist deshalb vorzuziehen.
Zwischen VEREINONLINE_URL und VEREINONLINE_PROFILES wählt man genau eins. Sind beide gesetzt, bricht der Server ab. Bei einer Profildatei werden VEREINONLINE_USER und VEREINONLINE_PASSWORD nicht gelesen.
Umgebungsvariablen
Variable | Pflicht | Bedeutung |
| ja, wenn keine Profildatei | Adresse der API des Vereins, z. B. |
| ja, zusammen mit | Login des API-Benutzers. |
| ja, zusammen mit | Passwort des API-Benutzers. |
| ja, wenn keine URL | Pfad zu einer Profildatei für einen oder mehrere Vereine. Nicht zusammen mit |
| nein | Welche Toolsets aktiv sind. Ohne Angabe: alle außer |
| nein |
|
| nein | Wie oben, für Lösch-Tools. |
| nein | Wie oben, für Versand-Tools ( |
Das gilt für VEREINONLINE_URL und für jede url in der Profildatei: Eine andere Adresse (auch eine nicht lesbare) lässt den Server beim Start abbrechen, die Meldung nennt das Profil. Der Grund: Der Token (Benutzer und MD5 des Passworts) darf nicht unverschlüsselt über das Netz gehen. Der Server prüft die Adresse zusätzlich bei jedem Aufruf und lehnt Weiterleitungen (Redirects) ab, statt ihnen zu folgen. Ein Redirect erscheint als allgemeiner Netzwerkfehler.
Fehlt eine Pflichtangabe oder ist die Konfiguration widersprüchlich, beendet sich der Server mit Exit-Code 1. Die Meldung geht auf stderr, stdout bleibt leer. Die Meldung nennt Variablen, aber keine Werte.
Toolsets
VereinOnline hat 47 umgesetzte Funktionen. Sie sind in 13 Toolsets gruppiert. Die Tool-Namen entstehen aus dem API-Namen in snake_case mit dem Präfix vo_. Die Klasse steht in Klammern: read, write, delete oder send. "Liste" markiert Funktionen, deren Ergebnis über maxResults gekürzt werden kann.
Toolset | Standard | Tools (Klasse) |
| an |
|
| an |
|
| an |
|
| an |
|
| an |
|
| an |
|
| an |
|
| an |
|
| an |
|
| an |
|
| an |
|
| an |
|
| aus |
|
Zusammen sind das 47 Funktionen: 27 read, 15 write, 4 delete, 1 send.
Anzahl der Tools in der Toolliste, jeweils einschließlich vo_raw: 26 in der Standardkonfiguration (12 Toolsets, kein Schalter gesetzt), 48 mit allen 13 Toolsets und allen drei Schaltern (47 Funktionen plus vo_raw).
Die Toolsets members und contacts nutzen dieselben Parameter (GetContacts und CreateContact sind in der Doku nur als "analog" beschrieben). Das ist unter "Status" beschrieben.
Klassen und Freigaben
Jede Funktion gehört zu einer Klasse. Daraus ergibt sich, was der Server freigibt.
Klasse | Funktionen | Freigabe | Zusätzlich pro Aufruf |
| 27 | immer, sofern das Toolset aktiv ist | nichts |
| 15 |
| nichts |
| 4 |
|
|
| 1 ( |
|
|
Standard ist aus. Schreib-, Lösch- und Versand-Tools sind ohne ihren Schalter nicht vorhanden und erscheinen nicht in der Toolliste. Das Toolset
authist ebenfalls standardmäßig aus.confirm. Lösch- und Versand-Tools verlangen den Parameterconfirmmit dem Werttrue. Ohne ihn lehnt der Server den Aufruf ab, bevor er die API erreicht.Mailversand über
vo_change_registration. Mitmail: "1"versendet die Funktion eine Statusmail. Dafür braucht der Aufruf zusätzlichVEREINONLINE_ALLOW_SENDundconfirm: true, auch wennwritefreigegeben ist.Mailversand über andere Tools.
vo_create_member,vo_create_registrationundvo_create_subscriberkönnen laut Tool-Beschreibung eine Mail auslösen. Das ist nicht geprüft, und die Tools haben keine eigene Sperre. Werwritefreigibt, gibt diese Mailfunktion also mit frei.UpdateMemberundUpdateListData.vo_update_memberkann mit einem-vor dem Namen auch Rollen und Gruppen entfernen,vo_update_list_dataüberschreibt vorhandene Daten. Beides gehört zur Klassewriteund hängt damit allein am Schreib-Schalter, ohneconfirm.Freigabe ist nicht die einzige Grenze. Die Rechte, die VereinOnline dem API-Benutzer gibt, gelten weiterhin. Jede Funktion benötigt eine bestimmte API-Benutzerrolle, die in der Tool-Beschreibung steht.
Antwortgröße
Listen-Tools (Spalte "Liste" oben) liefern höchstens maxResults Einträge. Der Standard ist 50, erlaubt sind ganze Zahlen von 1 bis 500. Ein ungültiger Wert fällt beim direkten Aufruf der Funktion auf 50 zurück, im Tool-Schema wird er abgelehnt. Die Antwort hat dann diese Form:
{ "total": 312, "shown": 50, "truncated": true, "items": [ ... ] }Die API liefert die vollständige Liste, und der Server kürzt danach. Die Kürzung spart also Kontext im Gespräch, verringert aber nicht, welche Daten der Server von VereinOnline abruft.
Die einzige Ausnahme ist
vo_get_events. Dort reicht der Parameterlimitan VereinOnline weiter. Der ParametermaxResultskürzt zusätzlich die Ausgabe. Beide sind getrennt.Felder, die die API standardmäßig liefert, bleiben so. Mit
felder(z. B. beivo_get_members) lassen sich weitere Felder anfordern.Kommt eine Liste als JSON-Objekt zurück (Schlüssel sind IDs, alle Werte sind Objekte) und hat sie mehr als
maxResultsEinträge, gilt dieselbe Form:{ "total", "shown", "truncated", "items" }, wobeiitemsdann ein Objekt mit den erstenmaxResultsEinträgen ist.Nicht-Listen-Tools geben das Ergebnis der API unverändert zurück, solange es klein ist.
Größenobergrenze für jede Antwort. Ist das Ergebnis (nach der Kürzung) länger als 100 000 Zeichen als JSON, liefert der Server stattdessen
{ "truncated": true, "totalChars": ..., "note": "...", "preview": "..." }.previewenthält die ersten 20 000 Zeichen. Das betrifft auch Nicht-Listen-Tools wievo_get_member,vo_get_list_viewoder einzelne sehr große Felder (z. B. den HTML-Text eines Newsletters). Dann mitfelder,filterodermaxResultseingrenzen.Bei
vo_rawgilt dasselbe für jede Antwort. Auch bei unbekanntenGet- undCheck-Funktionen werden Arrays und ID-Objekte gekürzt, und zwar über den eigenen ParametermaxResultsvonvo_raw(Standard 50, 1 bis 500).
vo_raw
vo_raw ruft beliebige API-Funktionen über ihren Namen auf. Es ist immer registriert, auch wenn kein Toolset aktiv ist. Das Tool ist für Funktionen gedacht, die noch nicht als eigenes Tool existieren.
Parameter:
function: der API-Name, z. B.GetMembers. Erlaubt sind nur Buchstaben und Ziffern, und der Name beginnt mit einem Buchstaben (^[A-Za-z][A-Za-z0-9]*$).params: ein Objekt für den Request-Body. Bei bekannten Funktionen wird es gegen dieselben Parameter geprüft wie beim Einzel-Tool (Pflichtfelder, Typen,maxResults,daten). Nicht dokumentierte Schlüssel werden abgelehnt, ohne dass die API aufgerufen wird. Bei unbekannten Funktionen geht es unverändert an die API (Steuerschlüssel wieconfirm,verein,maxResultsunddatenwerden entfernt).maxResults(oben, nicht inparams): Kürzung von Listen-Antworten, siehe Abschnitt Antwortgröße.confirm(oben, nicht inparams): Bestätigung für Aufrufe, die sie brauchen.verein: nur bei mehreren Profilen.
Die Regeln lauten:
Bekannte Funktion (Name ohne Beachtung von Groß-/Kleinschreibung, z. B.
getmembers): Es gelten genau die Regeln des Einzel-Tools. Ist das Toolset oder die Klasse nicht freigegeben, lehnt der Server ab. Lösch- und Versand-Funktionen brauchenconfirm: true.Unbekannte Funktion, deren Name mit
GetoderCheckbeginnt (Groß-/Kleinschreibung zählt): Der Aufruf ist als Lesezugriff erlaubt. Solche Funktionen gehören zu keinem Toolset. Die Toolset-Auswahl gilt für sie also nicht.Jede andere unbekannte Funktion: Dafür müssen
VEREINONLINE_ALLOW_WRITE,VEREINONLINE_ALLOW_DELETEundVEREINONLINE_ALLOW_SENDalle gesetzt sein, und der Aufruf brauchtconfirm: true.
Wer VEREINONLINE_TOOLSETS einschränkt, sollte wissen, dass Regel 2 diese Einschränkung für unbekannte Get- und Check-Funktionen aufhebt.
Datenschutz
Mitgliederdaten gehen an den Modellanbieter. Was der Server aus VereinOnline liest, landet als Tool-Ergebnis im Gespräch. Das Gespräch wird an den Anbieter des verwendeten Modells übertragen. Mitgliederdaten sind personenbezogen (DSGVO). Ob und unter welchen Bedingungen das zulässig ist (Rechtsgrundlage, Auftragsverarbeitung, Drittlandübermittlung), hängt vom Einsatz und vom Anbieter ab. Das ist vor dem produktiven Einsatz zu klären.
Passwörter im Gespräch.
vo_verify_loginundvo_check_loginnehmen das Passwort eines Mitglieds als Tool-Argument entgegen. Das Passwort erscheint damit im Gesprächsverlauf und geht damit ebenfalls an den Modellanbieter. Die Beschreibungen beider Tools weisen darauf hin. Deshalb ist das Toolsetauthstandardmäßig aus. Es sollte nur aktiviert werden, wenn es gebraucht wird, und nur für Mitglieder, die dem zugestimmt haben.Zugangsdaten. Der API-Token wird aus Benutzer und MD5 des Passworts gebildet und nur im Authorization-Header an VereinOnline gesendet. Passwort und Token werden aus Fehlermeldungen der API entfernt. Fehler beim Netzwerkzugriff geben nur eine allgemeine Meldung ohne Details aus. Die Konfiguration selbst (Umgebungsvariablen oder Profildatei) enthält aber das Passwort, wenn es dort steht.
Keine eigene Datenhaltung. Der Server schreibt keine Daten auf die Festplatte und hält nichts über einen Aufruf hinaus.
Entwicklung
npm install # Abhängigkeiten installieren
npm run build # TypeScript nach dist/ kompilieren (tsc)
npm test # Tests (vitest run)
npm run dev # Server direkt aus den Quellen starten (tsx src/index.ts), braucht die Umgebungsvariablen
npm start # Gebauten Server starten (node dist/index.js)Die Tests prüfen unter anderem, dass die 47 Funktionen mit Toolset und Klasse aus tests/expected-functions.ts übereinstimmen.
Lizenz
MIT, siehe LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read and write Mission Control state via MCP — projects, tasks, subtasks, templates, status updates.
Monday.com MCP — wraps the Monday.com GraphQL API (BYO API key)
Staff live events: gigs, crew, setlists, call lists, ingest. Hosted MCP with OAuth.
Meetup MCP — wraps Meetup's public GraphQL API (api.meetup.com, free, no auth)
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to interact with the Crewmeister API over local stdio, covering operations for members, teams, time tracking, salary exports, and related platform resources.Apache 2.0
- AlicenseCqualityBmaintenanceEnables MCP clients to interact with the current xMatters REST API over stdio, covering people, devices, groups, on-call schedules, events, incidents, workflows, services, integrations, and subscriptions. It is read-only by default and requires explicit operator opt-in plus per-call confirmation for mutations.179Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to run and track scans, inspect quota usage, redeem existing studio report rights, and list or download generated reports through the associated REST API. It operates locally over stdio with API-key authentication and bounded retry/polling behavior.24 npmApache 2.0
- AlicenseCqualityBmaintenanceEnables MCP clients to inspect and manage Semaphore UI automation through its management API, covering projects, templates, tasks, logs, inventories, repositories, and related configuration. It works over stdio or Streamable HTTP with schema-validated tools, read-only mode, project allowlists, and a bounded task-wait helper.213MIT