TYPO3 MCP-Server: Einrichtung, Nutzung und Praxisbeispiele

Eine Seite übersetzen, fehlende Meta-Descriptions ergänzen, eine geänderte Telefonnummer auf vierzig Unterseiten korrigieren: Solche Aufgaben kosten im TYPO3-Backend viele Klicks, obwohl sie sich in einem Satz beschreiben lassen. Genau hier setzt der TYPO3 MCP-Server an. Die Extension verbindet TYPO3 über das Model Context Protocol mit KI-Agenten wie Claude, ChatGPT, Le Chat oder Gemini. Redaktionen formulieren ihren Auftrag im Chat, der Agent erledigt die Arbeit im CMS – und jede Änderung landet zunächst in einem Workspace statt direkt auf der Website.

In diesem Beitrag zeigen wir, wie die Extension eingerichtet wird, wie die tägliche Arbeit damit aussieht und für welche Aufgaben sie sich in der Praxis besonders lohnt.

Was der MCP-Server in TYPO3 leistet

Das Model Context Protocol (MCP) ist ein offener Standard, über den KI-Anwendungen mit externen Systemen arbeiten. Ein MCP-Server stellt dem Agenten dafür klar beschriebene Werkzeuge bereit. Im Fall von TYPO3 sind das unter anderem Funktionen, um den Seitenbaum zu lesen, Seiten mit ihren Inhaltselementen abzurufen, Datensätze zu suchen, Tabellenstrukturen zu verstehen, Datensätze zu schreiben und Dateien hochzuladen.

Der Agent arbeitet dabei nicht an TYPO3 vorbei, sondern mit dessen Bordmitteln. Er orientiert sich an der TCA, kennt also dieselben Felder, Inhaltstypen und Relationen wie das Backend. Das gilt auch für eigene Inhaltselemente und Extensions, sofern sie sauber konfiguriert und workspace-fähig sind. Was im Backend bearbeitet werden kann, kann in der Regel auch der Agent bearbeiten – mit genau den Rechten des angemeldeten Backend-Benutzers.

Das wichtigste Sicherheitsprinzip: Alle Inhaltsänderungen werden automatisch in einem TYPO3-Workspace vorgemerkt. Der Agent kann nichts veröffentlichen. Erst wenn eine verantwortliche Person die Änderungen in der Vorschau geprüft und freigegeben hat, werden sie für Besucherinnen und Besucher sichtbar.

Voraussetzungen

Bevor die Extension installiert wird, sollte die Ausgangslage geprüft werden:

• TYPO3 13.4 LTS oder 14 – ältere Versionen werden nicht unterstützt.
• PHP 8.2 oder höher.
• Die Workspaces-Extension des Cores. Sie wird bei der Installation automatisch als Abhängigkeit mitinstalliert.
• Eine Composer-basierte Installation, über die Extensions verwaltet werden.
• Ein MCP-fähiger Client, etwa Claude, ChatGPT, Le Chat, Gemini oder ein Entwicklerwerkzeug wie Cursor.

Läuft eine Website noch auf TYPO3 12 oder älter, steht vor der Integration ein TYPO3-Update. Beides lässt sich gut in einem Projekt kombinieren.

Installation und Konfiguration

Extension installieren

Die Extension wird wie jedes andere Paket per Composer installiert: composer require hn/typo3-mcp-server. Anschließend werden wie gewohnt die Datenbank-Analyse ausgeführt und die Caches geleert. Weitere Pflichtschritte gibt es nicht – die Standardeinstellungen funktionieren ohne Anpassung.

Erweiterungskonfiguration prüfen

Die Einstellungen finden sich unter Admin Tools → Settings → Extension Configuration → mcp_server. Drei Optionen sind relevant:

• Maximale Dateigröße (Standard: 500 MiB) für Dateien, die der Agent von einer URL lädt oder über einen Upload-Link erhält.
• Zusätzliche Nur-Lese-Tabellen (Standard: sys_file). Darüber kann der Agent die Dateiliste durchsuchen, ohne sie zu verändern.
• Zusätzliche eigenständige Tabellen (Standard: sys_file_metadata). Damit werden etwa Titel und Alternativtexte von Dateien bearbeitbar.

Für die meisten Websites können diese Werte unverändert bleiben. Wer weitere Tabellen von Extensions nur lesend freigeben möchte, ergänzt sie hier.

Workspace und Berechtigungen vorbereiten

Der MCP-Server nutzt den ersten Workspace, in dem der angemeldete Benutzer schreiben darf. Existiert keiner und darf der Benutzer Workspaces anlegen, erstellt die Extension automatisch einen eigenen Workspace mit dem Namen „MCP Workspace for“ und dem Namen des Benutzers.

In der Praxis empfehlen wir, den Workspace bewusst anzulegen und ihm einen sprechenden Namen zu geben, etwa „KI-Entwürfe“. So ist für das ganze Team erkennbar, welche Änderungen vom Agenten stammen. Ebenso wichtig ist ein passendes Rechtekonzept für KI-Agenten: Der Agent erbt die Berechtigungen des verbundenen Benutzers. Ein Redaktionskonto mit eingeschränkten Seiten- und Tabellenrechten ist deshalb die sicherere Wahl als ein Administratorzugang.

KI-Agenten mit TYPO3 verbinden

Variante 1: Verbindung per OAuth (empfohlen)

Für die tägliche Arbeit ist die Verbindung über OAuth der empfohlene Weg. Sie funktioniert auch bei Websites auf einem entfernten Server und setzt auf die normale Backend-Anmeldung:

1. Im TYPO3-Backend oben rechts das Benutzermenü öffnen und den Eintrag MCP Server wählen.
2. Die angezeigte Server-URL kopieren, optional auch den vorgeschlagenen Integrationsnamen.
3. Im KI-Client eine neue MCP-Integration bzw. einen neuen Connector anlegen und die URL eintragen.
4. Beim ersten Zugriff öffnet sich die TYPO3-Anmeldung. Nach dem Login ist der Agent mit diesem Backend-Benutzer verbunden.

Ab diesem Moment sieht der Agent nur die Seiten und Datensätze, auf die der Benutzer Zugriff hat, und schreibt ausschließlich in dessen Workspace.

Variante 2: Lokale Verbindung über die Kommandozeile

Für Entwicklungsumgebungen gibt es zusätzlich eine lokale Verbindung. Dabei startet der KI-Client den MCP-Server direkt über den TYPO3-Konsolenbefehl vendor/bin/typo3 mcp:server. Diese Variante arbeitet standardmäßig mit Administratorrechten und gehört deshalb nur auf lokale Entwicklungs- oder Testsysteme, nicht auf eine produktive Website.

So arbeiten Redaktionen mit dem Agenten

Im Alltag folgt die Arbeit mit dem MCP-Server einem einfachen Ablauf:

1. Auftrag formulieren: Die Redakteurin beschreibt im Chat, was passieren soll – so, wie sie es einer Kollegin erklären würde.
2. Agent verschafft sich einen Überblick: Er liest den Seitenbaum, ruft die betroffenen Seiten ab und prüft, welche Felder und Inhaltstypen zur Verfügung stehen.
3. Änderungen im Workspace: Der Agent legt Inhalte an, ändert oder übersetzt sie. Alles wird als Entwurf vorgemerkt.
4. Prüfen in der Vorschau: Im Workspace-Modul oder über einen Vorschau-Link werden die Entwürfe im echten Layout kontrolliert – auf Wunsch auch von Kolleginnen und Kollegen ohne Backend-Zugang.
5. Veröffentlichen: Passt alles, werden die Änderungen mit einem Klick freigegeben. Was nicht passt, wird verworfen oder im Chat nachgebessert.

Einige Gewohnheiten verbessern die Ergebnisse deutlich. Vollständige Seiten-URLs helfen dem Agenten, die richtige Seite sofort zu finden. Ein klar abgegrenzter Umfang – „nur die Seiten unter /leistungen“ – verhindert ungewollte Änderungen an anderer Stelle. Und bei größeren Vorhaben lohnt es sich, schrittweise vorzugehen: erst eine Seite, dann die Prüfung, dann der Rest.

Anwendungsbeispiele aus der Praxis

Seiten übersetzen

„Übersetze die Seite /karriere ins Englische.“ Der Agent liest die Inhalte, übersetzt sie und legt die Sprachversionen in der TYPO3-Sprachstruktur an – also als echte Übersetzungen der Ausgangselemente, nicht als lose Kopien. Die Übersetzungsfunktion ist in der Extension noch als experimentell gekennzeichnet. Eine fachliche Prüfung vor der Freigabe ist deshalb Pflicht, gerade bei Fachbegriffen und rechtlichen Aussagen.

SEO-Metadaten pflegen

„Welche Seiten haben keine Meta-Description? Ergänze passende Beschreibungen.“ Der Agent durchsucht den Seitenbaum, erstellt Beschreibungen auf Basis der tatsächlichen Seiteninhalte und trägt sie in die Seiteneigenschaften ein. Die Redaktion prüft anschließend gesammelt im Workspace, statt jede Seite einzeln zu öffnen.

Massenänderungen

„Ersetze überall die alte Hotline durch 0221 / 29 83 12 80.“ Geänderte Telefonnummern, umbenannte Produkte oder veraltete Links sind typische Aufgaben, bei denen im Backend leicht eine Stelle übersehen wird. Der Agent sucht alle Vorkommen und ändert sie in einem Durchgang. In der Workspace-Übersicht ist anschließend genau zu sehen, welcher Text vorher und nachher wo stand.

Dokumente in Seiten verwandeln

„Mach aus diesem Flyer eine Produktseite.“ Aus Word-Dokumenten, PDFs oder Briefings entstehen strukturierte Seiten mit passenden Inhaltselementen. Der Agent wählt dabei aus den Inhaltstypen, die die Website tatsächlich anbietet – inklusive individueller Elemente.

Content-Audits

„Liste alle Bilder ohne Alternativtext auf.“ Nicht jede Aufgabe muss eine Änderung sein. Agenten eignen sich sehr gut für Bestandsaufnahmen: fehlende Alternativtexte, doppelte Inhalte, veraltete Jahreszahlen oder Seiten, die noch den alten Firmennamen enthalten. Das Ergebnis ist eine priorisierte Liste als Grundlage für die nächste Redaktionsrunde – auch ein guter Beitrag zur Barrierefreiheit.

Bilder, Videos und Dateien einbinden

„Setze dieses YouTube-Video auf die Startseite.“ Der MCP-Server kann Dateien von einer öffentlichen URL laden, YouTube- und Vimeo-Links als Online-Medien anlegen, Textformate wie SVG oder CSV direkt speichern und Dateien vom eigenen Rechner über einen einmaligen Upload-Link entgegennehmen. Bestehende Dateien werden dabei nie überschrieben oder gelöscht.

Inhalte beim Relaunch migrieren

„Übernimm die News aus dem alten System in den neuen Newsbereich.“ Bei Relaunches und Migrationen kann der Agent Inhalte aus Altsystemen übernehmen und in die neue Seitenstruktur einsortieren. Das ersetzt keine saubere Migrationsplanung, spart aber viel manuelle Übertragungsarbeit.

Aus eigener Erfahrung: neue Seiten aufbauen

Wir setzen den MCP-Server auch selbst ein. Die Landingpage zu TYPO3 und KI-Agenten haben wir per Agent angelegt – inklusive Hero-Bereich, Kacheln, FAQ und Call-to-Action-Elementen. Zuerst in der Entwicklungsumgebung, dann als Entwurf auf der Live-Website, wo sie wie jede andere Änderung geprüft und freigegeben wurde.

Grenzen, die man kennen sollte

So hilfreich der MCP-Server ist, einige Punkte sollten vor dem produktiven Einsatz klar sein:

• Dateien sind nicht versioniert. Hochgeladene Dateien liegen sofort im Dateisystem. Sichtbar werden sie aber erst, wenn ein freigegebener Inhalt sie verwendet.
• Keine Workspace-Auswahl. Die Extension nutzt den ersten beschreibbaren Workspace des Benutzers. Wer mehrere Workspaces betreibt, sollte das bei der Rechtevergabe berücksichtigen.
• Übersetzungen sind experimentell. Sie funktionieren, sollten aber vor der Veröffentlichung sorgfältig geprüft werden.
• Datenschutz hängt vom Agenten ab. Die Inhalte bleiben im eigenen TYPO3. Welche Daten an den KI-Anbieter übertragen werden, entscheidet die Wahl des Clients. Auftragsverarbeitung, Speicherort und Trainingsnutzung sollten deshalb vorab geklärt werden.

Fazit

Der TYPO3 MCP-Server macht aus dem KI-Agenten ein echtes Werkzeug für die Website-Pflege. Die Einrichtung ist mit einem Composer-Befehl und einer OAuth-Verbindung schnell erledigt. Den eigentlichen Unterschied machen aber die Leitplanken: Workspaces, Benutzerrechte und Vorschau sorgen dafür, dass der Agent Arbeit abnimmt, ohne Kontrolle abzunehmen.

Sie möchten wissen, ob Ihre TYPO3-Website bereit für KI-Agenten ist? Wir prüfen Version, Workspaces und Rechtekonzept und richten die Integration für Ihr Team ein. Mehr dazu auf unserer Seite zu TYPO3 mit KI-Agenten – oder direkt über eine kostenlose Website-Analyse.