Ein Wiki privater Natur

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:

  1. Administration: API ist eingeschaltet.
  2. Administration: persoenliche Zugriffstokens sind erlaubt ("Erlaube persönlichen Zugriffstoken").
  3. Der Benutzer ist Mitglied einer Gruppe mit dem Recht use:mcp.
  4. Beim Anlegen des Tokens muss der Scope mcp (KI/MCP) mit ausgewaehlt werden. Dieser Scope erscheint in der Auswahl erst, wenn use:mcp wirksam 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:

  1. System API keys cannot be used here : falscher Token-Typ, PAT verwenden.
  2. The owner of this token does not hold the use:mcp permission : Gruppenrecht fehlt.
  3. This personal access token does not not have the mcp scope : Token ohne mcp-Scope, neu anlegen.
  4. Handshake-Antwort mit serverInfo: Verbindung steht.

Verfuegbare Werkzeuge

21 Tools, u.a.:

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