Website Background
eventnet.ch Logo für Ihre wertvollen Daten

eventnet.ch | Hofenstrasse 20A | 9300 Wittenbach | Telefon 41 71 560 5445 | Email info@eventnet.ch

Claude-Plugin (MCP)

Das Claude-Plugin ist ein eingebauter MCP-Server (Model Context Protocol), mit dem ein externer Claude-Client das CMS über HTTPS bedienen kann: Seiten anlegen/umbenennen/verschieben, Inhalte und Layouts bearbeiten, Bilder und Downloads hochladen, CSS/JS pflegen, Vorschau-URLs abrufen.

Verfügbar ab CMS v3.4.0. Der MCP-Endpunkt steht unter https://<CMS-Domain>/mcp/ bereit.

Voraussetzungen

  • CMS v3.4.0 oder neuer.
  • HTTPS auf der CMS-Domain.
  • Für Asset-Schreibzugriff: Das CMS muss Schreibrechte auf /css/ und /js/ haben.
  • Vorschau-Domain pro Kunden-Domain konfiguriert (sonst liefert preview_getPreviewUrl kein Ergebnis).

Plugin aktivieren

  1. Im CMS einloggen.
  2. Busapp Einstellungen → Claude (MCP) → Token & Plugin öffnen.
  3. Plugin aktiv einschalten. Die Adresse für Ihren Client steht unter MCP-Endpunkt-URL.
  4. Unter Limits & Sicherheit prüfen:
    • Rate-Limit (Req/Min) — pro Zugang, Standard 60.
    • Max. Bild-Upload (MB) (Standard 50) und Max. Download-Upload (MB) (Standard 200).
    • IP-Whitelist (optional) — zeilenweise IPs oder CIDR.
    • E-Mail für Sicherheitsmeldungen — kommagetrennt; leer gehen die Meldungen an die Admins mit «Darf Updates installieren».
  5. Speichern. Mit Verbindung zu /mcp/ testen prüfen Sie den Endpunkt.

Ohne gültigen Token liefert /mcp/ jetzt HTTP 401.

Token anlegen

  1. Unter Busapp Einstellungen → Claude (MCP) → Token & Plugin im Abschnitt Zugangstoken auf Neuer Token.
  2. Felder ausfüllen:
    • Bezeichnung — frei wählbar (z.B. „Marketing Laptop Claude").
    • Scopes — welche Art von Operationen der Token darf, siehe Scopes.
    • Domains — wofür der Token gedacht ist, siehe Reichweite eines Zugangs.
    • Ablaufdatum (optional) — leer bedeutet kein Ablauf.
  3. Token erstellen. Den angezeigten Klartext sofort kopieren! Er wird nur einmal gezeigt.

Der Klartext beginnt mit cmsk_ und hat insgesamt 48 Zeichen.

Scopes

ScopeErlaubt
readAlles lesen, Vorschau-URLs, Datei-Download ohne Base64
writeSeiten, Inhalte und Sektionen, Meta-Entwürfe, Redaktionsregeln, Dateimanager, Formulare, Agenda, zeitabhängige Einträge, Suchen & Ersetzen
uploadBilder und Downloads verwalten, Datei-Upload ohne Base64
layoutsLayouts, CSS/JS-Entwürfe, Sprachen, Layoutzuweisung einer Seite, Navigation/Header/Fusszeile einer Domain
publishInhalte, Meta, Layouts und CSS/JS online stellen, Seiten und Layouts offline nehmen
settingsDomains, Vorschau, Systemeinstellungen, robots.txt/llms.txt/Sitemap-Einstellungen, Verwaltung der Zugriffsauswertung

publish und settings stecken nicht im Sammel-Scope mcp, der read, write, upload und layouts umfasst. Beim Verbinden per OAuth werden sie zusätzlich angeboten und müssen bewusst angehakt werden. Die Einstellungsgruppe «Claude» ist auch mit settings gesperrt: Kein Zugang kann seine eigene Konfiguration ändern.

In Claude einrichten

Zwei Wege:

Claude.ai Custom Connector

  1. Auf claude.ai → Einstellungen → Integrations → MCP Server → Neu.
  2. URL: https://<CMS-Domain>/mcp/
  3. Es wird kein Token eingetragen: claude.ai meldet sich per OAuth an. Melden Sie sich beim Verbinden im CMS an und bestätigen Sie die Scopes.
  4. Der Zugang erscheint danach unter Token & Plugin → OAuth-Clients.

Claude Code (CLI)

In ~/.claude/mcp.json oder pro Projekt in .mcp.json:

{
  "mcpServers": {
    "busapp-cms": {
      "url": "https://<CMS-Domain>/mcp/",
      "headers": {
        "Authorization": "Bearer cmsk_..."
      }
    }
  }
}

Verfügbare Tools

Über das Plugin stehen rund 150 Werkzeuge zur Verfügung, nach Bereich:

BereichWas
siteInfo_*Übersicht, Redaktionsregeln, Navigation/Header/Fusszeile einer Domain
pages_*Seitenbaum, anlegen, umbenennen, verschieben, löschen, Titel, Seitentyp, Publikationsdatum, Layout, Meta-Vererbung
content_*Lesen und Schreiben, Versionen und Rollback, Multipage und einzelne Sektionen, Meta, online stellen und offline nehmen
media_*Bilder und Bildordner: hochladen, ersetzen, umbenennen, verschieben, löschen, EXIF entfernen, verkleinern, Original wiederherstellen, Vorschaubilder, Verwendung
downloads_*Downloads und Ordner, PDF-Vorschaubilder, Verwendung
upload_vorbereiten, datei_download_urlDateien ohne Base64 übertragen
assets_*CSS/JS lesen, als Entwurf schreiben, Entwürfe auflisten, verwerfen, online stellen, aktive Dateien
layouts_*Lesen, Entwurf schreiben, Versionen, online stellen, anlegen, Stammdaten, Verwendung, löschen
languages_*Auflisten, anlegen, ändern, Verwendung, löschen
preview_getPreviewUrlVorschau-URL einer Seite
fs_*Dateimanager: Dateien und Ordner im Webroot, Papierkorb
webtool_*Formulare, Felder und Texte
agenda_*Termine je Domain
timedContent_*Zeitabhängige Einträge und Regeln
search_preview, search_replaceSuchen und Ersetzen über alle Inhalte
seo_*robots.txt, llms.txt, Sitemap, Indexierung pro Seite, Prüfung
domains_*, config_*Domains, Vorschau-Einstellungen, Systemeinstellungen
analytics_*Zugriffsauswertung und deren Verwaltung

Was der Server von sich aus erklärt

Beim Verbinden liefert der Server ein Feld instructions — einen kompakten Leitfaden zum Datenmodell, den der Client automatisch als Kontext lädt (ab CMS v3.7.17). Wer über MCP zugreift, muss sich die Begriffe also nicht aus Feldnamen erschliessen. Der Leitfaden erklärt in Kurzform genau das, was die folgenden Abschnitte ausführlich beschreiben.

Redaktionsregeln

Je Website lassen sich Regeln für das Schreiben festhalten: Tonalität, Anrede, Schreibweisen, Seitenaufbau, welche Layouts wofür. Sie stehen unter Ausgabe → Redaktion (Vorgabe) und unter der jeweiligen Domain. Claude liest sie mit siteInfo_getOverview oder siteInfo_readRules und hält sie mit siteInfo_writeRules fest (die globale Vorgabe nur mit Scope settings). Das Feld Verwendung eines Layouts sagt zusätzlich, wofür es gedacht ist.

Seiten, Layouts und Sprachen — was sie im CMS bewirken

Seiten: pagesID und pageID sind zwei verschiedene Dinge

Eine Seite ist ein Knoten im Seitenbaum und hat eine pagesID. Sie ist sprachneutral: Umbenennen, Verschieben und Löschen laufen immer über die pagesID.

Zu jeder Seite gibt es pro Sprache eine Sprachvariante mit eigener pageID. Alles Inhaltliche hängt an dieser pageID: der Text, der Seitentitel und die Layoutzuweisung. Wer eine deutsche Seite bearbeitet, arbeitet mit deren pageID — die pagesID allein reicht nicht.

Jedes Speichern legt eine neue Version an (pagedetailID). Zwei Zeiger bestimmen, welche Version wo sichtbar ist:

  • aktivcms — die Version, die im CMS als Entwurf erscheint und in der Vorschau sichtbar ist.
  • aktivonline — die Version, welche die Website ausliefert.

Beide Zeiger sind unabhängig. Über MCP geschriebene Inhalte landen immer nur auf aktivcms — die Website ändert sich dadurch nicht.

pages_delete nimmt die Seite aus dem Seitenbaum, entfernt ihre Daten aber nicht. Eine Funktion zum Wiederherstellen gibt es im CMS nicht; wenden Sie sich dafür an Ihren Ansprechpartner.

Layouts: der Rahmen um den Inhalt

Ein Layout liefert das HTML, das vor und nach dem Seiteninhalt steht — Kopfbereich, Navigation, Fussbereich. Der Inhalt selbst kommt aus der Seite. Es gibt drei Arten, unterschieden über das Feld funktionpage:

  • Seitenlayout (funktionpage = 0) — der Rahmen einer ganzen Seite. Nur solche Layouts lassen sich einer Seite zuweisen.
  • Sektionslayout (funktionpage = 1) — der Rahmen eines einzelnen Abschnitts auf einer Multipage-Seite.
  • Zonenlayout (funktionpage = 2) — wird von einem anderen Layout eingebettet, um dessen Inhaltsbereich in mehrere Zonen zu teilen.

Layouts sind wie Seiteninhalte versioniert und kennen Entwurf und Online-Stand. layouts_write ändert nur den Entwurf; sichtbar wird eine Layoutänderung erst beim Publizieren.

Die Zuweisung eines Layouts an eine Seite (pages_setLayout) ist dagegen nicht versioniert: sie wirkt sofort auf Entwurf und Online-Stand gleichermassen und lässt sich nicht per Rollback zurückholen.

Sprachen: Inhalt und URL

Eine Sprache bestimmt zweierlei: welche Sprachvarianten es zu einer Seite geben kann, und wie die öffentliche Adresse aussieht. Das Feld Verzeichnis ist der Pfadteil der URL — de/ ergibt Adressen der Form /de/seitenname. Das Kürzel (max. 5 Zeichen) dient der Anzeige, etwa in der Sprachumschaltung.

Eine Sprache zu deaktivieren nimmt sie aus der Ausgabe, lässt aber alle Inhalte unangetastet. Die letzte aktive Sprache lässt sich weder deaktivieren noch löschen — sonst hätte die Website keine Ausgabesprache mehr.

Löschen: erst prüfen, dann entfernen

Layouts und Sprachen lassen sich nur löschen, wenn sie nirgends mehr verwendet werden. Im CMS erscheint der Löschbutton deshalb nur bei ungenutzten Einträgen; sonst steht dort ein Hinweis, wo der Eintrag noch hängt. Über MCP beantworten layouts_getUsage und languages_getUsage dieselbe Frage vorab.

Geprüft wird bei einem Layout: ob ihm Seiten zugewiesen sind, ob es als Zonenlayout eingebettet ist und ob es in Multipage-Sektionen vorkommt — auch in alten Inhaltsversionen. Letzteres ist Absicht: So kann ein Rollback auf eine ältere Version nie auf ein verschwundenes Layout zeigen.

Bei einer Sprache zählen Seiten-Sprachvarianten, sprachgebundene Layouts sowie weitere sprachgebundene Daten wie Multipage-Sektionen, Webtool-Texte und Formular-Einreichungen.

Was in Gebrauch ist, wird also nicht gelöscht, sondern auf inaktiv gesetzt. Das nimmt den Eintrag aus dem Alltag, ohne bestehende Inhalte zu gefährden.

Entwürfe bei CSS, JS und Meta

assets_writeCss und assets_writeJs speichern standardmässig einen Entwurf: Die Datei auf der Website bleibt unverändert, die Vorschau-Domain zeigt den Entwurf unter derselben Adresse. Online geht er mit assets_publish (einzeln oder alle, Scope publish), verworfen wird er mit assets_discard; assets_listDrafts zeigt die offenen Entwürfe. Nur mit sofortOnline=true und Scope publish wird direkt in die Datei geschrieben. Domains mit gemeinsamem Webroot teilen sich den Entwurf.

Auch content_writeMeta und seo_setPageIndexing sind Entwürfe. Sie gehen mit content_publish online oder ohne neuen Inhalt mit content_publishMeta. content_readMeta zeigt das wirksame Ergebnis für Entwurf und Online-Stand.

Was sofort wirkt

Die folgenden Dinge kennen keinen Entwurf und wirken unmittelbar:

  • die Layoutzuweisung einer Seite (pages_setLayout) und welche Seite Navigation, Header oder Fusszeile einer Domain liefert (siteInfo_setContainer, im Frontend nach ?reinit=app),
  • Layout-Stammdaten und Sprach-Stammdaten,
  • welche CSS- und JS-Dateien aktiv sind (assets_updateActiveFiles) — im Frontend allerdings erst nach einem Aufruf der Website mit ?reinit=app,
  • Seiteneigenschaften wie Titel, URL-Name und Meta-Vererbung,
  • Redaktionsregeln,
  • Bilder, Downloads und Dateimanager (media_*, downloads_*, fs_*),
  • Formulare, Agenda und zeitabhängige Einträge,
  • search_replace — schreibt direkt in alle betroffenen Datensätze und lässt sich nicht per Rollback zurücknehmen,
  • Domains, Systemeinstellungen und seo_writeConfig (Scope settings).

Seiteninhalte lesen und schreiben

Seiteninhalte liegen aus historischen Gründen URL-codiert in der Datenbank. Nach aussen ist das unsichtbar: content_read liefert normales HTML, content_write nimmt normales HTML entgegen. Lesen, Ändern und Zurückschreiben ist damit verlustfrei.

Multipage-Seiten bestehen nicht aus einem Textblock, sondern aus mehreren Sektionen mit je eigenem Layout. Für sie gibt es content_readMultipage, content_addSection und content_writeSection. content_writeMultipage ersetzt alle Sektionen auf einmal. Wird eine solche Seite versehentlich mit dem normalen content_write beschrieben, geht ihre Sektionsstruktur verloren.

Der Aufbau einer Multipage (Sektionen, Layouts, Reihenfolge) gilt für alle Sprachen, nur der Inhalt ist sprachabhängig. Als Sektion sind nur Sektionslayouts zulässig. Antworten können warnungen enthalten, gespeichert wird trotzdem:

  • LAYOUT_MARKUP_IM_CONTENT — der Inhalt baut einen Layout-Rahmen nach.
  • ZONEN_UEBERZAEHLIG — mehr Zonen, als das Sektionslayout kennt.
  • INHALT_WIRD_NICHT_AUSGEGEBEN — die Sektion füllt sich selbst, etwa die Agenda.
  • SPRACHEN_AUFBAU_ABWEICHEND — die Sprachen sind auseinandergelaufen; content_alignSections gleicht sie an.

Dateien übertragen ohne Base64

Kann der Client selbst HTTP-Anfragen schicken, sollten Dateien ab etwa 20 KB nicht als Base64 gesendet werden (ab CMS v3.7.53):

  • Hochladen: upload_vorbereiten (Scope upload, ziel = media, media_replace, downloads oder fs) liefert eine Adresse und einen Einmal-Token. Die Datei geht dann per HTTP-PUT dorthin; das fertige Kommando steht in der Antwort. Abgelegt wird sie wie bei den Base64-Werkzeugen.
  • Herunterladen: datei_download_url (Scope read) liefert entsprechend eine Adresse für HTTP-GET.

Ein Token gilt einmal und 10 Minuten.

Sicherheits-Eigenschaften

  • Publizieren ist Menschenhand — ohne den separaten publish-Scope kann Claude keinen Inhalt online stellen. write und rollback berühren beim Seiten-Content nur aktivcms. Ausgenommen sind die Dinge unter «Was sofort wirkt».
  • Reichweite eines Zugangs — jeder Token ist Domains zugeordnet. Standardmässig erreicht er trotzdem alle Seitenzweige der Installation, weil Menü- und Fusszeilen-Ordner zu keiner Domain gehören. Soll die Zuordnung eine Schranke sein, stellen Sie unter Claude (MCP) → Allgemein die Einstellung MCP-Zugriff auf den Seitenbaum auf Nur die dem Token zugeordneten Domains.
  • Rate-Limit — Sliding-Window pro Token, Default 60/min.
  • Audit-Log — jeder Tool-Call wird mit Token, IP, Tool, Ziel, Ergebnis und Dauer protokolliert. Einsehbar unter Busapp Einstellungen → Claude (MCP) → Token & Plugin, Abschnitt Audit-Log.
  • Master-Schalter — ist Plugin aktiv ausgeschaltet, ist das ganze Plugin deaktiviert.

Token widerrufen

Klicken Sie in der Token-Liste beim gewünschten Token auf Widerrufen. Ab sofort liefert die Auth 401 für diesen Token. Danach lässt er sich mit Löschen entfernen. Bestehende Tokens lassen sich nicht „bearbeiten" — bei Bedarf neu erzeugen, alten widerrufen. OAuth-Zugänge von claude.ai widerrufen und löschen Sie gleich unter OAuth-Clients.

Fehlercodes

Häufige Fehler-Codes: -32000 Plugin deaktiviert, -32001 Nicht authentifiziert, -32002 Rate-Limit, -32603 Internal Error mit Scope-Hinweisen.

Zurück zu: Busapp Einstellungen

adresse
eventnet.ch
Hofenstrasse 20A
9300 Wittenbach
Telefon +41 71 560 5445
Email info@eventnet.ch

adresse