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_getPreviewUrlkein Ergebnis).
Plugin aktivieren
- Im CMS einloggen.
- Busapp Einstellungen → Claude (MCP) → Token & Plugin öffnen.
- Plugin aktiv einschalten. Die Adresse für Ihren Client steht unter MCP-Endpunkt-URL.
- 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».
- Speichern. Mit Verbindung zu /mcp/ testen prüfen Sie den Endpunkt.
Ohne gültigen Token liefert /mcp/ jetzt HTTP 401.
Token anlegen
- Unter Busapp Einstellungen → Claude (MCP) → Token & Plugin im Abschnitt Zugangstoken auf Neuer Token.
- 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.
- Token erstellen. Den angezeigten Klartext sofort kopieren! Er wird nur einmal gezeigt.
Der Klartext beginnt mit cmsk_ und hat insgesamt 48 Zeichen.
Scopes
| Scope | Erlaubt |
|---|---|
read | Alles lesen, Vorschau-URLs, Datei-Download ohne Base64 |
write | Seiten, Inhalte und Sektionen, Meta-Entwürfe, Redaktionsregeln, Dateimanager, Formulare, Agenda, zeitabhängige Einträge, Suchen & Ersetzen |
upload | Bilder und Downloads verwalten, Datei-Upload ohne Base64 |
layouts | Layouts, CSS/JS-Entwürfe, Sprachen, Layoutzuweisung einer Seite, Navigation/Header/Fusszeile einer Domain |
publish | Inhalte, Meta, Layouts und CSS/JS online stellen, Seiten und Layouts offline nehmen |
settings | Domains, 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
- Auf claude.ai → Einstellungen → Integrations → MCP Server → Neu.
- URL:
https://<CMS-Domain>/mcp/ - 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.
- 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:
| Bereich | Was |
|---|---|
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_url | Dateien 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_getPreviewUrl | Vorschau-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_replace | Suchen 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(Scopesettings).
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_alignSectionsgleicht 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(Scopeupload,ziel=media,media_replace,downloadsoderfs) 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(Scoperead) 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.writeundrollbackberühren beim Seiten-Content nuraktivcms. 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
