English Version

Zurück zur Übersicht

Wiki.js Plugin: Tools

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Der MCP-Server wikijs-mcp stellt zehn Tools bereit. Sieben davon sprechen mit der Wiki.js-GraphQL-API, drei arbeiten ausschließlich auf der lokalen SQLite-Datenbank.

Gemeinsame Regeln

Alle Eingaben werden geprüft, bevor eine Anfrage an Wiki.js geht.

Die Datenbank-Spalte der Wiki.js-Beschreibung ist in der Praxis auf 255 Zeichen begrenzt. Halte die Beschreibung unter 250 Zeichen, sonst scheitert das Speichern in Wiki.js, obwohl die Validierung des Tools 500 erlaubt.

Pfade mit Punkt oder Nicht-ASCII-Zeichen lehnt die Validierung ab. Solche Seiten sprichst du über ihre id an.

Fehler kommen als normales Tool-Ergebnis zurück. Typische Meldungen: Page not found at path: ..., Either "id" or "path" must be provided, HTTP error! status: ..., GraphQL request failed: ..., Request timed out. Please try again..

wikijs_create_page

Legt eine neue Seite an. Existiert unter dem Pfad schon eine Seite, schlägt der Aufruf fehl.

Rückgabe: message (Page created successfully at /<pfad>) und page mit id, path, title.

wikijs_update_page

Ändert eine bestehende Seite. Die Seite wird über id oder über path plus locale bestimmt.

*Eine der beiden Angaben id oder path ist Pflicht.

Was nicht mitgeschickt wird, bleibt erhalten: Der Server lädt die Seite und sendet Inhalt, Titel, Beschreibung und Tags unverändert mit. Das gilt nicht für den Veröffentlichungsstatus.

Sende bei jedem Update einer veröffentlichten Seite isPublished: true mit. Ohne diesen Parameter schickt der Server keinen Status, und Wiki.js speichert die Seite als Entwurf.

content ersetzt den kompletten Seiteninhalt, es gibt kein Patchen. Lade die Seite zuerst mit wikijs_get_page und sende den vollständigen neuen Text.

Schrumpf-Schutz (confirmContentShrink)

Ist der alte Inhalt mindestens 200 Zeichen lang und der neue Inhalt kürzer als die Hälfte des alten, lehnt der Server das Update ab. Die Fehlermeldung nennt beide Längen. Ist die Kürzung gewollt (zum Beispiel beim Umbau eines Hubs auf eine Kurzfassung), wiederhole den Aufruf mit confirmContentShrink: true. Der Schutz greift nur, wenn content mitgeschickt wird.

Rückgabe: message (Page <id> updated successfully) und result (Wiki.js-Antwort mit succeeded, errorCode, message).

Nicht änderbar über dieses Tool sind isPrivate und der Editor-Typ.

wikijs_get_page

Liest eine Seite per id oder per path plus locale (Standard en).

Rückgabe: id, path, title, description, content, contentType, isPublished, locale, createdAt, updatedAt.

Inhalte über 100.000 Zeichen werden gekürzt und mit dem Hinweis [Content truncated. Original length: ... chars. ...] abgeschlossen.

Den updatedAt-Wert brauchst du für wikijs_mark_verified. Lies ihn nach dem letzten Publish.

wikijs_list_pages

Rückgabe: pages (je Seite id, path, title, description, locale, isPublished, tags, updatedAt) und pagination mit limit, offset, total_count, has_more und, solange es weitere Seiten gibt, next_offset. Der Server holt dafür jedes Mal alle Seiten von Wiki.js und filtert und schneidet lokal. total_count gilt nach dem Locale-Filter.

wikijs_search_pages

Rückgabe: totalHits, suggestions und results (je Treffer id, title, path, description, locale). Der Locale-Filter wird erst nach der Suche angewendet.

wikijs_delete_page

Löscht eine Seite endgültig. Parameter wie bei wikijs_get_page (id oder path, locale). Rückgabe: message (Page <id> deleted permanently) und result.

Das Löschen ist nicht rückgängig zu machen. Frage vorher nach.

wikijs_move_page

Rückgabe: message, from, to, destinationLocale, result.

Die URL der Seite ändert sich, Links müssen nachgezogen werden. Historie-Einträge und verified-Marker sind nach dem Pfad abgelegt: Nach einem Verschieben bleiben sie beim alten Pfad, die Seite gilt am neuen Pfad als nie verifiziert.

wikijs_get_page_history

Liest die lokal geloggte Änderungshistorie. Ruft Wiki.js nicht auf.

Rückgabe: path und entries. Jeder Eintrag hat id, page_path, changed_at (UTC), locale, source_repo, source_ref, summary, verified und page_updated_at. verified ist nur bei Einträgen von wikijs_mark_verified gleich 1. Bei Einträgen aus create/update heißt source_ref nur: Die Seite wurde bei diesem Stand geschrieben.

Geloggt werden nur Aufrufe, bei denen mindestens eines von sourceRepo, sourceRef, summary gesetzt war.

wikijs_mark_verified

Hält fest, dass eine Seite bei einem bestimmten Commit gegen den Quellcode geprüft wurde. Schreibt nur in die lokale Datenbank, ändert die Wiki.js-Seite nicht und prüft weder, ob die Seite existiert, noch, ob der Ref gültig ist.

Leere Werte (nach Entfernen von Leerzeichen und Zeilenumbrüchen) für sourceRepo, sourceRef oder pageUpdatedAt lehnt das Tool ab. Pfade mit .., //, abschließendem Slash oder Leerzeichen werden abgelehnt.

Rückgabe: message (Marked /<pfad> (<locale>) as verified at <ref>).

wikijs_get_verified_refs

Liefert je Seite und Sprache den neuesten verifizierten Ref. Seiten, die nie markiert wurden, erscheinen nicht, auch wenn sie einen geschriebenen sourceRef haben. Ruft Wiki.js nicht auf.

Rückgabe: entries mit page_path, locale, source_repo, source_ref, page_updated_at, verified_at.

Der Marker gilt nur, solange page_updated_at mit dem aktuellen updatedAt der Seite aus Wiki.js übereinstimmt. Das Tool vergleicht nicht selbst, das übernimmt der Skill source-check.

Tool-Hinweise (Annotations)

Wie die Tools zusammenspielen, zeigt die Seite Arbeitsabläufe.