Der Server kennt genau zwei Einstellungen. Alles andere (Timeout, Größenlimits) ist fest im Code verdrahtet.
| Variable | Pflicht | Standard | Beschreibung |
|---|---|---|---|
WIKIJS_API_URL |
ja | keiner | GraphQL-Endpunkt deiner Wiki.js-Instanz, z. B. https://wiki.example.com/graphql |
WIKIJS_API_TOKEN |
ja | keiner | API-Key von Wiki.js, wird als Bearer-Token gesendet |
Fehlt eine der beiden Variablen, beendet sich der Server beim Start mit Exit-Code 1 und der Meldung Error: Missing required environment variables. Ob die URL tatsächlich auf /graphql endet, prüft der Server nicht; er sendet die Anfragen an die URL genau so, wie sie konfiguriert ist.
Die Reihenfolge ist fest:
~/.claude/mcp-servers/wikijs/.env (im Home-Verzeichnis des Benutzers, der den Server startet), wird ausschließlich diese Datei geladen..env aus dem aktuellen Arbeitsverzeichnis des Prozesses.Die
.envim Repository wird nur gefunden, wenn der Prozess mit dem Repository als Arbeitsverzeichnis gestartet wird. Startet dein MCP-Client den Server aus einem anderen Verzeichnis, legst du die Datei besser unter~/.claude/mcp-servers/wikijs/.envab oder setzt die Variablen in der Client-Konfiguration.
Variablen, die schon in der Umgebung des Prozesses gesetzt sind (zum Beispiel über die Client-Konfiguration), werden von der .env-Datei nicht überschrieben.
Beispiel für die .env:
WIKIJS_API_URL=https://wiki.example.com/graphql
WIKIJS_API_TOKEN=dein-api-token-hier
MCP Server..env-Datei.Die .env.example nennt als benötigte Rechte read:pages, write:pages und manage:pages. Der Server selbst prüft keine Rechte; ob ein Aufruf erlaubt ist, entscheidet allein Wiki.js. Ein Key ohne Schreibrechte führt bei den schreibenden Tools zu einer Fehlermeldung von Wiki.js, siehe Fehlerbehebung.
Diese Werte lassen sich nicht konfigurieren.
| Limit | Wert | Wirkung |
|---|---|---|
| API-Timeout | 30 Sekunden | Danach bricht die Anfrage mit Request timed out. Please try again. ab |
| Kürzung beim Lesen | 100.000 Zeichen | Längerer Seiteninhalt wird beim Abruf gekürzt und mit einem Hinweis versehen |
| Inhalt beim Schreiben | max. 500.000 Zeichen | Größere content-Werte lehnt die Validierung ab |
| Tags pro Seite | max. 50, je max. 100 Zeichen | Validierung |
| Seiten pro Listenaufruf | Standard 50, max. 200 | Validierung von limit |
| Titel | max. 200 Zeichen | Validierung |
| Beschreibung | max. 500 Zeichen | Validierung |
| Suchbegriff | 2 bis 200 Zeichen | Validierung |
| Seitenpfad | 1 bis 500 Zeichen, siehe Tools-Referenz | Validierung |