Das Model Context Protocol (MCP) definiert, wie KI-Agenten und Sprachmodelle standardisiert auf externe Systeme zugreifen. Für TYPO3 bedeutet das: Redakteur:innen und Entwickler:innen können Inhalte, Seitenstrukturen und Konfigurationen direkt aus Cursor, Claude Desktop oder n8n heraus abrufen und bearbeiten – ohne dafür eigene API-Schnittstellen bauen zu müssen. Das Fundament dafür hat Marco Pfeiffer mit hauptsacheNet/typo3-mcp-server gelegt.
Dieser Fork konzentriert das ursprüngliche Konzept auf TYPO3 v14 und ergänzt workspace-sichere Operationen , einen vollständigen OAuth 2.1/PKCE-Transport und ein deklaratives Sicherheitsmodell, das sich ohne Codeänderungen über eine YAML-Datei konfigurieren lässt. Das Ergebnis ist ein MCP-Server, der sowohl im Remote-Betrieb über /mcp als auch lokal via stdio in DDEV funktioniert.
Inhaltsverzeichnis
Überblick
Was wurde gemacht
Funktionen im Detail
Installation
Überblick
MCP-Server fungieren als standardisierte Brücke zwischen einem Sprachmodell und einem externen System. Im TYPO3-Kontext bedeutet das: Ein KI-Assistent kann Seiten anlegen, Inhalte lesen, Workspace-Entwürfe einreichen und Datensätze abfragen – und zwar über eine klar definierte Schnittstelle, die das Modell „versteht", ohne dass es eigene HTTP-Clients oder Authentifizierungslogik implementieren muss.
Der Fork hn/typo3-mcp-server (Extension-Key mcp_server) richtet sich an TYPO3-v14-Installationen und bietet eine produktionsreife Basis für KI-gestützte Redaktions- und Entwicklungsworkflows. Das Backend-Modul „User → MCP Server" bleibt der zentrale Anlaufpunkt für Token-Management und Client-Setup – ohne tiefen Eingriff in bestehende TYPO3-Strukturen.
Diese Extension setzt typo3/cms-core ^14.0, typo3/cms-backend ^14.0 und typo3/cms-workspaces ^14.0 voraus. PHP >=8.2 wird unterstützt, CI läuft für PHP 8.2–8.5. Alle v12/v13-Pfade wurden entfernt.
MCP-Verbindung direkt im Backend: Server-URL, Client-Konfigurationen und OAuth-Token-Verwaltung liegen an der Stelle, an der TYPO3-Nutzer:innen den Zugriff kontrollieren.
Was wurde gemacht
Ausgangspunkt ist hauptsacheNet/typo3-mcp-server von Marco Pfeiffer , das bereits ein solides MCP-Fundament für TYPO3 bietet. Der Fork konzentriert diese Basis vollständig auf TYPO3 v14: Sämtliche v12/v13-Kompatibilitätspfade wurden entfernt, Composer-Constraints auf ^14.0 angehoben und der gesamte Code einem v14-spezifischen Refactoring unterzogen – einschließlich der Korrektur für das in v14 entfernte defaultPageTSconfig und XLIFF-2.0-ICU-Unterstützung.
Inhaltlich erweitert wurden: OAuth 2.1/PKCE-Remote-Transport, ein vollständiges Backend-Modul mit Token-Management, ein lokaler stdio-Modus mit DDEV-Auto-Erkennung und DDEV-Stdio-Fixes. Der Workspace-Workflow erhielt workspace-sichere Operationen ; alle Tools prüfen den aktiven Workspace-Kontext. Neu hinzugekommen sind Dev-Site-Tools (SiteSettings, ViewHelper-Referenz, CreateLocallang, TCA-MCP-Resources), eine Live-Testsuite für LLM-Benchmarks und ein vollständiger CLI-Mirror, der jedes MCP-Tool auch ohne KI-Client ausführbar macht.
Das Sicherheitsmodell wurde grundlegend neu gedacht: Statt hardcodierter Berechtigungen regelt eine deklarative Configuration/Capabilities.yaml den Tool-Umfang. Wer einen Eintrag entfernt, deaktiviert alle davon abhängigen Tools – ohne Codeänderung.
Funktionen im Detail
Discovery & Schema
Navigation & Suche
Lesen & Schreiben
Workspace-Workflow
Sandboxed Dateiverwaltung
Content-Import
Diagnose
Admin & Ops
Der Remote-Transport nutzt OAuth 2.1 mit PKCE über den Endpunkt /mcp. Für lokale Entwicklung und DDEV steht ein stdio-Modus mit Auto-Erkennung bereit. Unterstützte Clients: Cursor, Claude Desktop, n8n – Konfigurationsvorlagen liegen im Backend-Modul. Der CLI-Mirror erlaubt es, jedes der 44 Tools direkt über vendor/bin/typo3 mcp:<tool> mit --json oder --plain aufzurufen – praktisch für Debugging und Scripting ohne KI-Client.
Installation
composer config repositories.typo3-mcp-server vcs https://github.com/dirnbauer/typo3-mcp-server.git
composer require hn/typo3-mcp-server:^14.0Häufige Fragen
Fazit
Ein MCP-Server für TYPO3 ist kein Selbstzweck — er macht TYPO3 für KI-Assistenten bearbeitbar, ohne auf proprietäre Integrationen angewiesen zu sein. Der v14-Fork baut auf einem bewährten Fundament auf und erweitert es gezielt: workspace-sicher, OAuth-gesichert, lokal via DDEV nutzbar und mit einem Sicherheitsmodell, das sich ohne Codeänderungen anpassen lässt. Für Teams, die KI-Agenten in redaktionelle oder technische TYPO3-Workflows einbinden wollen, ist das eine solide Ausgangsbasis.
Dieser Fork basiert auf hauptsacheNet/typo3-mcp-server von Marco Pfeiffer. Dank an Marco Pfeiffer / hauptsacheNet für die Vorarbeit. Das Projekt steht unter der GPL-2.0-or-later-Lizenz.