English version

Zurück zur Übersicht

Fehlerbehebung

Der Server schreibt Diagnosemeldungen auf stderr. Wo du diese Ausgabe findest, hängt von deinem MCP-Client ab.

Server startet nicht: fehlende Variablen

Meldung: Error: Missing required environment variables und Please ensure WIKIJS_API_URL and WIKIJS_API_TOKEN are set in .env file

Ursache: WIKIJS_API_URL oder WIKIJS_API_TOKEN ist nicht gesetzt, oder der Server hat die .env nicht gefunden.

Lösung:

1. Prüfe, ob ~/.claude/mcp-servers/wikijs/.env existiert. Wenn ja, wird nur diese Datei gelesen und eine .env im Repository ignoriert.
2. Gibt es diese Datei nicht, liest der Server die .env aus dem Arbeitsverzeichnis des Prozesses. Das ist oft nicht das Repository.
3. Setze die Variablen im Zweifel direkt in der Konfiguration deines MCP-Clients.

Details: Konfiguration.

Server erscheint nicht als verbunden

• Hast du npm run build ausgeführt? Ohne dist/index.js kann der Client nichts starten.
• Stimmt der absolute Pfad zu dist/index.js in der Client-Konfiguration?
• Läuft node im Client-Prozess (PATH) und ist es Version 18 oder neuer?
• Hast du den MCP-Client nach Änderungen komplett neu gestartet?

HTTP-Fehler

Meldung: Wiki.js API request failed: HTTP error! status: <Code>

GraphQL-Fehler

Meldung: Wiki.js API request failed: GraphQL request failed: <Meldung>

Der Text stammt von Wiki.js. Eine Meldung wie Forbidden weist darauf hin, dass dem API-Key ein nötiges Recht fehlt. Die .env.example nennt read:pages, write:pages und manage:pages. Die vollständige Fehlerliste steht zusätzlich auf stderr.

Operation abgelehnt

Meldung: Failed to create page: ..., Failed to update page: ..., Failed to delete page: ... oder Failed to move page: ...

Wiki.js hat die Anfrage verstanden, aber abgelehnt. Typische Fälle: die Seite existiert unter dem Pfad schon (create), der Zielpfad ist belegt (move) oder dem Key fehlt ein Recht. Der Text hinter dem Doppelpunkt kommt von Wiki.js.

Seite nicht gefunden

Meldung: Page not found at path: <Pfad> oder Page not found with ID: <ID>

Prüfe den Pfad und vor allem locale: Der Standard ist en. Eine deutsche Seite wird nur mit locale: "de" gefunden.

Validierungsfehler

Meldung: Validation error in <Tool>: mit einer Liste aus Feld und Grund.

Häufige Ursachen:

• Pfad mit Punkt, Umlaut, führendem Slash oder //: erlaubt sind Buchstaben, Ziffern, -, _ und /
• locale im falschen Format, erwartet wird z. B. de oder en-US
• content leer oder über 500.000 Zeichen, title über 200 oder description über 500 Zeichen
• mehr als 50 Tags oder ein Tag über 100 Zeichen
• weder id noch path angegeben: Either "id" or "path" must be provided

Timeout

Meldung: Request timed out. Please try again.

Wiki.js hat nicht innerhalb von 30 Sekunden geantwortet. Prüfe die Erreichbarkeit der Instanz. Bei sehr großen Wikis kann wikijs_list_pages langsam sein, weil jedes Mal die komplette Seitenliste geladen wird; das gilt auch für wikijs_update_page ohne tags.

Inhalt wirkt abgeschnitten

Seiten über 100.000 Zeichen werden beim Lesen gekürzt, erkennbar am Hinweis [Content truncated. ...] am Ende. Schreibe diesen Text nicht zurück, siehe Warnung bei wikijs_update_page in der Tools-Referenz.

Seite nach dem Update ein Entwurf

Wurde isPublished beim Update nicht mitgegeben, kann Wiki.js die Seite als unveröffentlicht führen. Setze die Seite mit einem Update und isPublished: true wieder auf veröffentlicht.