English version

Zurück zur Übersicht

Installation

Der Server wird aus dem Quellcode gebaut. Das Repository enthält kein vorkompiliertes dist/-Verzeichnis, du musst also vor dem ersten Start bauen.

Voraussetzungen

• Node.js 18 oder neuer
• npm
• eine Wiki.js-Instanz und ein API-Key (siehe Konfiguration)

Schritt für Schritt

git clone https://github.com/markus-michalski/wikijs-mcp-server.git
cd wikijs-mcp-server
npm install
npm run build

npm run build ruft den TypeScript-Compiler (tsc) auf und schreibt das Ergebnis nach dist/. Der Einstiegspunkt ist dist/index.js.

Zugangsdaten hinterlegen

Der Server braucht WIKIJS_API_URL und WIKIJS_API_TOKEN. Die Vorlage liegt im Repository:

cp .env.example .env

Wo die .env liegen muss, damit der Server sie findet, steht auf der Seite Konfiguration. Alternativ kannst du beide Variablen in der Konfiguration deines MCP-Clients als Umgebungsvariablen setzen.

Beim MCP-Client registrieren

Der Client muss den Server als stdio-Prozess starten: node /pfad/zu/wikijs-mcp-server/dist/index.js. Bei Claude Code zum Beispiel:

claude mcp add -s user wikijs node /pfad/zu/wikijs-mcp-server/dist/index.js

Starte den Client danach neu. Beim Start schreibt der Server auf stderr, mit welchem Host er verbunden ist (nur der Hostname, nicht der Token).

Funktion prüfen

Der Server sollte im Client als verbunden erscheinen (bei Claude Code über /mcp). Ein einfacher Test ist ein Aufruf von wikijs_list_pages mit limit 5.

Aktualisieren

cd wikijs-mcp-server
git pull
npm install
npm run build

Starte den MCP-Client danach neu, damit er den neuen Build lädt.

Deinstallieren

1. Entferne den Server aus der Konfiguration deines MCP-Clients (bei Claude Code zum Beispiel mit claude mcp remove wikijs).
2. Lösche das Verzeichnis wikijs-mcp-server und, falls vorhanden, die .env-Datei mit dem Token.
3. Widerrufe den API-Key in der Wiki.js-Administration unter API Access.