Installation

Requirements

TYPO3 v13.4+ or v14.x
PHP 8.2+
netresearch/nr-llm (^0.6) -- LLM abstraction layer

Optional:

hn/typo3-mcp-server (^1.0) -- for TYPO3 content management tools
netresearch/nr-vault (^0.4) -- for secure API key storage

Quick start

Install the extension via Composer (see below).
In nr-llm, create a Task record that configures your LLM provider (e.g. OpenAI, Anthropic). Note the UID.
Go to Admin Tools > Settings > Extension Configuration > nr_mcp_agent and set llmTaskUid to the Task UID from step 2.

The AI Chat module is now available under Admin Tools > AI Chat.

Composer installation

composer require netresearch/nr-mcp-agent

After installation, run the database migrations:

vendor/bin/typo3 database:updateschema

To enable MCP integration (content management tools):

Set enableMcp = 1 in the extension configuration.
Open the List module at pid = 0 and create an MCP Server record. For the built-in TYPO3 MCP server, set Transport to stdio, leave Command empty (defaults to vendor/bin/typo3), and set Arguments to mcp:server (one argument per line).
If you use hn/typo3-mcp-server as the stdio backend, install it first:
```
composer require hn/typo3-mcp-server
```
Copied!
Then configure the server record as described above.

DDEV development setup

The project includes a DDEV configuration for local development:

git clone https://github.com/netresearch/t3x-nr-mcp-agent.git
cd t3x-nr-mcp-agent
ddev start
ddev composer install
ddev typo3 database:updateschema

The extension is symlinked into the TYPO3 installation automatically via the Composer typo3/cms extra configuration.

Running tests and quality checks:

# All CI checks (PHPStan + CGL + tests)
ddev composer ci

# Individual checks
ddev composer ci:phpstan     # Static analysis + architecture tests
ddev composer ci:cgl         # Code style check
ddev composer ci:tests:unit  # Unit tests only
ddev composer ci:tests       # Unit + functional tests
ddev composer ci:mutation    # Mutation testing (Infection)

# Fix code style
ddev composer fix:cgl

Alternatively, use the Docker-based test runner (works without DDEV):

./Build/Scripts/runTests.sh -s unit        # Unit tests
./Build/Scripts/runTests.sh -s phpstan     # PHPStan
./Build/Scripts/runTests.sh -s cgl         # Code style check
./Build/Scripts/runTests.sh -s mutation    # Mutation testing
./Build/Scripts/runTests.sh -s unit -p 8.3 # Specific PHP version
./Build/Scripts/runTests.sh -h             # Show all options