TYPO3 MCP + AI Suite
AI Suite MCP ist eine eigenständige TYPO3-Extension, die einen MCP-Server (Model Context Protocol) bereitstellt. Damit verbinden sich KI-Clients wie Claude Desktop, Claude.ai, ChatGPT, Claude Code, der MCP Inspector oder Open WebUI direkt mit deinem TYPO3-Backend und steuern es so, wie es sonst ein Redakteur tun würde, ohne den Chat zu verlassen.
Die Funktionen der AI Suite lassen sich dabei mitnutzen. Serverseitige Übersetzungen, Metadaten-Generierung, Bildgenerierung, Audits und Stapelverarbeitung werden nicht neu gebaut, sondern können an die AI Suite übergeben werden. Für diese Tools gelten deshalb dieselben Anbieter, Modelle, Berechtigungen und Credits wie im Backend-Modul, siehe Models & APIs.
Ohne gültigen API-Key der AI Suite bleiben diese Tools zwar sichtbar, jeder Aufruf endet dann aber mit einem Lizenzfehler. Alles, was ohne externen KI-Anbieter auskommt, funktioniert unabhängig davon. Dazu gehören das Lesen des Seitenbaums, die Inhaltssuche, das Anlegen und Bearbeiten von Datensätzen, Textersetzungen, Übersetzungen durch das Modell deines Clients und das Einbinden von Medien. Diese Tools laufen allein über TYPO3 und verbrauchen keine Credits.
Beta-Version
AI Suite MCP befindet sich in aktiver Entwicklung und ist aktuell im Beta-Stadium (Version 0.11.0). Tool-Signaturen, Einstellungsschlüssel und die geplante Schnittstelle für eigene Tools können sich zwischen Minor-Versionen noch ändern. Ein Produktiveinsatz ist möglich, eine feste Version sollte aber gepinnt und vor einem Update der Changelog geprüft werden.
Was kannst du damit machen?
Sobald ein Client verbunden ist, kann das Modell im Rahmen der Berechtigungen des verknüpften Backend-Benutzers unter anderem:
- den Seitenbaum durchlaufen, Seiten lesen und Inhalte durchsuchen,
- Inhalte generieren und optimieren (einzelne Inhaltselemente, Landingpages, ganze Seitenbäume) sowie bestehende Texte umschreiben, kürzen oder vereinfachen,
- übersetzen (einzelne Datensätze, ganze Seiten, Datei-Metadaten, ganze Ordner) in die gewünschte Zielsprache,
- Metadaten in großem Umfang füllen (SEO-Titel, Beschreibungen, OG- und Twitter-Tags, Alt-Texte),
- Bilder direkt nach FAL generieren,
- Datensätze sicher bearbeiten: Schreibende Aktionen laufen über den DataHandler, die Freigabe übernimmt der Dialog deines Clients, und im Standard-Schreibmodus landet jede Änderung als prüfbarer Entwurf in einem Workspace,
- Stapelverarbeitungen im Hintergrund starten, deren Ergebnisse als Vorschläge zur Freigabe zurückkommen,
- und vieles mehr.
Alle Aktionen laufen als der verknüpfte Backend-Benutzer. Seiten- und Datei-Mounts, Tabellen- und Feldrechte sowie die Feature- und Modellrechte der AI Suite werden dabei durchgesetzt.
Ein Teil dieser Aktionen setzt einen gültigen API-Key der AI Suite voraus, weil dahinter ein externes KI-Modell verwendet wird. Fehlt der Key oder stehen nicht genügend Credits zur Verfügung, bleiben die Tools in der Tool-Liste sichtbar und das Modell ruft sie auch auf, der Aufruf endet dann aber mit einem Lizenzfehler. Der strukturelle Teil bleibt davon unberührt. Dazu zählen das Lesen und Suchen, das Anlegen, Ändern, Verschieben, Kopieren und Löschen von Datensätzen, das Anlegen von Übersetzungen sowie das Einbinden vorhandener Medien. Anders bei den Feature-Rechten der Backend-Gruppe: Fehlt dort ein Recht, verschwindet das Tool schon aus der Liste und das Modell sieht es nie.
Voraussetzungen
Der MCP-Server baut auf der AI Suite auf. Die benötigten Abhängigkeiten, einschließlich der AI Suite selbst, der System-Extension reports (Berichte) und der TYPO3-Workspaces, werden bei der Installation automatisch mitinstalliert und müssen nicht separat hinzugefügt werden.
- TYPO3 14.3.x/13.4.x/12.4.x (mindestens 13.4.1 bzw. 12.4.11)
- PHP 8.1 oder neuer (ab TYPO3 13 PHP 8.2)
- AI Suite in Version 14.6.1/13.18.1/12.24.1 und neuer (passend zur jeweiligen TYPO3-Major-Version)
Die AI Suite muss installiert und sollte auch konfiguriert sein, damit du den vollen Funktionsumfang des MCP-Servers nutzen kannst. Installation und Einrichtung sind Administrationsaufgaben. Details findest du unter Installation und Konfiguration.
Die TYPO3-Workspaces sind eine Pflicht-Abhängigkeit und keine Option. Auf ihnen beruht der Standard-Schreibmodus, der Änderungen als prüfbaren Entwurf ablegt und bei Bedarf einen Workspace pro Benutzer selbst anlegt.