Skip to main content Skip to page footer

Verfügbare Tools

Die AI Suite MCP stellt derzeit 45 Tools bereit. Jedes Tool gehört zu genau einem OAuth-Scope, und ein Scope wird nur gewährt, wenn die Backend-Gruppe des Benutzers das passende AI Suite-Feature-Recht besitzt (siehe Berechtigungen & Scopes). Die Tool-Liste, die ein Model zu sehen bekommt, ist deshalb pro Benutzer unterschiedlich. Fehlt ein Recht, taucht das betroffene Tool gar nicht auf.

Die folgende Übersicht ist nach Scopes gruppiert und nennt zu jedem Tool kurz seinen Zweck. Die vollständigen Parameter liefert jeder Client selbst, weil sie als JSON-Schema Teil der Tool-Definition sind. Welche Tools eine konkrete Installation tatsächlich ausliefert, verrät readServerInfo.

Kontext und Recherche (mcp:read)

Diese Tools lesen nur. Sie kosten keine Credits und rufen kein KI-Model auf.

ToolZweck
readServerInfoStatus des Servers mit den Versionen von TYPO3, AI Suite und MCP, der aktiven Konfiguration und einer Diagnose
readPageTreeSeitenbaum durchlaufen, begrenzt auf die Mounts des Benutzers
readPageContentInhaltselemente einer Seite lesen, optional mit Container-Verschachtelung
readContentTreeInhalte aller Seiten eines Teilbaums auf einmal, seitenweise paginiert
readRenderedPageDie Seite wie ein Besucher sie sieht, inklusive Plugin-Ausgabe. Benötigt zusätzlich enable_mcp_rendered_page_read
readEditorialGuidelinesDie von der Redaktion hinterlegten Vorgaben zu Tonalität, Zielgruppe und Stil für einen Seitenbereich
readChildrenContainer- und IRRE-Kinder eines Datensatzes auflisten, nach Relation gruppiert
searchContentVolltextsuche über Seiten und Inhaltselemente
listFilesDateien eines FAL-Storage oder -Ordners auflisten
readFileInfoMetadaten einer einzelnen Datei
listStaleContentSeiten und Inhalte finden, die seit N Tagen nicht mehr bearbeitet wurden
readTaskStatusFortschritt eines Hintergrund-Tasks
readTaskResultsErgebnisse eines abgeschlossenen Tasks abrufen, rein lesend

Datensätze: Schema und Bearbeitung (mcp:read / mcp:write)

Die erkundenden Tools dieser Gruppe gehören zu mcp:read, die schreibenden zu mcp:write. Alle Schreibvorgänge laufen über den DataHandler und damit über die üblichen TYPO3-Prüfungen, und sie folgen dem eingestellten Schreibmodus.

ToolScopeZweck
listTablesmcp:readTabellen auflisten, die der Benutzer lesen darf, abzüglich mcpExcludedTables
readRecordSchemamcp:readTCA-Schema einer Tabelle mit Feldern, Typen, Validierung, Relationen und Schreibbarkeit
readFlexFormSchemamcp:readInneres Schema eines FlexForm-Feldes mit Sheets und Feldern
listPageTypesmcp:readVerfügbare Seitentypen (Doktypes)
listContentTypesmcp:readVerfügbare CTypes und gültige Spalten einer Seite
readRecordsmcp:readDatensätze lesen, per UID, per Seite oder per Feldfilter
compareWithLivemcp:readFeldweiser Vergleich eines Workspace-Entwurfs mit dem Live-Stand
previewRecordsmcp:writeVorschau einer Schreiboperation als alt-neu-Diff, ohne zu speichern
writeRecordsmcp:writeDatensätze anlegen oder ändern, optional als atomarer Batch
copyRecordsmcp:writeDatensätze kopieren, einzeln oder als Batch
moveRecordsmcp:writeDatensätze verschieben
deleteRecordsmcp:writeDatensätze löschen (Soft-Delete). Als destruktiv markiert, der Client fragt daher nach
localizeRecordmcp:writeÜbersetzung eines Datensatzes anlegen, ohne KI und ohne Credits
savePageTreemcp:writeEinen erzeugten Seitenbaum speichern
replaceTextmcp:writeEine wörtliche Ersetzung in einem Feld, ohne das ganze Feld neu zu senden
patchTextmcp:writeMehrere Ersetzungen in einem Feld, atomar angewendet
bulkReplaceTextmcp:writeDieselbe Ersetzung über alle Kind-Datensätze eines Elternteils
copyMediaReferencemcp:writeDateireferenz von einem Feld auf ein anderes kopieren
replaceMediaReferencemcp:writeDie Datei hinter einer bestehenden Referenz austauschen

KI-Funktionen (Generierung, Übersetzung, Bilder)

Diese Tools rufen die Anbieter und Models der AI Suite auf und verbrauchen Credits. Welche Models zur Verfügung stehen, ergibt sich aus der AI Suite-Konfiguration und den Modelrechten der Backend-Gruppe. In AI Suite MCP ist dafür keine zusätzliche Einstellung nötig.

Sie sind damit die einzigen Tools, die einen gültigen API-Key der AI Suite voraussetzen. Fehlt er oder deckt das Lizenzpaket die Funktion nicht ab, bleiben die Tools in der Tool-Liste stehen und werden vom Model auch aufgerufen. Der Aufruf endet dann mit einem Lizenzfehler. Das unterscheidet sie von den Feature-Rechten der Backend-Gruppe, die ein Tool bereits aus der Liste entfernen.

ToolScopeZweck
generateFileMetadatamcp:generateAlternativtext, Titel und Beschreibung für eine Datei erzeugen, auf Basis der Datei selbst
translateRecordmcp:translateEinen einzelnen Datensatz übersetzen
translatePagemcp:translateEine ganze Seite übersetzen, Metadaten und alle Inhaltselemente
translateFileMetadatamcp:translateDatei-Metadaten in eine Zielsprache übersetzen
generateImagemcp:imageEin Bild aus einer Textbeschreibung erzeugen und in FAL ablegen

Leichte Sprache und das DeepL-Glossar der Site sind kein eigenes Tool, sondern Bestandteil der Übersetzungs-Tools. Das Glossar wird automatisch angewendet.

Medien einbinden

Dieses Tool bringt vorhandene Dateien in die Dateiverwaltung, ohne ein KI-Model zu bemühen. Es kostet keine Credits und funktioniert auch ohne gültigen API-Key der AI Suite. Es hängt an einem eigenen Scope und einem eigenen Feature-Recht, beide standardmäßig aus, weil es als einziges Tool neben generateImage eine physische Datei anlegt und deshalb nicht über einen Workspace zurückgenommen werden kann.

ToolScopeZweck
uploadMediamcp:mediaVorhandene Bilder oder Videos in FAL übernehmen, per URL, als Base64 oder als YouTube- bzw. Vimeo-Link

Nicht zu verwechseln mit copyMediaReference und replaceMediaReference. Die beiden hängen keine neue Datei ein, sondern setzen bestehende Dateireferenzen um, gehören deshalb zu mcp:write und stehen in der Datensatz-Gruppe. Zu Zielordner, Größengrenze, erlaubten Dateiendungen und der Absicherung entfernter Downloads siehe Sicherheit & Betrieb.

Hintergrund-Tasks (mcp:workflow)

Batch-Tools laufen asynchron. Sie liefern sofort eine Task-ID zurück, der Fortschritt wird mit readTaskStatus abgefragt und die Ergebnisse mit readTaskResults gelesen. Geschrieben wird nichts davon automatisch. Ein Batch-Prozess erzeugt Vorschläge, und erst applyTaskResults schreibt sie in die Datensätze.

ToolZweck
batchGenerateMetadataSeiten-Metadaten in großer Zahl, entweder für eine UID-Liste oder für einen ganzen Seiten-Teilbaum
batchGenerateFileMetadataDatei-Metadaten für eine Liste von Dateien
batchGenerateFolderMetadataDatei-Metadaten für alle Dateien eines Ordners
batchTranslatePageMehrere Seiten übersetzen
batchTranslateFileMetadataDatei-Metadaten einer Dateiliste übersetzen
batchTranslateFolderMetadataDatei-Metadaten aller Dateien eines Ordners übersetzen
applyTaskResultsDie Übersetzungen eines fertigen Batch-Prozesses in die Lokalisierungs-Datensätze schreiben (Scope mcp:write)

batchGenerateMetadata nimmt seine Ziele auf genau einem von zwei Wegen. Entweder pageIds als ausdrückliche UID-Liste oder rootPageId als Seite samt allem darunter. Beides zusammen ist ein Fehler, nichts davon ebenfalls. recursive entscheidet, ob ein rootPageId den ganzen Teilbaum durchläuft oder bei den direkten Kindern stehen bleibt. Die Wurzelseite ist immer dabei.