typo3

The TYPO3 MCP Server Extension exposes a secure, workspace-aware interface to manage TYPO3 content via an AI assistant. All content changes are staged inside TYPO3 workspaces, so nothing goes live until you publish. You can perform content creation, translation, imports, bulk updates, SEO enhancements, tone analysis, content audits, and migrations through the MCP once the server is connected to your MCP client. The server implements tools that map to TYPO3 workspace operations, allowing you to translate pages, import documents as content, apply templates or legal text, and ensure multilingual coverage without directly touching live content.

To use it, connect your MCP client (for example Claude Desktop or another MCP-enabled tool) to the TYPO3 MCP Server using either OAuth-based remote access or a local CLI connection. If you choose the local route, you’ll run the server via PHP using the vendor TYPO3 binary with the mcp:server command. Once connected, you can issue tool-driven actions such as translating pages to another language, importing documents as TYPO3 records, applying standard content templates, performing SEO optimizations, or migrating content between folders or languages. Each action is executed within a dedicated workspace and requires explicit publishing to become visible on the live site.

The available capabilities include: translating pages and creating language versions, importing external documents as content, bulk updates across multiple pages, SEO enhancements (descriptions, meta tags), tone and content quality analysis, auditing for outdated references or names, applying reusable content templates, and content migration across workflows and folders. The system is designed to be safe for AI-assisted content creation by leveraging TYPO3 workspaces and a controlled publishing process.

Prerequisites:

• PHP 8.0+ with a compatible TYPO3 setup (v13.4+)
• Composer installed
• TYPO3 Workspaces extension (or TYPO3 installation with Workspaces dependency)
• Access to install PHP packages in your TYPO3 project (vendor/bin/typo3 available)

Installation steps:

1. Install the TYPO3 MCP Server package into your TYPO3 project:

composer require hn/typo3-mcp-server

2. Ensure TYPO3 is configured to use the MCP server endpoints and that the Workspaces system is enabled and properly configured in your TYPO3 instance.

3. Verify the MCP server binary is available via TYPO3:

vendor/bin/typo3 mcp:server

4. Start or expose the MCP server as appropriate for your environment (local CLI connection or OAuth-enabled remote access). Ensure your firewall and network allow the MCP client to reach the server endpoint.

5. In your MCP client, add a new MCP server using the following configuration (example):

{
  "mcpServers": {
    "typo3": {
      "command": "php",
      "args": [
        "vendor/bin/typo3",
        "mcp:server"
      ],
      "env": {
        "TYPO3_ROOT": "/path/to/typo3"
      }
    }
  }
}

6. Authenticate (if using OAuth) and test a simple read operation to confirm connectivity before enabling production workflows.

Tips and caveats:

• All changes happen inside TYPO3 workspaces; publishing is required to apply changes live.
• Ensure the TYPO3 Workspaces extension is installed and active as the MCP relies on workspace-based safety guarantees.
• When using the local CLI connection, you gain admin privileges by default; limit access via proper authentication in production.
• If you modify the MCP server code or tools, re-run composer install to ensure dependencies are up to date.
• For troubleshooting, check the TYPO3 logs and MCP server logs for any authentication or workspace errors, and verify the correct PHP binary path in your environment.