Skip to main content Skip to page footer

AI Suite MCP

The AI Suite MCP is a standalone TYPO3 extension that provides an MCP server (Model Context Protocol). This allows AI clients like Claude Desktop, Claude.ai, ChatGPT, Claude Code, the MCP Inspector, or Open WebUI to connect directly to your TYPO3 backend and control it as an editor would, without leaving the chat.

The features of the AI Suite can be utilized. Translations, metadata generation, image generation, and batch processing are not rebuilt but can be passed to the AI Suite. Therefore, the same providers, models, permissions, and credits apply to these tools as in the backend module, see Models & APIs.

Without a valid API key for the AI Suite, these tools remain visible, but each call ends with a license error. Everything that works without an external AI provider functions independently of this. This includes reading the page tree, content search, creating and editing records, text replacements, translations, and embedding media. These tools operate solely through TYPO3 and do not consume credits.

What can you do with it?

Once a client is connected, the model can, within the permissions of the linked backend user, among other things:

  • traverse the page tree, read pages, and search content,
  • generate and optimize content (individual content elements, landing pages, entire page trees) as well as rewrite, shorten, or simplify existing texts,
  • translate (individual records, entire pages, file metadata, entire folders) into the desired target language or also into simple language,
  • fill metadata extensively (SEO titles, descriptions, OG and Twitter tags, alt texts),
  • generate images directly according to FAL,
  • edit records securely, every write action goes through the DataHandler with mandatory preview and confirmation,
  • start batch jobs in the background, whose results return as suggestions for approval.
  • and much more…

All actions are performed as the linked backend user. Page and file mounts, table and field rights, as well as the feature and model rights of the AI Suite are enforced.

Some of these actions require a valid API key for the AI Suite because an external AI model is used behind them. If the key is missing or there are not enough credits available, the tools remain visible in the tool list and the model calls them, but the call ends with a license error. This should not be confused with the feature rights of the backend group. If a right is missing there, the tool disappears from the list and the model never sees it. The structural part remains unaffected. This includes reading, searching, creating, modifying, moving, copying, and deleting records, creating translations, and embedding existing media.

Requirements

The AI Suite MCP builds on the AI Suite. The required dependencies, including the AI Suite itself, the TYPO3 reports module, and TYPO3 workspaces, are automatically installed during installation and do not need to be added separately.

  • TYPO3 12.4.11 to 14.3.x
  • PHP 8.2 or newer
  • AI Suite version 12.21.0, 13.15.0, or 14.3.0 and newer (matching the respective TYPO3 major version)

The AI Suite must be installed and should also be configured to utilize the full functionality of the AI Suite MCP. Installation and setup are administrative tasks. Details can be found at Installation and Configuration.

TYPO3 workspaces are a mandatory dependency and not an option. They are the basis for the standard write mode, which saves changes as a verifiable draft and creates a workspace per user as needed.

Overview