MZP Knowledge Engine · Report · 2026-08-15

KI-Agenten im Maierzone Publisher

Wie Claude-Instanzen — dieser Agent eingeschlossen — den mzone-publisher MCP-Server nutzen: Datenfluss, Routing-Entscheidung, Publish-Sequenz, Seiten-Lebenszyklus, Architektur-Schichten und Wirkungsradius eines einzelnen Tool-Calls.

01 · Architektur

KI-Agent im MZP-Ökosystem

Der Agent hat genau eine Tür in das System: den MCP-Server. Alles dahinter — Rendering, Storage, Auslieferung — bleibt VPS-intern.

KI-Agent im MZP-Ökosystem Architekturdiagramm: Ein KI-Agent ruft ausschließlich den mzone-publisher MCP-Server auf; dieser schreibt in Postgres und übergibt Rendering an eine Freemarker-Template-Engine, während NGINX Leser über /published/ bedient — alles hinter einer VPS-Vertrauensgrenze. VPS · DOCKER (MAIERZONE.DE) MCP WRITE HTTPS AGT KI-Agent Claude Code / Instanzen MCP mzone-publisher MCP-Server · Spring TPL Template-Engine Freemarker wiki-page DB Postgres published_pages Flyway-Schema WEB NGINX /published/{slug} EXT Leser Browser / Nutzer LEGEND MCP-Server · Fokus HTTP / MCP-Aufruf Primärer Schreibpfad Interne Verbindung Render bei Bedarf Vertrauensgrenze

Nur der MCP-Server hat einen Türgriff auf beiden Seiten — Agent und Postgres treffen sich nie direkt.

02 · Routing-Entscheidung

Wiki-Seite oder Artefakt-Bundle?

ADR-006: strukturierter Wissenstext läuft über die Wiki-Template-Strecke, interaktives HTML läuft über publishArtifact — nie beide für denselben Slug.

Wiki-Seite oder Artefakt-Bundle? Flussdiagramm nach ADR-006: eine Entscheidung, ob neuer Content interaktiv ist, routet entweder zu publishPage mit dem wiki-page-Template oder zu einer dreistufigen Artefakt-Kette aus getCapabilities, validateArtifact und publishArtifact, die beide am selben veröffentlichten Slug enden. NEIN JA NEIN · FIX JA Neuer Content Interaktiv? HTML-App · 3D · Report publishPage() wiki-page Template flache Slugs · wiki-svc-* getCapabilities() Limits · Slug-Regeln · Libs validateArtifact() kein Write liefert TTL-Preview-URL Preview OK? Stil · Slugs geprüft publishArtifact() slug · files · overwrite? alte Version bleibt (listVersions) Slug live unter /published/{slug}

Nie beide Strecken für denselben Slug — ein Wiki-Text und ein Artefakt-Bundle sind verschiedene Datenmodelle.

03 · Ablauf

Artefakt-Publish-Sequenz

Drei Aufrufe, ein Schreibvorgang: der Agent sieht die Grenzen und den Preview-Stand, bevor irgendetwas persistiert wird.

Artefakt-Publish-Sequenz Sequenzdiagramm zwischen KI-Agent, MCP-Server und Storage: getCapabilities und validateArtifact liefern Grenzen und eine Preview-URL zurück, dann schreibt publishArtifact optional versioniert nach Storage und der Server antwortet mit der finalen Live-URL als Erfolgsmeldung. KI-Agent MCP-Server Storage getCapabilities() Limits · Styling-Katalog validateArtifact() Preview-URL (TTL) publishArtifact(slug, files) OPT [overwrite = true] Version anlegen alte Version bleibt /published/{slug} · live

"overwrite=true" löscht nichts — es legt eine neue Version an und lässt die alte über listVersions/rollbackArtifact erreichbar.

04 · Lebenszyklus

Page-Lifecycle

PageStatus läuft unabhängig von der Versionsgeschichte — vier echte Zustände aus PublishedPage.java, gesetzt über setPageLifecycle().

Page-Lifecycle Zustandsdiagramm der vier PageStatus-Werte CURRENT, DRAFT, SUPERSEDED und ARCHIVED: eine Seite startet bei CURRENT, kann über setPageLifecycle zwischen DRAFT und CURRENT wechseln oder auf SUPERSEDED beziehungsweise ARCHIVED gesetzt werden, und wird über deletePage endgültig gelöscht. publishPage() publishArtifact() CURRENT setPageLifecycle [status=draft] setPageLifecycle [status=current] DRAFT setPageLifecycle [supersededBy=slug] SUPERSEDED setPageLifecycle [status=archived] ARCHIVED deletePage() hart · endgültig jeder Zustand kann ebenso archiviert werden

SUPERSEDED ist der eine Zustand, den ein gewöhnliches CMS nicht hat: die Nachfolgekette wird vor jedem Schreiben auf Zyklen geprüft.

05 · Schichten

Knowledge-Engine Schichten

Fünf Schichten von Agent-Absicht bis ausgeliefertem Byte — das MCP-Protokoll ist die Schicht, die alles andere über 28 Tools erreichbar macht.

Knowledge-Engine Schichten Schichtdiagramm von fünf Abstraktionsebenen: KI-Agent oben, darunter die MCP-Protokollschicht mit 28 Tools als hervorgehobene Kernschicht, dann Template-Engine, PostgreSQL und zuunterst NGINX als Auslieferungsschicht. ABSTRAKTION ↓ L1 KI-Agent Ingest · Query · Lint L2 MCP-Protokoll 28 Tools · publishPage … deletePage L3 Template-Engine Freemarker wiki-page · Artifact-Bundle L4 PostgreSQL published_pages · Versionierung L5 NGINX /published/{slug}/{pfad} · MIME-Type

L2 ist die einzige Schicht, die ein Agent je direkt anspricht — alles darunter ist Implementierungsdetail.

06 · Wirkungsradius

Wirkungsradius eines KI-Agent-Calls

Vier Containment-Ebenen zwischen VPS und einer einzelnen Datenbankzeile — je tiefer, desto präziser der Blast-Radius eines einzelnen Tool-Calls.

Wirkungsradius eines KI-Agent-Calls Verschachteltes Containment-Diagramm mit vier Ebenen: die maierzone VPS umschließt den mzone-publisher Service, der die MCP-Tool-Grenze mit 28 Tools umschließt, die wiederum als innerste, hervorgehobene Ebene genau eine Zeile in published_pages umschließt. MAIERZONE VPS · DOCKER · PM2 · NGINX MZONE-PUBLISHER SERVICE MCP TOOL-GRENZE · 28 TOOLS 1 ZEILE · PUBLISHED_PAGES Genau diese Zeile ändert sich slug · content · metadata · lifecycle nie den Container, nie die NGINX-Config

publishArtifact() und publishPage() bleiben Postgres-Schreiber — sie berühren nie Docker-Compose, NGINX-Config oder das VPS selbst.

Anhang

Tool-Katalog nach Kategorie

Alle mcp__claude_ai_Mzone-Publisher__* Tools, gruppiert nach der Rolle, die sie im Datenfluss oben spielen.

Publish

6
  • publishPage
  • publishArtifact
  • publishAsset
  • publishRawPage(Compressed)
  • mergePageContext

Query

8
  • getPageContext
  • searchPages · fullTextSearch
  • listPublishedPages
  • getPageHistory · getPageStats
  • listAssetUsage · getArtifactSource

Lifecycle

4
  • setPageLifecycle
  • deletePage
  • listVersions
  • rollbackArtifact

Preview

3
  • renderPreview
  • revokePreview
  • validateArtifact

Meta / Lint

5
  • getCapabilities
  • listTemplates · getTemplate
  • lookupStyles
  • lintWiki
Maierzone Knowledge Engine · KI-Agenten im MZP diagram-design · maierzone-Profil · 2026-08-15