Berechtigungen & Scopes

Damit ein Benutzer den MCP-Server der AI Suite überhaupt verwenden darf, muss seine Backend-Gruppe das Feature-Recht enable_mcp_access besitzen. Fehlt es, verweigert TYPO3 schon die OAuth-Zustimmung, und jede Anfrage an den MCP-Endpoint wird mit 403 (access_denied) abgewiesen.

Welche Tools darüber hinaus für die Nutzung von AI-Suite-Features zur Verfügung stehen, entscheiden die jeweiligen AI-Suite-Feature-Rechte (z. B. Metadaten-Generierung, Übersetzung, Bildgenerierung). Ohne das passende Recht taucht das betroffene Tool gar nicht erst in der Tool-Liste des Modells auf. Die Rechte werden wie gewohnt pro Backend-Gruppe vergeben, siehe Berechtigungsmanagement.

Diese Feature-Rechte werden für AI Suite MCP benötigt:

• MCP-Zugriff aktivieren (Enable MCP Access, enable_mcp_access): Pflicht. Hauptschalter für MCP und den Reiter „MCP“ im Backend-Modul „AI Suite“, wird bei jeder Anfrage direkt geprüft. Kein OAuth-Scope entspricht diesem Recht.
• Buttons zur Metadatengenerierung anzeigen (Show Metadata generation buttons, enable_metadata_generation), Tab „AI Suite Content“ im NewContentElementWizard („AI Suite Content“ tab in NewContentElementWizard, enable_content_element_generation) oder Aktiviere den Seitenabschnitt im Backend-Modul (Enable pages section within backend module, enable_pages_generation), eines davon genügt: für generateFileMetadata sowie zusammen mit enable_massaction_generation für batchGenerateMetadata und batchGenerateFileMetadata.
• KI-Übersetzungsoptionen im Übersetzungsassistenten (AI translation options within page content translation wizard, enable_translation): für translateRecord, translatePage und translateFileMetadata. Das gilt auch, wenn du translateRecord oder translatePage ohne model aufrufst und dein Client selbst übersetzt. Zusammen mit enable_massaction_generation gilt es außerdem für batchTranslatePage und batchTranslateFileMetadata.
• Buttons „Bild mit KI generieren“ (Buttons „Generate image with AI“, enable_image_generation): für generateImage.
• Abschnitt „WorkflowManager“ im Backend-Modul aktivieren (Enable WorkflowManager section within backend module, enable_massaction_generation): für die vier batch*-Tools. Status, Ergebnisse und Übernahme der Hintergrund-Tasks brauchen kein eigenes Recht.
• MCP-Medien-Upload aktivieren (Enable MCP Media Upload, enable_mcp_media_upload): für uploadMedia.
• MCP-Lesen gerenderter Seiten aktivieren (Enable MCP Rendered Page Read, enable_mcp_rendered_page_read): für readRenderedPage.
• SEO- und Barrierefreiheits-Audits aktivieren (Enable SEO and accessibility audits, enable_audit): für auditSeo, auditAccessibility und auditContent, seit Version 0.8.0.

Ein Recht gilt normalerweise für einen ganzen Scope. Davon gibt es zwei Ausnahmen. Die erste ist readRenderedPage. Das Tool sitzt im rechtefreien Scope mcp:read, braucht aber zusätzlich enable_mcp_rendered_page_read. Es rendert die Seite über eine Backend-Vorschau-Sitzung des MCP-Benutzers und liefert damit auch versteckte Seiten, unveröffentlichte Seiten und Workspace-Entwürfe, also Inhalte, an die ein einfacher Abruf der öffentlichen URL nie kommt. Das Recht sitzt am Tool und nicht am Scope, weil sonst mit einem Schalter alle lesenden Tools wegfallen würden. Ohne das Recht erscheint das Tool nicht in der Tool-Liste, ein erzwungener Aufruf endet mit einem Berechtigungsfehler. Die Seitenrechte des Benutzers gelten unverändert obendrauf.

Die zweite Ausnahme sind die Audit-Tools, die mit Version 0.8.0 hinzugekommen sind. Auch sie sitzen im Scope mcp:read, weil sie gegenüber TYPO3 nur lesen, und brauchen dennoch das eigene Recht enable_audit. Der Grund ist der umgekehrte Weg: Sie schicken die Seiten-URL und damit den Seiteninhalt an die AutoDudes-Audit-Infrastruktur, die Daten verlassen also die TYPO3-Instanz. Das Recht gilt für auditSeo, auditAccessibility und auditContent, ohne es erscheinen diese drei nicht in der Tool-Liste. Das kostenfreie readAuditResults braucht kein eigenes Recht, nur Leserechte auf die Seite.

Gemeinsames Recht: Die AI Suite nutzt seit 14.5.0/13.17.0/12.23.0 dasselbe Recht enable_audit für ihr Audit-Modul im Backend. Es ist ein einziges Recht: Wer es bekommt, darf Audits im Backend und über MCP starten.

Jedes Tool ist einem Scope zugeordnet. Ein Scope wird einem Token nur gewährt, wenn die Backend-Gruppe mindestens eines der zugehörigen AI-Suite-Feature-Rechte besitzt.

Mehr Scopes gibt es nicht. Das DeepL-Glossar ist kein eigener Scope, sondern Bestandteil der Übersetzungs-Tools unter mcp:translate: Das Glossar der Site wird automatisch angewendet. Einfache Sprache steht über MCP nicht zur Verfügung. Welche Scopes ein Token tatsächlich erhält, listet die Zustimmungsseite beim Verbinden auf.