Skip to content
satware® AI DokuWiki MCP

Common Errors

Connection and Authentication Errors

Section titled “Connection and Authentication Errors”
Symptom Cause Solution
Authentication failed (HTTP 401) JWT token missing or expired Regenerate token in DokuWiki and update in userSettings
Permission denied (HTTP 403) DokuWiki ACL blocks access Check ACL rules: call list_acl_rules or contact DokuWiki admin
Network timeout DOKUWIKI_URL wrong or wiki unreachable Verify URL, check DokuWiki instance, confirm remote setting in DokuWiki

API Limitations

Section titled “API Limitations”

Some DokuWiki API methods are not implemented in API v12. The corresponding tools return api_limitation: true and recommend an alternative.

Tool Limitation Alternative
get_media_history core.getMediaHistory not in v12 Use get_recent_media_changes
get_media_usage core.getMediaUsage not in v12 Use search_pages with the media filename as query

Size-Delta Guard

Section titled “Size-Delta Guard”

save_page and update_page with mode=replace reject content that is less than 50% of the existing page size (for pages >2000 bytes).

Symptom Cause Solution
content_delta_too_small New page much shorter than current Set force=true or use mode=append

DokuWiki Syntax Warnings

Section titled “DokuWiki Syntax Warnings”

validate_content checks content locally before saving. The most common issues found:

Error Markdown (wrong) DokuWiki (correct)
Italic *text* //text//
Code `code` ''code''
Heading ## Title ===== Title =====
Link [Text](url) `[[url
Image ![alt](image.png) `{{image.png
Namespace folder/page folder:page
List * item (no indent) * item (2 spaces)

See DokuWiki Syntax for the full syntax reference.

Plugin-Specific Issues

Section titled “Plugin-Specific Issues”
Symptom Cause Solution
rename_page fails Move plugin not installed DokuWiki admin: install and enable Move plugin
Struct tools return an error Struct plugin not installed Call get_wiki_capabilities to check installed plugins
ACL tools unavailable Usermanager plugin not active Check DokuWiki plugin management

Docker and Transport

Section titled “Docker and Transport”

Container does not start

Section titled “Container does not start”
Symptom Cause Solution
image not found Wrong image tag docker pull git.satware.ai/satware.ai/mcp-dokuwiki:latest
DOKUWIKI_URL not set Environment variable missing Configure in TypingMind userSettings
DOKUWIKI_TOKEN not set Token missing Enter JWT token in userSettings

No MCP response

Section titled “No MCP response”

The server uses stdio transport. stdout is exclusively reserved for the MCP protocol. Logs appear on stderr.

Health check via CLI:

Terminal-Fenster
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

Expected response: JSON with "result" and "serverInfo". If there is no response, check the container logs (docker logs without the --rm flag).

Section titled “Related Pages”