CLI-Befehle
Die AI Suite MCP bringt drei Konsolenbefehle mit.
| Befehl | Zweck |
|---|---|
ai-suite-mcp:create-token | Erzeugt ein Token, ohne den OAuth-Ablauf zu durchlaufen. Nur für Entwicklung und Tests gedacht. |
ai-suite-mcp:cleanup | Räumt abgelaufene OAuth-Daten, Session- und Task-Dateien auf. Produktiv Pflicht. |
ai-suite-mcp:server | Startet einen lokalen MCP-Server über stdio, siehe Lokaler stdio-Transport. |
Token erzeugen
Der Befehl stellt ein Token direkt aus und umgeht damit den OAuth-Ablauf. Das ist praktisch für Tests und automatisierte Umgebungen, gehört aber nicht in den regulären Betrieb. Für den Alltag ist das MCP-Dashboard im AI Suite-Backend-Modul der richtige Weg.
--user nimmt die UID oder den Benutzernamen. Ohne --scopes erhält das Token alle Scopes, zu denen der Benutzer berechtigt ist. Die Gültigkeit richtet sich nach mcpTokenLifetimeDays.
Token für einen Backend-Benutzer erzeugen
vendor/bin/typo3 ai-suite-mcp:create-token --user=1
Token mit eingeschränkten Scopes
vendor/bin/typo3 ai-suite-mcp:create-token --user=admin --scopes="mcp:read mcp:write mcp:generate"
Token für einen bestimmten Client
vendor/bin/typo3 ai-suite-mcp:create-token --user=1 --client=mcp-inspector
Aufräumen
Der Befehl entfernt:
- Authorization Codes, die älter als 10 Minuten sind
- Access-Tokens, die älter sind als die Token-Lebensdauer plus 7 Tage Puffer, bei den Standardwerten also 37 Tage
- widerrufene Tokens, die älter als 30 Tage sind. Sie werden endgültig aus
tx_aisuite_oauth_tokensgelöscht, um dem Recht auf Löschung zu entsprechen. Bis dahin bleiben sie als Soft-Delete liegen, damit die Wiederverwendung eines rotierten Refresh-Tokens noch als Diebstahl erkannt werden kann. Danach ist das Signal ohnehin wertlos. - Session-Dateien unter
var/aisuite_mcp_sessions/, die älter als 7 Tage sind - Task-Dateien unter
var/mcp_tasks/, die älter als 30 Tage sind
Produktiv sollte der Befehl mindestens stündlich laufen, per TYPO3-Scheduler oder per System-Cron. Läuft er nicht, wächst die Tabelle der Authorization Codes unbegrenzt, die Verzeichnisse für Sessions und Tasks laufen voll, und abgelaufene Tokens sammeln sich an. Auf Installationen mit vielen gleichzeitigen Benutzern lohnt ein Blick auf die Zeilenzahl in tx_aisuite_oauth_tokens. Wächst sie schneller, als aufgeräumt wird, hilft ein kleinerer Wert für mcpTokenLifetimeDays.
Abgelaufene Daten aufräumen
vendor/bin/typo3 ai-suite-mcp:cleanup