Markus Michalski FAQ

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

GitHub CI License Python

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.

Support