English version

Zurück zur Übersicht

Konfiguration

Der Server kennt genau zwei Einstellungen. Alles andere (Timeout, Größenlimits) ist fest im Code verdrahtet.

Umgebungsvariablen

Fehlt eine der beiden Variablen, beendet sich der Server beim Start mit Exit-Code 1 und der Meldung Error: Missing required environment variables. Ob die URL tatsächlich auf /graphql endet, prüft der Server nicht; er sendet die Anfragen an die URL genau so, wie sie konfiguriert ist.

Wo der Server die .env-Datei sucht

Die Reihenfolge ist fest:

1. Existiert ~/.claude/mcp-servers/wikijs/.env (im Home-Verzeichnis des Benutzers, der den Server startet), wird ausschließlich diese Datei geladen.
2. Andernfalls lädt der Server eine .env aus dem aktuellen Arbeitsverzeichnis des Prozesses.

Die .env im Repository wird nur gefunden, wenn der Prozess mit dem Repository als Arbeitsverzeichnis gestartet wird. Startet dein MCP-Client den Server aus einem anderen Verzeichnis, legst du die Datei besser unter ~/.claude/mcp-servers/wikijs/.env ab oder setzt die Variablen in der Client-Konfiguration.

Variablen, die schon in der Umgebung des Prozesses gesetzt sind (zum Beispiel über die Client-Konfiguration), werden von der .env-Datei nicht überschrieben.

Beispiel für die .env:

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

API-Key in Wiki.js anlegen

1. Öffne in Wiki.js die Administration und dort den Bereich API Access.
2. Lege einen neuen Key an und gib ihm einen Namen, zum Beispiel MCP Server.
3. Kopiere den erzeugten Token in die .env-Datei.

Die .env.example nennt als benötigte Rechte read:pages, write:pages und manage:pages. Der Server selbst prüft keine Rechte; ob ein Aufruf erlaubt ist, entscheidet allein Wiki.js. Ein Key ohne Schreibrechte führt bei den schreibenden Tools zu einer Fehlermeldung von Wiki.js, siehe Fehlerbehebung.

Feste Limits

Diese Werte lassen sich nicht konfigurieren.