TYPO3 MCP einrichten: AI Foundation installieren und den MCP-Server einschalten

Wenn Sie TYPO3 MCP einrichten möchten, sind es vier Schritte: AI Foundation per Composer installieren, den MCP-Server der Erweiterung einschalten, Ihren KI-Assistenten über eine Anmeldung im Browser (OAuth) verbinden und prüfen, ob er antwortet.

MCP steht für Model Context Protocol, den offenen Standard, über den ein Assistent wie Claude oder Cursor mit einer Reihe von Tools direkt in TYPO3 arbeitet. Den MCP-Server dafür bringt AI Foundation mit, kostenlos und quelloffen, ohne Lizenzschlüssel und ohne Registrierung. Zu jedem Schritt nennen wir den Befehl oder den Weg im Backend und das, was Sie danach sehen sollten, damit Sie es auf Ihrer eigenen Installation nachprüfen können. Die Screenshots stammen von unserer Demo-Installation, ebenso die erste Frage am Ende; die Bezeichnungen im Modul geben wir so wieder, wie sie im englischen Backend der Demo stehen.

TYPO3 MCP richten Sie in vier Schritten ein. Installieren Sie AI Foundation mit composer require nitsan/ns-t3af, führen Sie das Extension-Setup aus und leeren Sie die Caches. Achten Sie danach in AI Foundation unter MCP Server, Advanced darauf, dass Enable MCP Server angehakt ist, damit der Status Online zeigt. Tragen Sie die Server-URL, die auf /mcp endet, in Ihrem Assistenten ein und melden Sie sich per OAuth mit einem TYPO3-Backend-Benutzer an. Zum Schluss prüfen Sie: Ohne Token weist /mcp Sie ab, OAuth Tokens listet die Verbindung, und eine erste Frage bekommt eine Antwort.

Was MCP ist und was es für TYPO3-Teams verändert, erklärt unser Beitrag zu TYPO3 MCP. Hier geht es nur um das Vorgehen.

Diese Punkte sollten stimmen, bevor Sie den ersten Befehl ausführen:

Die Feinheiten, etwa die empfohlene PHP-Version und die Datenbanken, mit denen AI Foundation getestet ist, führt die Installationsanleitung unserer Dokumentation auf (auf Englisch). Lesen Sie sie, bevor Sie auf einem Produktivsystem installieren.

TYPO3 MCP installieren Sie mit einem einzigen Composer-Paket. Führen Sie diese drei Befehle im Hauptverzeichnis Ihres TYPO3-Projekts aus:

Der erste Befehl holt AI Foundation ins Projekt, der zweite legt die Datenbanktabellen an, der dritte leert die Caches. Laden Sie das Backend neu: Im Modulmenü steht jetzt AI Universe, darunter AI Foundation. Ohne Composer laden Sie die Erweiterung im Modul Extensions aus dem TYPO3 Extension Repository, aktivieren sie und leeren die Caches.

Freischalten müssen Sie danach nichts: AI Foundation ist kostenlos und quelloffen, ohne Lizenzschlüssel und ohne Registrierung. Was das im Einzelnen heißt, steht in unserem Beitrag zur kostenlosen KI-Erweiterung für TYPO3. Falls Composer neu für Sie ist: Unsere Anleitung zum Installieren von TYPO3-Erweiterungen mit Composer erklärt die Grundlagen.

AI Foundation für TYPO3 holen

Öffnen Sie AI Foundation im Modulmenü, dann den Tab MCP Server und darin den Tab Advanced:

1. Achten Sie unter Options darauf, dass Enable MCP Server angehakt ist.
2. Wählen Sie Save settings und leeren Sie die Caches.
3. Sehen Sie in den Kopf des Moduls: Server Status sollte Online zeigen.

Im selben Kopf steht die Server URL, die auf /mcp endet. Mit dieser Adresse verbindet sich Ihr Assistent im nächsten Schritt, und der Button Copy daneben legt sie in Ihre Zwischenablage.

Die Dokumentation empfiehlt, vor dem Einschalten von MCP die AI Providers einzurichten, standardmäßig mit Ihren eigenen API-Schlüsseln (Dokumentation zum MCP-Server, auf Englisch).

Wählen Sie im Tab Connect den Weg Remote (OAuth), der als Recommended markiert ist, und kopieren Sie die Server-URL. Dann:

1. Tragen Sie die URL in Ihrem Assistenten ein, als entfernten MCP-Server. Jeder Client nennt das anders, etwa benutzerdefinierter Connector oder MCP-Server-Eintrag; unsere Anleitungen für Claude, Microsoft Copilot, Cursor und VS Code gehen jeden Weg Schritt für Schritt durch.
2. Melden Sie sich an, wenn sich Ihr Browser öffnet. Bei der ersten Verbindung zeigt AI Foundation eine Seite namens Authorize Application, auf der der Client steht, der Zugriff möchte. Melden Sie sich dort mit dem TYPO3-Backend-Benutzer an, dessen Rechte der Assistent nutzen soll, und wählen Sie Authorize.
3. Wechseln Sie zurück zu Ihrem Assistenten. Er hat jetzt ein Token für diesen Benutzer und listet die MCP-Tools, die er nutzen kann.

Ein Assistent, der sich bei der ersten Verbindung selbst registriert, wie Claude auf unserer Demo-Installation, braucht von Ihnen weder Client-ID noch Secret. Die Anmeldung folgt den Regeln des Model Context Protocol zur Autorisierung: OAuth mit PKCE, einer Prüfung, die verhindert, dass jemand anderes einen abgefangenen Anmeldecode verwendet, und unsere Demo-Installation nennt S256 als einzige PKCE-Methode. Ab dann kann der Assistent in TYPO3 genau das tun, was dieser Backend-Benutzer darf. Der Tab Connect bietet noch weitere Wege, etwa eine Token-URL für Clients ohne OAuth; für den Anfang ist Remote (OAuth) der richtige.

Drei Prüfungen zeigen Ihnen, dass die Einrichtung steht, von außen nach innen.

Der Endpunkt antwortet. Ohne Token muss /mcp Sie abweisen, und das Discovery-Dokument für OAuth muss mit JSON antworten. Ersetzen Sie die Beispieladresse durch Ihre eigene:

Eine 401 ist hier genau die Antwort, die Sie sehen wollen. Eine 503 heißt, dass der MCP-Server ausgeschaltet ist; das behebt Schritt 2.

Die Verbindung ist gelistet. Unter MCP Server, OAuth Tokens steht eine Zeile je verbundenem Client: der Backend-Benutzer, als der er arbeitet, wann sein Token erstellt und zuletzt genutzt wurde, wann es abläuft, der Workspace und ein Button Revoke.

Ihr Assistent antwortet aus TYPO3. Stellen Sie eine Frage, die nur liest, etwa Geben Sie mir einen kurzen Überblick über die Seiten unserer Website und die Sprachen, in denen es sie gibt. Auf unserer Demo-Installation las der Assistent den Seitenbaum und die Sprachen der Websites und antwortete dann: zwei Websites, jede auf Englisch und Deutsch, wie viele ihrer Seiten übersetzt sind und welche Seiten keine deutsche Fassung haben, darunter die Seite Tents. Geändert wurde nichts.

Das Video zu dieser Folge beginnt mit dem ersten Prompt auf unserem Demo-TYPO3, aufgezeichnet am 30. September 2026 über den MCP-Server von AI Foundation, als Administrator auf Live: Geben Sie mir einen kurzen Überblick über die Seiten unserer Website und die Sprachen, in denen es sie gibt. Der Assistent las den Seitenbaum und die Sprachen der Websites und hatte auf unserer Demo-Installation nach 23,7 Sekunden geantwortet, gemessen vom Prompt bis zur fertigen Antwort. Geändert wurde nichts. Danach prüft das Video die Verbindung in TYPO3: das Modul MCP Server mit Status und Server-URL, die Anmeldung im Browser, die Sie als Backend-Benutzer freigeben, und die Liste unter OAuth Tokens, in der Sie die Verbindung widerrufen können. Die Core-Tools sind mit AI Foundation kostenlos, Extensions bringen lizenzierte Tools. Die Installation zeigt das Video nicht: Auf unserer Demo läuft AI Foundation bereits, die Befehle stehen in Schritt 1. Die Sitzung lief auf Englisch, wie das Backend der Demo; die deutsche Fassung des Videos zeigt dieselbe Aufnahme mit deutschen Texten.

Scheitert die Verbindung, gehen Sie diese fünf Punkte durch, in der Reihenfolge, in der sie auftreten:

Eine längere Liste bekannter Probleme führt die Dokumentation, gleich neben der Installationsanleitung.

Mit der Einrichtung bekommt Ihr Assistent Zugriff, die Kontrolle behalten Sie:

• Er hat die Rechte des Benutzers, der sich angemeldet hat. In unserem Beispiel ist das ein Administrator auf Live, eine Änderung wirkt also, sobald der Assistent sie speichert.
• Prüfen Sie jede Änderung, und wissen Sie, wie Sie sie zurücknehmen. Lassen Sie den Assistenten vor einer Änderung den aktuellen Wert lesen, prüfen Sie danach die Seite, und lassen Sie ihn den alten Wert zurückschreiben, wenn Sie die Änderung nicht wollen. Unser Beitrag zu den TYPO3 MCP Anwendungsfällen zeigt das an einer echten Aufgabe. Schreibt der Assistent mit records_apply, bitten Sie zuerst um einen Testlauf und behalten Sie die Batch-ID: records_undo nimmt den ganzen Batch zurück, wie Folge 3 zeigt.
• Wo Sicherheit zählt, kann AI Foundation Änderungen an Seiten und Inhalten in einem TYPO3-Entwurfs-Workspace zur Prüfung zurückhalten; Dateien, Dateimetadaten, Weiterleitungen, Scheduler-Aufgaben und das Leeren von Caches wirken aber auch dort sofort.
• Was Ihr Assistent liest, geht an seinen Anbieter, wie bei jedem Chat. Welche Inhalte Ihren Server im Kontextmodus und im nativen Modus verlassen, ist das Thema von Folge 13.
• Sie können es jederzeit beenden. Widerrufen Sie eine Verbindung unter OAuth Tokens, wählen Sie Enable MCP Server ab, um den Server für alle Clients zu schließen, oder entfernen Sie die Erweiterung mit composer remove nitsan/ns-t3af.

Die Tools, die AI Foundation mitbringt, sind kostenlos. AI Assistant, AI Accessibility, AI Chatbot und AI Search ergänzen eigene MCP-Tools und brauchen jeweils eine eigene Lizenz; zusammen mit AI Foundation sind es 100+ MCP-Tools.

Welcher Assistent zu Ihrem Team passt, mit welchem Tarif und mit welcher Anmeldung, klärt der Beitrag TYPO3 MCP-Clients im Vergleich, der andere Beitrag dieser Folge. Was Sie ihm übergeben können, sobald er verbunden ist, kostenlos oder lizenziert, zeigt die Karte der TYPO3 MCP Anwendungsfälle. Folge 3 bringt Alltagsänderungen aus dem Chat, Folge 5 Ihre ersten Prompts im Playground.

Die Serie kommt von T3Planet by NITSAN Technologies, Gold-Mitglied der TYPO3 Association mit mehr als 15 Jahren TYPO3-Erfahrung, und ihre Folgen schreibt Jürgen, unser AI Consultant for TYPO3. Jede Folge führt ihre Aufgabe auf unserer Demo-Installation aus, bevor sie erscheint.

Alle Folgen von MCP in der Praxis für TYPO3