Skip to main content Skip to page footer

CLI-Befehle

Die AI Suite MCP bringt drei Konsolenbefehle mit.

BefehlZweck
ai-suite-mcp:create-tokenErzeugt ein Token, ohne den OAuth-Ablauf zu durchlaufen. Nur für Entwicklung und Tests gedacht.
ai-suite-mcp:cleanupRäumt abgelaufene OAuth-Daten, Session- und Task-Dateien auf. Produktiv Pflicht.
ai-suite-mcp:serverStartet 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_tokens gelö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