Wiki.js Plugin
Claude Code Plugin für Wiki.js 3: MCP-Server mit 16 Tools (Seiten, Papierkorb, Versionen, Tags, Historie, verified-Marker) und 4 Skills (docs-wiki, source-check, translation-check, setup) für geprüfte DE+EN-Doku.
Wiki.js Plugin
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Das Plugin arbeitet ausschließlich mit Wiki.js 3 (Breaking Change gegenüber der 1.x-Linie, die für Wiki.js 2 ohne REST-API gebaut war). Details zum Umstieg stehen unter Von Plugin 1.x aktualisieren.
Nutzt du Wiki.js mit einem anderen MCP-Client als Claude Code? Dann ist der eigenständige wikijs-mcp-server (Node.js, GraphQL-API) die richtige Wahl.
Überblick
wikijs-plugin ist ein Claude-Code-Plugin für Wiki.js 3. Es besteht aus einem Python-MCP-Server, der Seiten erstellt, ändert, sucht, verschiebt, löscht und wiederherstellt, und aus vier Skills, die daraus einen geprüften Doku-Ablauf machen: Doku aus dem Code erzeugen (docs-wiki), Fakten gegen den Quellcode prüfen (source-check), Übersetzungen auf Natürlichkeit prüfen (translation-check) und das Plugin einrichten (setup).
Der Quellcode des dokumentierten Projekts ist die Wahrheit. Jede Seite durchläuft vor dem Publish einen Fakten- und einen Sprachcheck, und der geprüfte Stand wird lokal als verified-Marker festgehalten.
graph LR
A["Claude Code"] --> B["Skills"]
A --> C["MCP-Server wikijs-mcp"]
B --> C
C --> D["Wiki.js REST API"]
C --> E["Lokale SQLite-DB"]
B --> F["Quellcode des Projekts"]
Dokumentation
| Seite | Inhalt |
|---|---|
| Installation | Voraussetzungen, Marketplace, Setup-Skill, Update, Umstieg von 1.x, Deinstallation |
| Konfiguration | Umgebungsvariablen, Personal Access Token, lokale Dateien |
| Tools | Referenz aller 16 MCP-Tools |
| Skills | docs-wiki, source-check, translation-check, setup |
| Arbeitsabläufe | Seiten sicher ändern, Doku erstellen, Baseline, Umbau |
| Technik | Aufbau, Datenbank-Schema, Eigenheiten |
| Datenschutz und Sicherheit | Token, lokale Daten, Verbindungen |
| Fehlerbehebung | Fehlermeldungen und Lösungen |
Features
| Feature | Beschreibung |
|---|---|
| Seitenverwaltung | Erstellen, ändern, lesen, auflisten, suchen, verschieben, löschen |
| Papierkorb | Gelöschte Seiten landen im Papierkorb und lassen sich auflisten und wiederherstellen |
| Versionen | Die eigene Versionshistorie von Wiki.js lesen, auch um eine Seite zurückzusetzen |
| Tags | Vorhandene Tags auflisten und filtern, damit keine Varianten wie Sylius neben sylius entstehen |
| Render-Warteschlange | Nach Inhaltsänderungen wird die Seite automatisch neu gerendert, sonst bleibt der alte Stand sichtbar |
| Übersetzungen verknüpfen | DE- und EN-Seite per localeRelations verbinden, damit der Sprachumschalter funktioniert |
| Links beim Verschieben | wikijs_move_page schreibt auf Wunsch interne Links in anderen Seiten um |
| Schrumpf-Schutz | Updates, die den Inhalt auf unter die Hälfte kürzen, werden ohne confirmContentShrink abgelehnt |
| Änderungshistorie | Quellprojekt, Ref und Notiz je Create/Update, nur lokal gespeichert |
| Verified-Marker | Hält fest, gegen welchen Commit eine Seite geprüft wurde, und für welchen Seitenstand |
| docs-wiki | Hub und Unterseiten in DE und EN mit Dokumentations-Agents |
| source-check | Behauptungen gegen den Code prüfen, Undokumentiertes finden, Baseline-Lauf |
| translation-check | Natürlichkeit, DE/EN-Abgleich, Glossar mit eigenen Ergänzungen |
Anforderungen
| Anforderung | Hinweis |
|---|---|
| Claude Code | Installation über die Plugin-Marketplace-Mechanik |
| Python | 3.11 oder neuer |
| Wiki.js | Version 3.x. Wiki.js 2 hat keine REST-API, dafür gibt es nur Plugin 1.x |
| Personal Access Token | Scope pages, der Token gehört einem Benutzer, der Seiten lesen, schreiben und verwalten darf |
Das Plugin funktioniert nur mit einem Personal Access Token eines Benutzers. Andere Zugangsarten, etwa ein API-Schlüssel aus Wiki.js 2, werden nicht unterstützt.
Lizenz
PolyForm Noncommercial License 1.0.0: quelloffen einsehbar, aber nur für persönliche und nicht-kommerzielle Nutzung. Keine OSI-Open-Source-Lizenz. Kommerzielle Nutzung erfordert eine Genehmigung des Maintainers.
Das Projekt ist BDFL-geführt: Markus Michalski entscheidet final über alle Merges, vor dem ersten Pull Request ist das Contributor License Agreement zu unterschreiben (automatisiert per cla-assistant.io). Details in der CONTRIBUTING.md.