Wiki.js Plugin: Konfiguration

Wiki.js Plugin konfigurieren: Umgebungsvariablen WIKIJS_API_URL und WIKIJS_API_TOKEN, Ladereihenfolge der .env, API-Token anlegen, lokale Dateien unter ~/.wikijs-plugin.

English Version

Zurück zur Übersicht

Wiki.js Plugin: Konfiguration

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Das Plugin hat genau zwei Einstellungen. Weitere Konfigurationsoptionen gibt es nicht.

Umgebungsvariablen

Variable	Pflicht	Beschreibung
`WIKIJS_API_URL`	Ja	GraphQL-Endpunkt der Wiki.js-Instanz, endet auf `/graphql` (z. B. `https://wiki.example.com/graphql`)
`WIKIJS_API_TOKEN`	Ja	API-Token aus dem Wiki.js-Adminbereich, wird als Bearer-Token gesendet

Standardwerte gibt es nicht. Fehlt eine der beiden Variablen, bricht der Server mit einer Fehlermeldung ab (siehe Fehlerbehebung).

WIKIJS_API_URL=https://deine-wiki-instanz.example/graphql
WIKIJS_API_TOKEN=dein-api-token-hier

Woher die Werte geladen werden

Existiert die Datei ~/.wikijs-plugin/.env, wird sie geladen. Dieser Pfad liegt außerhalb des Plugin-Verzeichnisses und übersteht Plugin-Updates.
Existiert sie nicht, sucht der Server über python-dotenv nach einer anderen .env (gedacht für lokale Entwicklung).
Bereits gesetzte Umgebungsvariablen des Prozesses werden von einer .env nicht überschrieben.

Die Zugangsdaten werden beim Start des MCP-Servers geprüft und beim ersten Tool-Aufruf für die gesamte Laufzeit des Prozesses zwischengespeichert.

Änderungen an ~/.wikijs-plugin/.env wirken erst nach einem Neustart von Claude Code.

API-Token in Wiki.js anlegen

Im Wiki.js-Adminbereich den Punkt API Access öffnen
Einen neuen Key erzeugen, z. B. mit dem Namen wikijs-plugin
Die Berechtigungen read:pages, write:pages und manage:pages auswählen
Den Token in die .env eintragen

Berechtigung	Wofür
`read:pages`	Seiten lesen, auflisten, suchen
`write:pages`	Seiten erstellen und aktualisieren
`manage:pages`	Seiten löschen und verschieben

Brauchst du nur Lesen und Schreiben, reichen read:pages und write:pages. Löschen und Verschieben sind dann auf der Wiki.js-Seite nicht erlaubt.

Lokale Dateien

Pfad	Inhalt	Angelegt von
`~/.wikijs-plugin/.env`	Zugangsdaten	Setup-Skill (Vorlage), du trägst die Werte ein
`~/.wikijs-plugin/venv/`	Python-Umgebung des MCP-Servers	Setup-Skill
`~/.wikijs-plugin/wikijs-plugin.db`	SQLite-Datenbank mit Änderungshistorie und verified-Markern	MCP-Server beim ersten Zugriff
`~/.wikijs-plugin/glossary.local.md`	Eigene Glossar-Einträge für `translation-check` (optional)	Du oder der Skill auf Wunsch

Grenzen, die nicht einstellbar sind

Diese Werte sind im Code festgelegt:

Grenze	Wert
Zeitlimit je API-Anfrage	30 Sekunden
Maximale Länge des Seiteninhalts beim Schreiben	500.000 Zeichen
Seiteninhalt beim Lesen	wird ab 100.000 Zeichen gekürzt
Seiten pro `wikijs_list_pages`-Aufruf	1 bis 200, Standard 50

Details zu allen Tools stehen auf der Seite Tools.