Wiki.js Plugin: Installation
Wiki.js Plugin installieren: Marketplace-Installation, Setup-Skill (Venv unter ~/.wikijs-plugin), Voraussetzungen, Update und Deinstallation.
Wiki.js Plugin: Installation
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Voraussetzungen
| Anforderung | Hinweis |
|---|---|
| Claude Code | Installation über die Plugin-Marketplace-Mechanik |
| Python 3.11 oder neuer | Wird vom Setup-Skill für das Venv benötigt. Auf Windows löst der py-Launcher das zuverlässig auf, auch wenn python und python3 auf den Microsoft-Store-Alias zeigen |
| Wiki.js | Mit erreichbarer GraphQL-API. Das Plugin nutzt die pages-Abfragen der Wiki.js-2.x-API |
| Wiki.js API-Token | Berechtigungen laut .env-Vorlage: read:pages, write:pages, manage:pages |
Installation
Schritt 1: Marketplace registrieren und Plugin installieren
claude plugin marketplace add markus-michalski/wikijs-plugin
claude plugin install wikijs-plugin@wikijs-plugin
Das Plugin ist nicht mit einem einfachen git clone lauffähig: Der MCP-Server startet über den Wrapper bin/run-server, der den Python-Interpreter aus ~/.wikijs-plugin/venv/ verwendet, und dieses Venv legt erst der Setup-Skill an.
Schritt 2: Setup-Skill ausführen
/wikijs-plugin:setup
Der Skill arbeitet diese Schritte ab:
- Einen funktionierenden Python-Interpreter ermitteln (
python3, dannpython, dannpy -3, danach bekannte Windows-Installationspfade) - Den Ordner
~/.wikijs-pluginanlegen, falls er fehlt - Das Venv
~/.wikijs-plugin/venvanlegen, falls es fehlt - Die Abhängigkeiten aus
requirements.txtimmer synchronisieren, auch wenn das Venv schon existiert - Die
.env-Vorlage nach~/.wikijs-plugin/.envkopieren, aber nur, wenn die Datei noch nicht existiert - Prüfen, ob
mcp,httpxunddotenvimportierbar sind (kein gültiges Wiki.js-Login nötig) - Einen Bericht ausgeben (Daten-Verzeichnis, Venv, Dependencies,
.env, MCP)
Schritt 3: Zugangsdaten eintragen und neu starten
Trage in ~/.wikijs-plugin/.env die Werte WIKIJS_API_URL und WIKIJS_API_TOKEN ein (Details auf der Seite Konfiguration) und starte Claude Code neu, damit der MCP-Server geladen wird.
Prüfe danach mit
/mcp, ob der Serverwikijs-mcpverbunden ist.
Von wikijs-mcp-server (Node.js) umsteigen
Die Variablennamen WIKIJS_API_URL und WIKIJS_API_TOKEN sind dieselben wie beim eigenständigen wikijs-mcp-server. Du kannst die Werte in die neue ~/.wikijs-plugin/.env übernehmen und brauchst kein neues Token. Entferne danach die alte manuelle MCP-Registrierung, sonst erscheinen die Tools doppelt.
Update
Das Plugin aktualisierst du über die Plugin-Verwaltung von Claude Code. Zugangsdaten und Historie liegen außerhalb des Plugin-Verzeichnisses in ~/.wikijs-plugin und bleiben dabei erhalten. Führe nach einem Update /wikijs-plugin:setup erneut aus: Der Skill synchronisiert die Abhängigkeiten immer neu, damit neue Pakete nicht übersehen werden, und überschreibt eine vorhandene .env nicht. Starte Claude Code danach neu.
Deinstallation
Das Plugin entfernst du über die Plugin-Verwaltung von Claude Code. Der Ordner ~/.wikijs-plugin (Venv, .env, Datenbank wikijs-plugin.db, optional glossary.local.md) wird dabei nicht automatisch gelöscht. Willst du Token und lokale Historie loswerden, lösche den Ordner selbst.
Mit dem Ordner gehen auch die verified-Marker verloren (siehe Technik). Seiten gelten danach wieder als ungeprüft.