Skip to main content Skip to page footer

CLI Commands

The AI Suite MCP comes with three console commands.

CommandPurpose
ai-suite-mcp:create-tokenGenerates a token without going through the OAuth flow. Intended for development and testing only.
ai-suite-mcp:cleanupCleans up expired OAuth data, session, and task files. Mandatory in production.
ai-suite-mcp:serverStarts a local MCP server via stdio, see Local stdio transport.

Generate Token

The command issues a token directly, bypassing the OAuth flow. This is useful for testing and automated environments, but it does not belong in regular operation. For everyday use, the MCP dashboard in the AI Suite backend module is the right way.

--user takes the UID or username. Without --scopes, the token receives all scopes the user is entitled to. The validity is determined by mcpTokenLifetimeDays.

Generate Token for a Backend User

vendor/bin/typo3 ai-suite-mcp:create-token --user=1

Token with Restricted Scopes

vendor/bin/typo3 ai-suite-mcp:create-token --user=admin --scopes="mcp:read mcp:write mcp:generate"

Token for a Specific Client

vendor/bin/typo3 ai-suite-mcp:create-token --user=1 --client=mcp-inspector

Cleanup

The command removes:

  • Authorization codes older than 10 minutes
  • Access tokens older than the token lifetime plus 7 days buffer, so with the default values, 37 days
  • Revoked tokens older than 30 days. They will be permanently deleted from tx_aisuite_oauth_tokens to comply with the right to deletion. Until then, they remain as soft-deletes so that the reuse of a rotated refresh token can still be recognized as theft. After that, the signal is worthless anyway.
  • Session files under var/aisuite_mcp_sessions/ that are older than 7 days
  • Task files under var/mcp_tasks/ that are older than 30 days

In production, the command should run at least hourly, via TYPO3 Scheduler or system cron. If it does not run, the table of authorization codes grows indefinitely, the directories for sessions and tasks fill up, and expired tokens accumulate. On installations with many concurrent users, it is worth taking a look at the row count in tx_aisuite_oauth_tokens. If it grows faster than it is cleaned up, a smaller value for mcpTokenLifetimeDays helps.

Clean Up Expired Data

vendor/bin/typo3 ai-suite-mcp:cleanup