Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
| 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 |
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.
/wikijs-plugin:setup
Der Skill arbeitet diese Schritte ab:
python3, dann python, dann py -3, danach bekannte Windows-Installationspfade)~/.wikijs-plugin anlegen, falls er fehlt~/.wikijs-plugin/venv anlegen, falls es fehltrequirements.txt immer synchronisieren, auch wenn das Venv schon existiert.env-Vorlage nach ~/.wikijs-plugin/.env kopieren, aber nur, wenn die Datei noch nicht existiertmcp, httpx und dotenv importierbar sind (kein gültiges Wiki.js-Login nötig).env, MCP)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.
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.
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.
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.