Hilfe & Anleitung

Diese Seite erklärt, wie du das Wahlkampf-Koordinationstool mit einer KI (Claude.ai oder Le Chat) verbindest und nutzt. Wähl oben, ob du Anfänger bist oder dich mit KI-Tools schon auskennst.

Was ist eine KI, und was hat das mit diesem Tool zu tun?

Eine KI (oder „AI", englisch) ist ein Programm, mit dem du dich schreibend unterhalten kannst — zum Beispiel ChatGPT, Claude oder Le Chat von Mistral. Im Kern davon steckt ein Sprachmodell, auf Englisch Large Language Model, kurz LLM. Du „fernsteuerst" es, indem du Anweisungen tippst.

Moderne KIs können nicht nur Text schreiben, sondern auch selbst Zwischenschritte planen und Aktionen ausführen. Damit sie das kann, muss sie Zugriff auf Daten oder Funktionen haben. Dafür gibt es das Model Context Protocol, kurz MCP: ein standardisierter Weg, wie eine KI mit einem Server reden kann.

Dieses Tool ist genau so ein MCP-Server. Wenn du es mit deiner KI verbindest, kann die KI in deinem Namen Events anlegen, Aktionen planen, Teilnahmen eintragen und vieles mehr — und zwar nur so viel, wie du selbst auch darfst.

Brauche ich das überhaupt?

Nein, nicht zwangsläufig. Vieles geht direkt im Browser, ganz ohne KI:

Termine ansehen und zu- oder absagen: auf die Terminliste gehen, klicken, fertig.
Einen eigenen Termin anlegen (z. B. einen Wahlkampfstand): wenn du Mitglied einer Kampagne bist, findest du auf der Terminliste den Knopf „+ Neuer Termin".

Du brauchst die KI-Anbindung, wenn du

bestehende Termine ändern oder löschen willst,
größere Auswertungen oder Exporte machen willst (z. B. Newsletter-Text), oder
einfach lieber mit einer KI sprichst als Formulare auszufüllen.

Helfer ohne Account einladen (öffentlicher Link)

Jeder Termin hat einen öffentlichen Zusage-Link. Den findest du auf der Termin-Seite („Öffentlicher Zusage-Link", zum Kopieren). Wenn du ihn z. B. per WhatsApp teilst, können Leute ohne GitHub-Account einfach ihren Namen eintragen und zusagen. Öffentlich sichtbar ist dabei nur die Anzahl der Zusagen — die Namen siehst nur du als angemeldetes Mitglied auf der Termin-Seite.

Themenseiten zum Verschicken (Sammlungen)

Für eine bestimmte Zielgruppe (z. B. „alle, die sich für die Gemeinde Nordstemmen interessieren") kannst du eine Sammlung anlegen: du wählst gezielt mehrere Kampagnen aus, und daraus entsteht eine öffentliche Seite mit allen kommenden Terminen dieser Kampagnen — abgelaufene fallen automatisch raus. Den Link verschickst du z. B. per WhatsApp; die Leute brauchen keinen Account und können direkt mithelfen.

Anlegen geht per KI: „Erstelle eine Sammlung ‚Gemeinde Nordstemmen' mit den Kampagnen … und …". Die fertigen Links findest du unter Sammlungen.

Übersicht über alle Kampagnen

Unter Übersicht sind alle Kampagnen nach Wahlart (z. B. Ortsrat, Gemeinderat) und Kommune gebündelt — praktisch, um z. B. alle Ortsratswahlen einer Gemeinde auf einen Blick zu sehen.

Was brauche ich für den Start?

Einen Account bei Claude.ai mit einer bezahlten Subscription (mindestens Pro, aktuell ca. 20 $/Monat). Der kostenlose Claude-Account reicht nicht — dort kannst du keine eigenen Connectors hinzufügen.
Oder einen Account bei Le Chat von Mistral (chat.mistral.ai). Der kostenlose Tarif reicht hier.
In beiden Fällen: einen GitHub-Account, der Mitglied der GitHub-Organisation cdu-kv-hildesheim ist (darüber wird dein Login erkannt).

Schritt für Schritt: Claude.ai verbinden

Öffne claude.ai und logge dich ein.
Klicke oben rechts auf deinen Namen oder dein Profilbild und wähle Settings.
Gehe zum Reiter Connectors.
Klicke Add custom connector (oder „Eigenen Connector hinzufügen").
Im Feld URL trägst du ein: https://wahlkampf.levinkeller.de/mcp
Als Name setzt du z. B. Wahlkampf CDU.
Claude leitet dich nun kurz hierher weiter, damit du dich über GitHub anmeldest und die Verbindung bestätigst. Einmal auf Authorize, fertig.
Zurück in Claude.ai: unten im Chatfenster auf das Werkzeug-Symbol klicken und „Wahlkampf CDU" aktivieren.

Schritt für Schritt: Le Chat (Mistral) verbinden

Öffne chat.mistral.ai, logge dich ein.
Seitenleiste: Connectors öffnen.
Klicke + Add Connector und wähle Custom MCP Connector.
URL eintragen: https://wahlkampf.levinkeller.de/mcp
GitHub-Login bestätigen (genau wie bei Claude).
Im Chat oben oder in der Tool-Leiste den neuen Connector aktivieren.

Jetzt mit der KI reden

Stell einfach Fragen oder gib Anweisungen. Beispiele:

„Zeig mir alle anstehenden Events."
„Leg ein Event am 3. Mai 2026 um 9 Uhr auf dem Marktplatz Adensen an — Tags adensen und nordstemmen."
„Welche Events laufen nächste Woche in Harsum?"
„Wer hat für die Aktion ‚Stand am Markt' zugesagt?"
„Schreib mir die nächsten 10 Events als Text für den Newsletter."
„Setz für mich den Standard-Filter auf ‚nordstemmen'."

Tipp: Wenn die KI unsicher ist, was sie kann, kopier ihr einmal den Block weiter unten in den Chat. Danach weiß sie, wie sie mit diesem Tool arbeitet, und du kannst normal weiter chatten.

Kalenderabo (ICS)

Alle Aktionen, zu denen du zugesagt hast, kannst du automatisch in deinem Kalender sehen. Unter Mein Bereich findest du einen persönlichen Kalender-Link.

Den trägst du in deinem Kalenderprogramm ein:

Apple Kalender: Datei → Neues Kalenderabo → Link einfügen.
Google Kalender: Andere Kalender → Per URL hinzufügen.
Outlook: Kalender hinzufügen → Aus dem Internet abonnieren.

Wichtig: Nicht „importieren" (Einmalimport), sondern „abonnieren" (aktualisiert sich automatisch).

Wenn etwas nicht funktioniert

Login klappt nicht: Du bist vermutlich nicht in der GitHub-Organisation cdu-kv-hildesheim. Melde dich bei einem Maintainer, damit du eingeladen wirst.
„Not a member of kampagne-…": Du bist kein Mitglied der betreffenden Kampagne. Falls du Mitglied sein solltest, bitte den Maintainer, dich aufzunehmen.
Die KI erfindet Antworten: schreib „Nutze dafür nur Werkzeuge, nicht raten." Dann greift sie auf das Tool zurück.
Connector verloren / abgemeldet: einfach in den Settings der KI neu verbinden. Deine Daten hier bleiben erhalten.

Quick Facts

MCP-Endpoint: https://wahlkampf.levinkeller.de/mcp
Auth: OAuth 2.1 mit Dynamic Client Registration (RFC 7591), PKCE, Bearer-Token
Transport: JSON-RPC 2.0 via HTTP POST, kein SSE
Identität: GitHub-OAuth, gekoppelt an Organisations-Mitgliedschaft
Sichtbarkeit: Aktionen sind auf Kampagnen-Team-Mitgliedschaft begrenzt; Maintainer von kampagne-*-Teams sehen alles.

Client-Kompatibilität

Claude.ai (Pro/Max/Team/Enterprise): Custom Connectors ab Pro.
Le Chat (Mistral): Custom MCP Connector ist in allen Tiers verfügbar, auch Free.
Claude Desktop: via Configdatei, siehe modelcontextprotocol.io.
ChatGPT: unterstützt keine Custom MCP Server — nicht nutzbar.

Setup

Kurzform: URL https://wahlkampf.levinkeller.de/mcp als Custom Connector eintragen. Dein Client übernimmt DCR und PKCE automatisch. Du landest einmal auf dem GitHub-Login, bestätigst, und bist drin.

Verfügbare Tools

Tool	Zweck
`list_events`	Events auflisten (Filter: campaign_slug, location_tags, upcoming_only)
`get_event`	Event + sichtbare Aktionen
`create_event`	Event anlegen (Maintainer). `rsvp_enabled=true` = eigenes Event, auf das man direkt zusagen kann (ohne Aktion); aus = externe Veranstaltung (Zusage nur über Aktionen)
`update_event`	Event bearbeiten (Maintainer)
`delete_event`	Event löschen, Cascade auf Aktionen/RSVPs (Maintainer)
`list_actions`	Aktionen, auf Team-Mitgliedschaft gefiltert
`create_action`	Aktion anlegen — an ein Event angehängt oder eigenständig mit eigenem Datum/Ort (Team-Mitglied)
`update_action` / `delete_action`	Aktion ändern/löschen (Team-Mitglied)
`add_event_to_campaign` / `remove_event_from_campaign`	Öffentliches Event ohne Aktion einer Kampagne zuordnen — erscheint auf deren Übersichten/Sammlungen (Team-Mitglied)
`rsvp`	Eigene Zusage setzen (yes/no/maybe) — für eine Aktion (`action_id`) oder ein eigenes Event (`event_id`)
`list_attendees`	Teilnehmerliste einer Aktion oder eines eigenen Events (mit GitHub-Profil-URL)
`list_my_rsvps`	Eigene Zusagen
`list_campaigns`	Alle Kampagnen der Organisation
`list_members`	Team-Mitglieder einer Kampagne
`get_campaign_info` / `update_campaign_info`	Metadaten einer Kampagne inkl. `wahlart`/`kommune` für die Übersicht
`create_collection` / `update_collection` / `delete_collection`	Kuratierte öffentliche Sammlung (Themenseite) aus mehreren Kampagnen; Maintainer
`list_collections` / `get_collection`	Sammlungen + öffentlicher Link (`/s/<slug>?key=<token>`); `get_collection` inkl. kommender Termine
`rotate_collection_link`	Erneuert den geheimen `key` einer Sammlung; alte Links brechen (Maintainer)
`get_preferences` / `set_preferences`	Eigener location_tags-Filter
`get_dashboard`	Overview mit URLs
`export_events_as_text`	Bullet-Liste für Newsletter, mit Deeplinks
`get_my_ics_url`	Eigener ICS-Kalender-Abo-Link

Deeplinks

Jedes Response-Objekt enthält url (und bei Aktionen zusätzlich event_url). Events enthalten außerdem public_url — einen öffentlichen Zusage-Link ohne Login, über den Helfer ohne Account mit Namen zusagen (öffentlich sichtbar ist nur die Anzahl). Deine KI kann diese URLs direkt zurückzitieren, damit du mit einem Klick auf der Seite landest. Klient-seitig gilt derselbe Login.

ICS-Feed

get_my_ics_url liefert einen signierten Link mit Token. Alternativ findest du ihn unter Mein Bereich.

Prompt-Patterns

Forcier Tool-Nutzung bei zu geschwätzigen Modellen: „Rufe list_events mit upcoming_only=true auf."
Bei Batch-Arbeit: „Erstelle für folgende Liste je ein Event" — die KI loopt das durch, weil das Tool keinen Bulk-Insert hat.
Für Newsletter-Exports: export_events_as_text gibt bereits Deeplinks mit aus, direkt als Markdown weiterverwendbar.

Kontext-Block zum Kopieren (für deine KI)

Paste diesen Block einmal oben in deinen Chat. Danach weiß deine KI, wie sie mit dem Tool arbeitet, ohne raten zu müssen.

# Wahlkampf-Koordinationstool — Kontext für KI-Assistenten

Ich nutze ein MCP-gestütztes Kampagnenwerkzeug für den Kommunalwahlkampf 2026
im CDU-Kreisverband Hildesheim. Es ist ein privates Experiment von Levin Keller
(kein offizielles CDU-Angebot), als Idee für den Kreisverband. Bitte hilf mir,
damit zu arbeiten.

## Worum geht es

Die Plattform koordiniert Wahlkampf-Termine (Events) und optional Aktionen.

- Ein EVENT ist ein Kalendereintrag mit Datum/Uhrzeit/Ort. Ein EIGENES Event
  (z. B. ein Wahlkampfstand, create_event mit rsvp_enabled=true) ist DIREKT
  zusagbar — man sagt zum Event selbst zu, keine Aktion nötig. Eine EXTERNE
  Veranstaltung (Fest, Markt; rsvp_enabled=false, Default) ist nicht direkt
  zusagbar — dort läuft die Teilnahme über eine Aktion einer Kampagne.
- Eine AKTION ist optional: die konkrete Aktivität einer Kampagne. Sie hängt
  an einem Event ODER ist eigenständig (bringt eigenes Datum/Ort mit, ohne
  Event). Nutze Aktionen nur, wenn es wirklich getrennte Teil-Aufgaben oder
  mehrere Kampagnen am selben Termin gibt — sonst reicht ein eigenes Event.
- Zusagen (RSVP) gehen also auf ein Event ODER auf eine Aktion.

Kampagnen sind organisatorische Einheiten mit dem Präfix "kampagne-". Jeder
angemeldete Nutzer sieht alle Events, aber nur die Aktionen der Kampagnen, in
denen er Mitglied ist (eigenständige Aktionen bleiben kampagnen-intern).
Maintainer sind Super-User und sehen alles.

Jeder Termin hat einen öffentlichen Zusage-Link (Feld "public_url"): darüber
können auch Helfer ohne Account mit ihrem Namen zusagen. Auf der
öffentlichen Seite ist nur die Anzahl der Zusagen sichtbar, keine Namen.
Kampagnen lassen sich über "wahlart" (z. B. ortsrat, gemeinderat) und
"kommune" (z. B. nordstemmen) gruppieren; daraus entsteht eine
Übersichtsseite.

Für gezielte Zielgruppen gibt es "Sammlungen": kuratierte, öffentliche
Themenseiten aus einer frei gewählten Liste von Kampagnen (create_collection).
Sie haben einen eigenen öffentlichen Link (public_url) ohne Login und zeigen
nur die kommenden Termine der enthaltenen Kampagnen. Der Link hat die Form
/s/<slug>?key=<token>: der slug ist lesbar und stabil, der key ist das
Geheimnis. Derselbe key gilt auch für die einzelnen Events der Sammlung
(Gast-Zusage ohne Account). Ist ein Link in falsche Hände geraten, kann man den
key per rotate_collection_link rotieren — alle alten Links (Übersicht UND Events)
werden dadurch ungültig, ohne den slug zu ändern. Eingeloggte Mitglieder sehen
überall die internen Links ohne Token und sagen mit ihrem Account zu.

## Rollen

- Teilnehmer: kann zu Events und Aktionen zusagen (yes/no/maybe), Termine
  ansehen, Kalenderabo nutzen.
- Kampagnen-Mitglied: kann zusätzlich Aktionen für die eigene Kampagne
  anlegen/bearbeiten (an einem Event oder eigenständig) und öffentliche Events
  der eigenen Kampagne zuordnen (add_event_to_campaign).
- Maintainer einer Kampagne: darf Events anlegen und bearbeiten (inkl.
  rsvp_enabled), Sammlungen pflegen und Kampagnen-Metadaten setzen.

## Was du für mich tun kannst

Event-Tools: list_events, get_event, create_event, update_event, delete_event
Action-Tools: list_actions, create_action, update_action, delete_action
Öffentliche Events an Kampagnen: add_event_to_campaign, remove_event_from_campaign (Event ohne eigene Aktion auf den Übersichten zeigen)
RSVP-Tools: rsvp, list_attendees, list_my_rsvps. rsvp und list_attendees
funktionieren mit action_id (Aktion) ODER event_id (eigenes, direkt zusagbares
Event mit rsvp_enabled).
Kampagnen: list_campaigns, list_members, get_campaign_info, update_campaign_info
Sammlungen (öffentliche Themenseiten): create_collection, list_collections, get_collection, update_collection, delete_collection, rotate_collection_link
Präferenzen: get_preferences, set_preferences
Überblick: get_dashboard
Export: export_events_as_text
Kalender: get_my_ics_url

## Formate

- Datum: YYYY-MM-DD, Zeit: HH:MM (Zeit optional)
- location_tags: freie Strings (klein geschrieben, Ortsnamen)
- wahlart / kommune (für Kampagnen-Gruppierung): freie Strings, klein geschrieben

## Deeplinks

Jede Tool-Antwort mit Event, Aktion oder Kampagne enthält ein "url"-Feld
(bei Aktionen mit Event zusätzlich "event_url"; eigenständige Aktionen haben
nur "url"). Events enthalten außerdem
"public_url": einen öffentlichen Zusage-Link, den man ohne Login öffnen
kann — ideal zum Weitergeben an Helfer ohne Account. Zeig mir diese URLs
nach jeder Schreib-Operation, damit ich direkt reinspringen kann. Erfinde
keine URLs.

## Best Practices

1. Standardmäßig upcoming_only=true bei list_events, außer ich frage
   explizit nach Vergangenem.
2. Beim Anlegen von Events sind Titel, Datum und Ort Pflicht. Frag nach,
   wenn ich unvollständig bin, statt zu raten.
3. Nach create/update/delete zeig mir den Deeplink aus der Antwort.
4. Bei Berechtigungsfehlern ("not a member of kampagne-…") erklär mir
   ehrlich, was nicht ging, statt nochmal zu probieren.
5. Location-Tags klein schreiben, bestehenden Tags vorziehen; neue nur,
   wenn ich sie explizit nenne.

## Typische Anliegen

- "Leg ein Event am {Datum} an, …" → create_event (für eine externe
  Veranstaltung wie ein Fest; Zusage später nur über Aktionen)
- "Plane unseren eigenen Wahlkampfstand am {Datum} in {Ort}" → create_event mit
  rsvp_enabled=true (eigenes Event, auf das man direkt zusagen kann — keine
  Aktion nötig)
- "Was läuft in {Ort}?" → list_events mit location_tags
- "Wer kommt zu {Aktion}?" → Aktion finden, dann list_attendees
- "Newsletter-Export" → export_events_as_text, Text als Markdown zurück
- "Trag mich ein bei …" → passende Aktion finden, rsvp mit status=yes

## Grenzen

- Kein Bulk-Insert in einem Call, loop stattdessen durch.
- Das Tool verschickt keine E-Mails und Nachrichten.
- Löschungen kaskadieren (Event löschen entfernt auch Aktionen/RSVPs).
  Warn mich vorher.