KI-Coding-Agenten arbeiten zunehmend mit lebenden Applikationen — sie navigieren Oberflächen, lesen Strukturen und führen Aktionen aus. Dabei fehlt ihnen oft der Kontext, den menschliche Entwickler:innen intuitiv aus visuellen Cues ableiten: Was ist dieses Element? Welchen Zweck erfüllt diese Sektion? Das Agentation-Projekt löst dieses Problem mit einem direkten Ansatz: visuelle UI-Annotationen, die explizit für KI-Coding-Agenten hinterlegt werden.
Die TYPO3-Agentation-Extension bringt dieses Konzept in das TYPO3-Ökosystem. Redakteur:innen und Entwickler:innen können direkt im Browser — im Frontend wie im Backend — Kontext-Annotationen hinterlegen, ohne den gewohnten Editor-Workflow verlassen zu müssen.
Inhaltsverzeichnis
Überblick
Funktionen im Detail
Installation
Fazit
Überblick
Das Agentation-Projekt definiert ein Konzept für visuelle UI-Annotationen, die explizit an KI-Coding-Agenten adressiert sind: Statt dass ein Agent eine Oberfläche durch Scraping und Heuristik interpretiert, hinterlegen Entwickler:innen und Redakteur:innen direkt strukturierte Kontextinformationen an UI-Elementen. Die Annotationen beschreiben Zweck, Einschränkungen und Zusammenhänge — maschinenlesbar, aber auch im Browser sichtbar.
Die TYPO3-Extension überträgt dieses Modell auf zwei Ebenen: das TYPO3-Frontend (via Admin Panel Toolbar) und das TYPO3-Backend (Toolbar in Modul-Content-Frames). Beide Ebenen sind pro Nutzer:in aktivierbar — die Sichtbarkeit der Annotationsschicht wird in den persönlichen TYPO3-Einstellungen gesteuert, ohne globalen Eingriff in die Oberfläche.
Für die MCP-Anbindung bringt die Extension ein Backend-Modul „System > Agentation" mit: Es zeigt die MCP-Konfiguration, den Status lokaler und serverseitiger agentation-mcp-Server und stellt einen Same-Origin-Backend-Proxy für lokale agentation-mcp-Server bereit. KI-Coding-Agenten können über diesen Proxy auf Annotationen zugreifen, ohne direkte Netzwerkrouten zu lokalen Diensten zu benötigen.
Diese Extension setzt TYPO3 ^14.3 und PHP ^8.2 voraus. Für den Einsatz mit MCP-basierten KI-Agenten wird ein kompatibler agentation-mcp-Server benötigt. Die vorgefertigten Vite-Assets werden mit der Extension ausgeliefert — Node.js ist zur Installation nicht erforderlich.
Agentation-Konfiguration im Systembereich: Das Modul bündelt MCP-Status, Same-Origin-Proxy und Client-Setup, damit Coding-Agenten auf kuratierte TYPO3-Kontexte zugreifen.
Funktionen im Detail
| Funktion | Nutzen |
|---|---|
| Frontend-Toolbar (Admin Panel) | Injiziert die Agentation-Annotationsschicht in die TYPO3-Frontend-Vorschau via Admin Panel — pro Nutzer:in in den persönlichen TYPO3-Einstellungen aktivierbar. |
| Backend-Toolbar in Modul-Content-Frames | Zeigt die Annotationsschicht direkt in Backend-Modul-Content-Frames. Entwickler:innen können Kontext-Annotationen hinterlegen, ohne das Backend zu verlassen. |
| Backend-Modul „System > Agentation" | Zentrale Konfigurationsoberfläche: MCP-Server-Konfiguration, Status lokaler und serverseitiger agentation-mcp-Server, Annotationsliste und Löschen-Funktion. |
| Same-Origin-Backend-Proxy | Proxy für lokale agentation-mcp-Server: KI-Coding-Agenten können über TYPO3-Backend-Routen auf lokale MCP-Dienste zugreifen — kein direktes Netzwerkrouting nötig. |
| Context-Gate | Verhindert, dass die Annotationsschicht versehentlich auf Production-Umgebungen sichtbar wird. Annotations-UI ist nur in konfigurierten Umgebungen aktiv. |
| Per-User-Einstellungen | FE- und BE-Toolbar-Sichtbarkeit wird pro Nutzer:in gesteuert — kein globaler Eingriff, kein Overhead für Nutzer:innen ohne KI-Agenten-Workflow. |
| Vorgefertigte Vite-Assets | Die Extension liefert kompilierte Frontend-Assets aus. Kein Node.js-Build-Schritt zur Installation nötig — vereinfacht Deployment und CI/CD. |
Das Zusammenspiel von Frontend-Toolbar, Backend-Toolbar und MCP-Modul ergibt einen durchgängigen Workflow: Redakteur:innen annotieren Inhalte im Frontend-Kontext, Entwickler:innen hinterlegen Backend-Modul-Kontext, und der KI-Coding-Agent ruft alle Annotationen über den MCP-Server ab — direkt aus dem Editor, ohne separates Dokumentations-Tool.
Das Context-Gate ist dabei eine bewusste Sicherheitsvorkehrung: KI-Annotationen können interne Strukturinformationen enthalten, die nicht in Production sichtbar sein sollten. Die Extension unterscheidet Umgebungskontexte und aktiviert die Annotationsschicht nur dort, wo sie gewünscht ist.
Installation
composer config repositories.typo3-agentation vcs https://github.com/dirnbauer/typo3-agentation.git
composer require webconsulting/agentationHäufige Fragen
Fazit
Die TYPO3-Agentation-Extension verbindet den gewohnten Redaktions- und Entwicklungsworkflow mit der wachsenden Klasse von KI-Coding-Agenten. Statt Agenten per Scraping und Heuristik interpretieren zu lassen, hinterlegen Teams strukturierten Kontext direkt im Browser — ohne den Editor zu verlassen, ohne Node.js zu installieren, ohne Production-Systeme zu exponieren.
Die Extension implementiert das Agentation-Annotationskonzept auf Basis der Admin-Panel- und Backend-APIs von TYPO3 v14. Dank an das TYPO3-Core-Team und die Community. Die Extension steht unter der GPL-Lizenz.