Berechtigungen & Scopes

Jede Aktion über die AI Suite MCP läuft als der Backend-Benutzer, für den das Token bzw. die OAuth-Freigabe ausgestellt wurde, und zwar mit dessen vollen TYPO3-Rechten. Seiten- und Datei-Mounts, Tabellen- und Feldrechte sowie die Feature- und Modelrechte der AI Suite werden dabei unverändert durchgesetzt.

Die OAuth-Scopes wirken zusätzlich obendrauf. Sie können den Zugriff nur einschränken, niemals über die TYPO3-Rechte des Benutzers hinaus erweitern.

Damit ein Benutzer AI Suite MCP überhaupt verwenden darf, muss seine Backend-Gruppe das Feature-Recht enable_mcp_access besitzen. Fehlt es, verbindet sich der Client zwar, aber jeder Tool-Aufruf wird mit „keine Berechtigung“ 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 Models auf. Die Rechte werden wie gewohnt pro Backend-Gruppe vergeben, siehe Berechtigungsmanagement.

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

• enable_mcp_access: Pflicht. Hauptschalter für MCP und das MCP-Dashboard im Backend-Modul, wird bei jeder Anfrage direkt geprüft. Kein OAuth-Scope entspricht diesem Recht.
• enable_metadata_generation: für batchGenerateMetadata, generateFileMetadata, batchGenerateFileMetadata, batchGenerateFolderMetadata.
• enable_translation: für alle Übersetzungs-Tools mit externen KI-Anbietern.
• enable_image_generation: für generateImage.
• enable_massaction_generation: für die Batch- und Hintergrund-Tools.
• enable_mcp_media_upload: für uploadMedia.
• enable_mcp_rendered_page_read: für readRenderedPage.

Ein Recht gilt normalerweise für einen ganzen Scope. Eine Ausnahme 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.

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. Leichte Sprache und das DeepL-Glossar sind keine eigenen Scopes, sondern Bestandteil der Übersetzungs-Tools unter mcp:translate: Das Glossar der Site wird automatisch angewendet, Leichte Sprache läuft über dieselben Tools. Welche Scopes ein Token tatsächlich erhält, listet die Zustimmungsseite beim Verbinden auf.