Wiki.js MCP-Anbindung einrichten
Einrichtung des eingebauten MCP-Servers in Wiki.js 3.5: Token-Typen, Gruppenrecht use:mcp, Scope und die Fallstricke dabei.
Wiki.js 3.5 bringt einen eingebauten MCP-Server mit (Model Context Protocol, Streamable HTTP). Damit kann ein KI-Assistent Seiten suchen, lesen, anlegen und bearbeiten. Die Einrichtung hat ein paar Stolpersteine, die hier dokumentiert sind.
Endpoint
Der MCP-Endpunkt liegt unter https://daucity.de/_mcp. Ein MCP-Client verbindet sich per HTTP mit einem Bearer-Token:
claude mcp add --transport http wiki https://daucity.de/_mcp --header "Authorization: Bearer YOUR-TOKEN"
Wichtig: Der klassische GraphQL-Endpunkt unter /graphql ist für System-API-Keys in 3.5 nicht mehr der Weg. Anfragen dorthin laufen ins Leere (Fastify-404). Für MCP ist /_mcp zuständig.
Token-Typen: System-API-Key gegen persoenliches Token
Der MCP-Endpunkt nimmt keine System-API-Keys an. Diese handeln mit den Rechten von Gruppen und sind an keinen Benutzer gebunden, koennen also keine inhaltlichen Aktionen ausfuehren. Es muss ein persoenliches Zugriffs-Token (PAT) sein, angelegt unter Profil, dann Access Tokens (nicht Administration, dann API).
Voraussetzungen dafuer:
- Administration: API ist eingeschaltet.
- Administration: persoenliche Zugriffstokens sind erlaubt ("Erlaube persönlichen Zugriffstoken").
- Der Benutzer ist Mitglied einer Gruppe mit dem Recht
use:mcp. - Beim Anlegen des Tokens muss der Scope
mcp(KI/MCP) mit ausgewaehlt werden. Dieser Scope erscheint in der Auswahl erst, wennuse:mcpwirksam ist.
Berechtigung use:mcp setzen
Das Recht use:mcp wird im Gruppeneditor gesetzt. Kontrollieren laesst es sich direkt in der Datenbank. Wiki.js 3.5 legt alle Tabellen im Schema wiki ab, nicht in public:
docker exec -it wikijs3-db-1 psql -U wikijs -d wiki -c 'SELECT id, name, permissions FROM wiki."groups";'
In unserem Fall hatte die Gruppe mcp ein leeres permissions-Array. Der Fehler zeigt sich am MCP-Endpunkt als:
The owner of this token does not hold the use:mcp permission. An administrator grants it to a group.
Fix per SQL (Gruppe-ID aus der obigen Abfrage entnehmen):
docker exec -it wikijs3-db-1 psql -U wikijs -d wiki -c "UPDATE wiki."groups" SET permissions = '["use:mcp"]'::jsonb WHERE id = 'GRUPPEN-ID';"
Reihenfolge der Fehlermeldungen am Endpunkt
Die Meldungen am Endpunkt sind gut verstaendlich und fuehren Schritt fuer Schritt zum Ziel:
System API keys cannot be used here: falscher Token-Typ, PAT verwenden.The owner of this token does not hold the use:mcp permission: Gruppenrecht fehlt.This personal access token does not not have the mcp scope: Token ohne mcp-Scope, neu anlegen.- Handshake-Antwort mit
serverInfo: Verbindung steht.
Verfuegbare Werkzeuge
21 Tools, u.a.:
- Lesen:
search_pages,browse_tree,get_page,recent_changes,list_tags - Historie:
list_versions,get_version,diff_versions - Schreiben:
create_page,update_page(Find-and-Replace-Edits mit Begruendung),suggest_edit - Glossar:
lookup_term,define_term,update_term - Diskussion:
list_comments,post_comment - Navigation:
get_navigation,update_navigation
Der Server schickt beim Handshake eigene Hinweise fuer Assistenten mit: vor dem Antworten im Wiki suchen, Seiten vor dem Bearbeiten lesen und mit versionId aktualisieren, jede Aenderung mit einem Grund versehen, fehlgeschlagene Aktionen per Kommentar melden.
Anmerkung zur Datenbank
Wer mit \dt in psql keine Tabellen sieht, sucht im falschen Schema. Wiki.js 3.5 arbeitet mit dem eigenen Schema wiki:
docker exec -it wikijs3-db-1 psql -U wikijs -d wiki -c '\dt wiki.*'
Das ist kein Konfigurationsfehler, sondern das Datenmodell der 3er-Version.
Sicherheit
- Tokens begrenzen: nur die Scopes setzen, die noetig sind.
- Die Burst- und Auffuellraten-Limits der MCP-Einstellungen greifen auch bei versehentlich schnellen Aufrufserien.
- Von Assistenten angelegte Seiten erscheinen als Entwurf und sind fuer Leser unsichtbar, bis jemand sie veroeffentlicht.