Häufige Fehler

Verbindungs- und Authentifizierungsfehler

Symptom	Ursache	Lösung
`Authentication failed (HTTP 401)`	JWT-Token fehlt oder ist abgelaufen	Token im DokuWiki neu generieren und in den `userSettings` aktualisieren
`Permission denied (HTTP 403)`	DokuWiki-ACL blockiert den Zugriff	ACL-Regeln prüfen: `list_acl_rules` aufrufen oder DokuWiki-Admin kontaktieren
Netzwerk-Timeout	`DOKUWIKI_URL` falsch oder Wiki nicht erreichbar	URL prüfen, DokuWiki-Instanz pingen, `remote`-Einstellung in DokuWiki verifizieren

API-Limitierungen

Einige DokuWiki-API-Methoden sind in API v12 nicht implementiert. Die entsprechenden Tools geben api_limitation: true zurück und empfehlen eine Alternative.

Tool	Limitierung	Alternative
`get_media_history`	`core.getMediaHistory` nicht in v12	`get_recent_media_changes` verwenden
`get_media_usage`	`core.getMediaUsage` nicht in v12	`search_pages` mit dem Mediendateinamen als Query

Size-Delta-Guard

save_page und update_page mit mode=replace lehnen Inhalte ab, die weniger als 50% der bisherigen Seitengröße haben (bei Seiten >2000 Bytes).

Symptom	Ursache	Lösung
`content_delta_too_small`	Neue Seite deutlich kürzer als aktuelle	`force=true` setzen oder `mode=append` verwenden

DokuWiki-Syntax-Warnungen

validate_content prüft den Inhalt lokal vor dem Speichern. Die häufigsten gefundenen Fehler:

Fehler	Markdown (falsch)	DokuWiki (richtig)
Kursiv	`text`	`//text//`
Code	`code`	`''code''`
Überschrift	`## Titel`	`===== Titel =====`
Link	`[Text](url)`	`[[url
Bild	`![alt](bild.png)`	`{{bild.png
Namespace	`ordner/seite`	`ordner:seite`
Liste	`* Eintrag` (keine Einrückung)	`* Eintrag` (2 Leerzeichen)

Siehe DokuWiki-Syntax für die vollständige Syntax-Referenz.

Plugin-spezifische Probleme

Symptom	Ursache	Lösung
`rename_page` schlägt fehl	Move-Plugin nicht installiert	DokuWiki-Admin: Move-Plugin installieren und aktivieren
Struct-Tools geben Fehler	Struct-Plugin nicht installiert	`get_wiki_capabilities` aufrufen, um installierte Plugins zu prüfen
ACL-Tools nicht verfügbar	Usermanager-Plugin nicht aktiv	DokuWiki-Plugin-Verwaltung prüfen

Docker und Transport

Container startet nicht

Symptom	Ursache	Lösung
`image not found`	Falsches Image-Tag	`docker pull git.satware.ai/satware.ai/mcp-dokuwiki:latest`
`DOKUWIKI_URL not set`	Umgebungsvariable fehlt	In TypingMind `userSettings` konfigurieren
`DOKUWIKI_TOKEN not set`	Token fehlt	JWT-Token in `userSettings` eintragen

Keine MCP-Antwort

Der Server verwendet stdio-Transport. stdout ist ausschließlich für das MCP-Protokoll reserviert. Logs erscheinen auf stderr.

Gesundheitsprüfung per CLI:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}' \
| docker run -i --rm \
    -e DOKUWIKI_URL=https://wiki.satware.com \
    -e DOKUWIKI_TOKEN=YOUR_TOKEN \
    git.satware.ai/satware.ai/mcp-dokuwiki:latest

Erwartete Antwort: JSON mit "result" und "serverInfo". Wenn keine Antwort kommt, Container-Logs prüfen (docker logs im nicht---rm-Modus).