Installation von AI Suite MCP

AI Suite MCP läuft auch in TYPO3-Installationen ohne Composer (Classic Mode) unter TYPO3 14.x/13.x/12.x. Die einzige Bibliothek, die TYPO3 nicht mitbringt, das MCP-SDK, liefert die Extension selbst mit. Von Hand kopieren musst du nichts. Die Extension findest du im TYPO3 Extension Repository (TER).

1. Aktiviere die System-Extensions workspaces und reports.
2. Installiere und aktiviere im Extension Manager zuerst ai_suite und danach ai_suite_mcp, jeweils aus dem TER oder per Upload. Halte diese Reihenfolge ein.
3. Öffne unter System → Berichte (ab TYPO3 14: Verwaltung → Berichte) den „Statusbericht“. Der Abschnitt „AI Suite MCP Environment“ meldet fehlende PHP-Erweiterungen und ein MCP-SDK, das sich nicht laden lässt. Beides deutet auf einen unvollständigen Upload hin.
4. Wo die Dokumentation vendor/bin/typo3 nennt, rufst du aus dem TYPO3-Hauptverzeichnis typo3/sysext/core/bin/typo3 auf. Ohne System-Cron führst du ai-suite-mcp:cleanup über die Planer-Aufgabe zum Ausführen von Konsolenbefehlen aus.

Unterschiede zur Installation mit Composer:

• Pfade: Statt var/ nutzt TYPO3 typo3temp/var/. Sessions liegen dann in typo3temp/var/aisuite_mcp_sessions/, Task-Ergebnisse in typo3temp/var/mcp_tasks/ und die Logs in typo3temp/var/log/. Unter Apache sperrt die .htaccess von TYPO3 dieses Verzeichnis. Unter Nginx legst du selbst eine Regel an, etwa location ^~ /typo3temp/var/ { deny all; }, sonst sind die Session-Dateien öffentlich lesbar.
• Nur im Hauptverzeichnis des Hosts: Der MCP-Endpoint, die OAuth-Endpoints und die Dokumente unter /.well-known/ werden an der Wurzel des Hosts beantwortet. Ein TYPO3 in einem Unterverzeichnis (etwa example.com/cms/) wird nicht unterstützt.
• Webserver: Die Regeln für den Authorization-Header aus Produktivbetrieb gelten unverändert.

Direkt nach der Installation ist der MCP-Server bewusst deaktiviert. Der Endpoint unter /aisuite-mcp steht erst bereit, wenn der Schalter enableMcp in der Extension-Konfiguration aktiviert wurde. Solange er deaktiviert ist, beantwortet TYPO3 alle Anfragen unter /aisuite-mcp sowie die OAuth-Dokumente unter /.well-known/ mit 404 (mcp_disabled), nur die Zwischenseite /aisuite-mcp/open für bereits ausgegebene Backend-Links bleibt erreichbar.

Die Extension-Konfiguration findest du im Backend unter Admin-Werkzeuge → Einstellungen (ab TYPO3 14: System → Einstellungen) → Extension-Konfiguration → ai_suite_mcp. Die einzelnen Optionen sind unter Konfiguration beschrieben.

Zusätzlich prüft im Statusbericht unter System → Berichte (ab TYPO3 14: Verwaltung → Berichte) der Abschnitt „AI Suite MCP Security“ die wichtigsten Einstellungen nach der Einrichtung.