webmcp — das Browser-MCP für Ihr TYPO3.

Konfiguration

Site Set aktivieren

Binden Sie das Site Set moselwal/webmcp in Ihre Site-Konfiguration ein.

Settings

In config/sites/<site>/settings.yaml:

webmcp:
  enabled: true
  apiBasePath: '/_webmcp/api'
  tools:
    search:
      enabled: true
      maxResults: 20
    navigation:
      enabled: true
      maxDepth: 4
    page-content:
      enabled: true

Eingebaute Tools

Alle Tools respektieren TYPO3-Zugriffsrechte (fe_group, starttime, endtime, hidden). Es werden nur Inhalte ausgeliefert, die für den aktuellen Besucher (anonym oder eingeloggt) sichtbar sind.

Eigene Tools entwickeln

1. ToolProvider implementieren

<?php

use Moselwal\WebMcp\Domain\Contract\ToolProviderInterface;
use Moselwal\WebMcp\Domain\Model\ToolAnnotations;
use Moselwal\WebMcp\Domain\Model\ToolDefinition;

final class ShopToolProvider implements ToolProviderInterface
{
    public function getIdentifier(): string
    {
        return 'shop';
    }

    public function getTools(): array
    {
        return [
            new ToolDefinition(
                name: 'product-search',
                description: 'Search products in the shop',
                inputSchema: [
                    'type' => 'object',
                    'properties' => [
                        'query' => ['type' => 'string'],
                        'category' => ['type' => 'string'],
                    ],
                    'required' => ['query'],
                ],
                annotations: new ToolAnnotations(readOnlyHint: true),
            ),
        ];
    }
}

2. ToolHandler implementieren

<?php

use Moselwal\WebMcp\Domain\Contract\ToolHandlerInterface;
use Moselwal\WebMcp\Domain\Model\ToolResult;
use Psr\Http\Message\ServerRequestInterface;

final class ProductSearchHandler implements ToolHandlerInterface
{
    public function getToolName(): string
    {
        return 'product-search';
    }

    public function execute(array $input, ServerRequestInterface $request): ToolResult
    {
        // Produkt-Suche implementieren ...
        return ToolResult::success(['products' => $results]);
    }
}

Beide Klassen werden automatisch über _instanceof-Tags in der Services.yaml registriert — keine zusätzliche Konfiguration nötig.

Wie es funktioniert

1. Beim Rendering einer Seite injiziert die Extension JavaScript über den AssetCollector.
2. Das JavaScript registriert alle aktivierten Tools über navigator.modelContext.registerTool().
3. Ruft ein KI-Agent ein Tool auf, sendet der Browser einen POST-Request an /_webmcp/api/{toolName}.
4. Die PSR-15-Middleware validiert Request (CSRF-Nonce, Input) und delegiert an den passenden ToolHandler.
5. Das Ergebnis wird als JSON zurückgegeben.

Voraussetzungen

• TYPO3 13.4 oder 14.0
• PHP 8.2 oder höher
• HTTPS (SecureContext erforderlich)