Der Server schreibt Diagnosemeldungen auf stderr. Wo du diese Ausgabe findest, hängt von deinem MCP-Client ab.
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:
~/.claude/mcp-servers/wikijs/.env existiert. Wenn ja, wird nur diese Datei gelesen und eine .env im Repository ignoriert..env aus dem Arbeitsverzeichnis des Prozesses. Das ist oft nicht das Repository.Details: Konfiguration.
npm run build ausgeführt? Ohne dist/index.js kann der Client nichts starten.dist/index.js in der Client-Konfiguration?node im Client-Prozess (PATH) und ist es Version 18 oder neuer?Meldung: Wiki.js API request failed: HTTP error! status: <Code>
| Code | Übliche Ursache |
|---|---|
| 404 | WIKIJS_API_URL zeigt nicht auf den GraphQL-Endpunkt, meist fehlt /graphql |
| 401 oder 403 | Token ungültig, abgelaufen oder widerrufen |
| 502 bis 504 | Reverse Proxy oder Wiki.js nicht erreichbar |
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.
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.
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.
Meldung: Validation error in <Tool>: mit einer Liste aus Feld und Grund.
Häufige Ursachen:
//: erlaubt sind Buchstaben, Ziffern, -, _ und /locale im falschen Format, erwartet wird z. B. de oder en-UScontent leer oder über 500.000 Zeichen, title über 200 oder description über 500 Zeichenid noch path angegeben: Either "id" or "path" must be providedMeldung: 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.
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.
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.