README

Additional tools for the TYPO3 MCP server (hn/typo3-mcp-server). The workspace tools work on the workspace the MCP user is currently in, so drafts written through MCP can be reviewed and published without opening the backend.

Tool	Purpose
`GetPreviewLink`	Returns a workspace preview link (`ADMCMD_prev`) for a page, optionally for a specific language, plus the expiry date of the token. Warns when the preview will not show the page (hidden, start/end time, missing translation, unresolvable slug).
`PublishWorkspace`	Publishes all pending changes of the current workspace. Supports `dryRun` to list what would go live.
`GetCurrentUser`	Returns the backend user the MCP connection acts as: `uid`, `username`, `name` and `email` (`null` when not set). Read-only, no parameters, only ever the current user.

Results and errors

Every tool answers with a JSON object. Errors carry an error text and are flagged with isError:

{"error": "Page 999 does not exist."}

Error texts never quote messages from the system. Exceptions and database errors are written to the TYPO3 log; the client only gets a fixed hint. When publishing fails, PublishWorkspace lists the affected records with a reason taken from the error classification of the log entry, not from its message:

{
  "error": "Publishing failed, other records of the workspace may have been published. Details are in the TYPO3 log.",
  "workspace": {"uid": 1, "title": "Editing"},
  "dryRun": false,
  "count": 2,
  "records": {"tt_content": [12, 13]},
  "failed": [
    {"table": "tt_content", "uid": 13, "reason": "denied", "hint": "Publishing was refused, check permissions and workspace stage."}
  ]
}

reason is denied for user errors (permissions, stage) and system for everything else.

Command

Command	Purpose
`mcp-addons:workspace:publish`	Publishes every workspace whose publication date (`publish_time`) is set and lies in the past. Unlike the core command `workspace:autopublish`, the date is not reset afterwards, so the command can run on a schedule and publishes the current workspace content on every run. Setting a past date switches automatic publishing on, clearing it switches it off. Supports `--dry-run`.

Requirements

TYPO3 13.4 or 14.3
typo3/cms-workspaces
hn/typo3-mcp-server 0.6

Installation

composer require svenjuergens/t3-mcp-addons

The tools register themselves through the mcp.tool service tag of the MCP server; no further configuration is needed. Flush the caches afterwards.

Notes

A preview token unlocks the whole workspace, not just the requested page. Tokens expire after 48 hours unless the workspace record or user TSconfig (options.workspaces.previewLinkTTLHours) says otherwise.
PublishWorkspace cannot be undone through MCP. The tool description tells the model to call it only on an explicit request and to run a dry run first. Leave the extension out, or restrict the MCP user, where publishing should stay a manual review step.
The same applies to mcp-addons:workspace:publish: schedule it only where workspace content may go live without a review.

License

GPL-2.0-or-later

svenjuergens / t3-mcp-addons

Package info

Security

Statistics