Zum Inhalt springen
satware® AI DokuWiki MCP

TypingMind-Setup

Voraussetzungen

Abschnitt betitelt „Voraussetzungen“
  • TypingMind-Instanz mit Admin-Zugriff
  • Docker-Image git.satware.ai/satware.ai/mcp-dokuwiki verfügbar
  • DokuWiki JWT Bearer-Token
  • MCP Connector erreichbar (https://mcp-vps.satware.ai)

Zugang zu chat.satware.ai

Abschnitt betitelt „Zugang zu chat.satware.ai“

Wenn Sie keine eigene TypingMind-Instanz betreiben, können Sie Zugang zur satware® AI Plattform buchen:

Zugang buchensatware.ai/zugang - persönlichen Zugang anfordern.
Kostenlose Webinaresatware.ai/webinare - kostenlose Webinare zu satware® AI chat.
WorkshopsKI-Workshops an der vhs Worms - praktische Übungen auf chat.satware.ai.

Plugin importieren

Abschnitt betitelt „Plugin importieren“

  1. Admin-Oberfläche öffnen

    Melden Sie sich in TypingMind an und navigieren Sie zu /admin/plugins.

  2. Plugin importieren

    Klicken Sie auf “Plugin hinzufügen” und wählen Sie als Plugin-Typ MCP. Importieren Sie die DokuWiki MCP-Plugin-Konfiguration.

  3. userSettings konfigurieren

    Tragen Sie die folgenden Werte in die Plugin-userSettings ein:

    Setting Wert Erforderlich
    DOKUWIKI_URL https://wiki.satware.com (oder Ihre Wiki-URL) ja
    DOKUWIKI_TOKEN Ihr JWT Bearer-Token ja
    DOKUWIKI_DEFAULT_NAMESPACE (optional) Standard-Namespace nein
    DEBUG true oder false nein
    LOG_LEVEL info (Standard) oder debug nein

  4. MCP Connector verifizieren

    Bestätigen Sie die Connector-Einstellungen:

    • Connector URL: https://mcp-vps.satware.ai
    • Auth Token: wie konfiguriert

  5. Plugin speichern und aktivieren

    Speichern Sie die Konfiguration. Das Plugin startet den Docker-Container automatisch bei der ersten Chat-Sitzung.

Token-Generierung

Abschnitt betitelt „Token-Generierung“

DokuWiki 2024-02-06b “Kaos” hat integrierte JWT-Unterstützung. Generieren Sie einen Token im DokuWiki-Container:

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

Kopieren Sie den ausgegebenen Token in das DOKUWIKI_TOKEN-Feld der TypingMind-userSettings.

Ersten Chat testen

Abschnitt betitelt „Ersten Chat testen“

Öffnen Sie einen neuen Chat und testen Sie mit einem einfachen Prompt:

Sie: Welche DokuWiki-Version verwenden wir?

Der Assistent führt automatisch dokuwiki_get_wiki_info aus und antwortet mit der Versionsnummer, dem Wiki-Titel und weiteren Informationen.

Weitere Prompts zum Ausprobieren finden Sie unter Beispiel-Prompts.

DokuWiki konfigurieren

Abschnitt betitelt „DokuWiki konfigurieren“

Stellen Sie sicher, dass Ihr DokuWiki die JSON-RPC-API aktiviert hat:

Einstellung Wert Beschreibung
remote 1 JSON-RPC-API aktivieren
remoteuser @user Nur authentifizierte Benutzer

Die API ist erreichbar unter https://your-wiki/lib/exe/jsonrpc.php.

Siehe Installation für detaillierte Docker-Konfiguration.

Fehlersuche

Abschnitt betitelt „Fehlersuche“

Wenn das Plugin nicht funktioniert, prüfen Sie:

  1. Docker-Image verfügbar: docker pull git.satware.ai/satware.ai/mcp-dokuwiki:latest
  2. JWT-Token gültig: Token neu generieren und aktualisieren
  3. DokuWiki API aktiviert: remote = 1 in den DokuWiki-Einstellungen
  4. MCP Connector erreichbar: https://mcp-vps.satware.ai antwortet
  5. Gesundheitsprüfung: CLI-Befehl aus Installation testen

Detaillierte Fehlerbeschreibungen und Lösungen finden Sie unter Häufige Fehler.

Verwandte Seiten

Abschnitt betitelt „Verwandte Seiten“