WP-LIT-MCP/docs/guides/overview.md

LIT MCP – Übersicht

Dieser Server pflegt eine WordPress-Website. Alle Änderungen laufen mit den Rechten des verbundenen WordPress-Benutzers.

Grundregeln

1. Divi-nativ: Inhalte werden als echte Divi-5-Module erzeugt, damit sie im Visual Builder weiter bearbeitet werden können. Das Code-Modul nur verwenden, wenn kein natives Modul passt.
2. Designsystem nutzen: Globale Farben, Variablen und Presets der Website vor festen Werten verwenden.
3. Status respektieren: Entwürfe bleiben Entwürfe, veröffentlichte Inhalte bleiben veröffentlicht. Veröffentlichen nur auf ausdrücklichen Wunsch.
4. Lesen vor Schreiben: Vor Änderungen den aktuellen Stand lesen; Schreib-Tools verlangen den rev des letzten Lesevorgangs.

Werkzeuge

Direkt sichtbar: lit-guide, lit-site-status, lit-content-types, lit-content-query, lit-content-get, lit-content-create, lit-content-update, lit-post-publish, lit-media-search, lit-media-preview, lit-media-download, lit-media-upload-from-url, lit-page-render-summary, lit-divi-outline, lit-divi-node-get, lit-divi-catalog, lit-divi-design-system, lit-divi-insert, lit-divi-update, lit-divi-move, lit-divi-delete, lit-library-insert.

Die Tools sind nach Integration gruppiert (Grundlagen, WordPress, Medien, Divi, Divi-Bibliothek). Jede Gruppe hat unter Einstellungen → LIT MCP → Tools eine eigene Einstellung (direkt/indirekt/deaktiviert), die ihre Tools übernehmen („wie Gruppe“). Eine Einstellung am einzelnen Tool geht vor; die Gruppe zeigt dann „gemischt“. „nur lesen“ schaltet alle schreibenden Tools der Gruppe ab – auch solche mit eigener Einstellung. lit-guide bleibt immer direkt; lit-media-preview/lit-media-download bleiben bei Gruppe „indirekt“ direkt. Ab mehr als 25 direkten Tools warnt die Seite (Kontextkosten im Assistenten). Änderungen gelten ab der nächsten Verbindung.

Über mcp-adapter-discover-abilities / mcp-adapter-execute-ability (Ability-Namen lit/…; in Guides und Hinweisen immer so geschrieben): Status (lit/post-unpublish, lit/post-schedule, lit/post-trash), Kopien (lit/post-duplicate, lit/post-replace-with-copy), Revisionen (lit/revisions-list, lit/revision-restore), Menüs (lit/menu-list, lit/menu-get, lit/menu-create, lit/menu-set-items, lit/menu-assign-location), Einstellungen (lit/wp-settings-get, lit/wp-settings-update), Medien (lit/media-get, lit/media-upload, lit/media-update, lit/media-delete), Divi (lit/divi-duplicate-node, lit/divi-replace-text, lit/divi-node-copy), Divi-Bibliothek (lit/library-list, lit/library-save).

Die lit-divi-…-Werkzeuge gibt es nur, wenn der Divi-5-Builder aktiv ist.

Weitere Themen: lit-guide mit topic = content-types, workflows, media, divi-structure, divi-shortform, divi-attrs, divi-placeholders oder divi-design-system.

Rückmeldungen

• Erfolg: ok, summary, changed, warnings, rev, revision_id (Revision mit dem Stand vorher, nur bei Tools, die Inhalt überschreiben, sonst null), log_id, URLs. Divi-Werkzeuge zusätzlich tree_rev (Stand des Seiteninhalts, Pflicht für die nächste Divi-Änderung) und outline (betroffener Abschnitt); lit/divi-replace-text nennt tree_rev je Seite in results (Probelauf: in matches).
• Fehler: JSON mit code (z. B. validation_failed, rev_mismatch, write_failed, partial_write), message, hint (und ggf. fields). Dem hint folgen.
• confirm_required: Nutzer fragen, dann mit confirm: true wiederholen.