Skip to content
satware® AI DokuWiki MCP

TypingMind Setup

Prerequisites

Section titled “Prerequisites”
  • TypingMind instance with admin access
  • Docker image git.satware.ai/satware.ai/mcp-dokuwiki available
  • DokuWiki JWT Bearer token
  • MCP Connector reachable (https://mcp-vps.satware.ai)

Access to chat.satware.ai

Section titled “Access to chat.satware.ai”

If you don’t operate your own TypingMind instance, you can book access to the satware® AI platform:

Book Accesssatware.ai/zugang - request personal access.
Free Webinarssatware.ai/webinare - free webinars about satware® AI chat.
WorkshopsAI workshops at vhs Worms - hands-on exercises on chat.satware.ai.

Import the Plugin

Section titled “Import the Plugin”

  1. Open Admin UI

    Log in to TypingMind and navigate to /admin/plugins.

  2. Import Plugin

    Click “Add Plugin” and select MCP as the plugin type. Import the DokuWiki MCP plugin configuration.

  3. Configure userSettings

    Enter the following values in the plugin userSettings:

    Setting Value Required
    DOKUWIKI_URL https://wiki.satware.com (or your wiki URL) yes
    DOKUWIKI_TOKEN Your JWT Bearer token yes
    DOKUWIKI_DEFAULT_NAMESPACE (optional) Default namespace no
    DEBUG true or false no
    LOG_LEVEL info (default) or debug no

  4. Verify MCP Connector

    Confirm the connector settings:

    • Connector URL: https://mcp-vps.satware.ai
    • Auth Token: as configured

  5. Save and Activate

    Save the configuration. The plugin spawns the Docker container automatically on the first chat session.

Token Generation

Section titled “Token Generation”

DokuWiki 2024-02-06b “Kaos” has built-in JWT support. Generate a token inside the DokuWiki container:

$token = \dokuwiki\JWT::fromUser("admin");
$token->save();
echo $token->getToken();

Copy the output token into the DOKUWIKI_TOKEN field of the TypingMind userSettings.

Test Your First Chat

Section titled “Test Your First Chat”

Open a new chat and test with a simple prompt:

You: What DokuWiki version are we running?

The assistant automatically calls dokuwiki_get_wiki_info and responds with the version number, wiki title, and other information.

For more prompts to try, see Example Prompts.

Configure DokuWiki

Section titled “Configure DokuWiki”

Make sure your DokuWiki has the JSON-RPC API enabled:

Setting Value Description
remote 1 Enable JSON-RPC API
remoteuser @user Authenticated users only

The API is available at https://your-wiki/lib/exe/jsonrpc.php.

See Installation for detailed Docker configuration.

Troubleshooting

Section titled “Troubleshooting”

If the plugin doesn’t work, check:

  1. Docker image available: docker pull git.satware.ai/satware.ai/mcp-dokuwiki:latest
  2. JWT token valid: Regenerate the token and update it in userSettings
  3. DokuWiki API enabled: remote = 1 in DokuWiki settings
  4. MCP Connector reachable: https://mcp-vps.satware.ai responds
  5. Health check: Test CLI command from Installation

For detailed error descriptions and solutions, see Common Errors.

Section titled “Related Pages”