Hilfe und Erklärvideos / API & KI-Assistenten

API & KI-Assistenten

Mit einem API-Token Pläne und Messdiener aus eigener Software oder einem KI-Assistenten abrufen und bearbeiten.

Video kommt 2027

Mit einem persönlichen API-Token können Planer die Daten ihrer Gemeinde aus einem eigenen Programm oder einem KI-Assistenten abrufen und bearbeiten. Diese Funktion ist für Premium, Sponsor und laufende Demo-Verträge verfügbar. Ein Token kann genau das, was der Planer kann, der ihn angelegt hat.

Token anlegen

Öffne als Planer Mehr → API-Zugang in der App oder im Menü der Weboberfläche den Punkt API-Zugang; beide führen zur selben Token-Verwaltung. Vergib einen erkennbaren Namen, wähle Lesen oder Schreiben und ein Ablaufdatum. Ein Schreib-Token darf auch lesen. Kopiere den angezeigten Token sofort in einen sicheren Passwortspeicher: Er wird nur einmal vollständig angezeigt. Andere Planer deiner Gemeinde können den Token später sehen und widerrufen, aber nicht sein Geheimnis lesen. Nach Ablauf oder Widerruf funktioniert er nicht mehr.

API aufrufen

Die OpenAPI-Beschreibung listet die für Tokens verfügbaren Endpunkte. Angemeldete Planer können sie auch in der Swagger-Ansicht ansehen. Beispiel für die Planliste:

curl -H "Authorization: Bearer $MESSDIENERPLAN_API_TOKEN" \
  https://messdiener-plan.de/api/v1/schedules

JSON-Antworten enthalten ein data-Feld; PDF- und CSV-Exporte liefern Dateien. GET braucht mindestens einen Lese-Token; POST, PUT und DELETE brauchen einen Schreib-Token. Antworten mit 401 bedeuten einen ungültigen oder abgelaufenen Token, 403 fehlende Rechte oder einen nicht verfügbaren Vertrag. Bewahre den Token nie in öffentlich sichtbarem Quellcode auf.

KI-Assistenten anbinden (MCP)

Der Messdiener-Plan bringt einen eigenen MCP-Server mit. MCP (Model Context Protocol) ist ein offener Standard, über den KI-Assistenten wie Claude Code oder Cursor auf Werkzeuge zugreifen. Du verbindest deinen Assistenten mit dieser Adresse:

https://messdiener-plan.de/api/v1/mcp

Die Anmeldung läuft über denselben API-Token, als Kopfzeile Authorization: Bearer <dein Token>. Lege für jeden Assistenten einen eigenen Token an, damit du seinen Zugang unabhängig widerrufen kannst. Ein Lese-Token reicht, wenn der Assistent nur Auskunft geben soll.

Claude Code

Im Terminal:

claude mcp add --transport http messdienerplan https://messdiener-plan.de/api/v1/mcp \
  --header "Authorization: Bearer DEIN_TOKEN"

Claude Code speichert den Token dabei in seiner Konfiguration auf deinem Rechner. Möchtest du den Server in einem Projekt teilen, ohne den Token mitzuteilen, lege eine Datei .mcp.json an und hole den Token aus einer Umgebungsvariablen:

{
  "mcpServers": {
    "messdienerplan": {
      "type": "http",
      "url": "https://messdiener-plan.de/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${MESSDIENERPLAN_API_TOKEN}"
      }
    }
  }
}

Mit claude mcp list oder /mcp im Chat prüfst du, ob die Verbindung steht.

Cursor

Trage den Server in ~/.cursor/mcp.json (für alle Projekte) oder in .cursor/mcp.json (nur für ein Projekt) ein:

{
  "mcpServers": {
    "messdienerplan": {
      "url": "https://messdiener-plan.de/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MESSDIENERPLAN_API_TOKEN}"
      }
    }
  }
}

Setze die Umgebungsvariable MESSDIENERPLAN_API_TOKEN vor dem Start von Cursor. Schreibe den Token nicht direkt in eine Datei, die mit anderen geteilt oder in ein Repository eingecheckt wird.

Was der Assistent kann

Lesend: Pläne auflisten und anzeigen, die PDF-Adresse eines Plans holen, Messdiener suchen und die regelmäßigen Gottesdienstzeiten auflisten. Mit einem Schreib-Token zusätzlich: einen Plan anlegen, Messen für einen Plan erzeugen, automatisch einteilen, einen Messdiener anlegen und eine Abwesenheit eintragen. Schreibende Werkzeuge führen nur aus, wenn der Assistent den Schritt ausdrücklich bestätigt; lass ihn dir vorher zeigen, was er ändern will. Alle Werkzeuge sehen nur die Daten deiner Gemeinde und haben nie mehr Rechte als dein Konto.

Andere Clients funktionieren ebenso, wenn man dort eine MCP-Adresse über HTTP mit eigener Kopfzeile eintragen kann. Für claude.ai und ChatGPT im Browser brauchst du keinen Token, siehe nächster Abschnitt.

MessdienerPlan in claude.ai / ChatGPT verbinden

In claude.ai und ChatGPT verbindest du den Messdiener-Plan als Konnektor, ganz ohne Token. Die Anmeldung läuft über dein normales Messdiener-Plan-Konto.

1. Öffne in claude.ai die Einstellungen unter Konnektoren und wähle Benutzerdefinierten Konnektor hinzufügen. In ChatGPT fügst du in den Einstellungen unter Apps bzw. Konnektoren einen eigenen MCP-Server hinzu. Je nach Tarif muss dort erst der Entwicklermodus eingeschaltet oder der Konnektor von der Verwaltung deiner Organisation freigegeben werden. 2. Gib als Adresse https://messdiener-plan.de/api/v1/mcp ein. Die Felder für Client-ID und Secret bleiben leer. 3. Klicke auf Verbinden. Es öffnet sich die Anmeldung des Messdiener-Plans. Melde dich an wie gewohnt, mit Passwort, Anmeldelink oder Google. 4. Die Freigabeseite zeigt, welche Gemeinde verbunden wird. Der Assistent hat dieselben Rechte wie du als Planer. Bestätige mit Erlauben. 5. Fertig: Frag zum Beispiel „Welche Pläne gibt es im Dezember?“ oder „Wer ist am Sonntag eingeteilt?“.

Gut zu wissen:

  • Verbinden können nur Planer, und nur mit den Paketen Premium oder Sponsor oder in einer laufenden Demo. Bei Basic und Free zeigt die Anmeldung einen Hinweis zum Paketwechsel.
  • Haben sich unsere AGB geändert und du hast sie noch nicht bestätigt, lässt sich der Assistent nicht verbinden, und eine bestehende Verbindung meldet sich nicht mehr neu an. Bestätige die AGB im Messdiener-Plan (die Freigabeseite verlinkt dorthin) und verbinde den Assistenten danach erneut.
  • Die Verbindung erscheint unter Mehr → API-Zugang als „KI-Konnektor“ und zählt zu den 10 aktiven Tokens. Dort kannst du sie jederzeit widerrufen; der Assistent verliert dann sofort den Zugriff. Verbindest du denselben Assistenten neu, ersetzt die neue Verbindung die alte.
  • Der Assistent meldet sich selbst regelmäßig neu an, du musst nichts tun. Nach 12 Monaten läuft die Verbindung ab, wenn du sie nicht in der Token-Verwaltung verlängerst.
  • Bevor der Assistent etwas ändert, etwa einen Plan anlegt, fragt er im Chat nach. Lies seine Zusammenfassung, bevor du zustimmst.

Datenschutz

Über den MCP-Server gelangen Personendaten deiner Gemeinde in das Sprachmodell deines KI-Anbieters, auch Daten von Minderjährigen: Namen, Einteilungen, Abwesenheiten und, soweit hinterlegt, Kontaktdaten. Den KI-Anbieter wählt deine Gemeinde selbst aus; für diese Weitergabe ist sie als Verantwortliche zuständig. Prüfe deshalb vorher, ob du mit dem Anbieter einen Vertrag zur Auftragsverarbeitung hast, wo er die Daten verarbeitet und ob er Eingaben zum Training verwendet. Gib dem Assistenten nur so viel Zugriff wie nötig und widerrufe den Token, sobald du ihn nicht mehr brauchst. Die Einzelheiten regeln unsere AGB und unsere Datenschutzerklärung.

Zurück zur Hilfeübersicht