Known Problems 

Verified issues and checks for AI Foundation (EXT:ns_t3af).

Installation 

Composer conflicts with another MCP package

AI Foundation includes an MCP server and conflicts with other MCP server packages such as marekskopal/typo3-mcp-server and hn/typo3-mcp-server. Remove those packages before installing nitsan/ns-t3af.

Backend module is missing

  1. Confirm ns_t3af is active.
  2. Flush all caches.

  3. Run:

    ./vendor/bin/typo3 extension:setup
./vendor/bin/typo3 cache:flush
    Copied!

Also confirm scheduler and workspaces are available. See Installation.

Providers 

Provider request or Test connection fails

  • Confirm the provider row exists and is enabled in AI Foundation > AI Providers.
  • Run Test connection from the provider drawer.
  • Check the API key, model ID, and endpoint URL (for custom/OpenAI-compatible rows).
  • Confirm outbound HTTPS to the provider API works from the server.
  • Review backend logs for entries from AI Foundation request logging.

Unexpected model or provider behavior

  • Confirm the default provider matches the feature you expect.
  • Confirm the model ID on the provider row.
  • Check feature-level provider overrides in AI Foundation > AI Features.

No usage statistics shown

  • Confirm an OpenAI admin/organization key is set where org usage charts are required.
  • Clear caches and open AI Foundation > AI Usage / AI Foundation > AI Logs again.
  • Confirm the dashboard analytics cache is available after extension:setup.

Configuration 

HTTP 401 / 403 when fetching a protected URL

If you use the Basic Auth helper in Extension Configuration (ns_t3af):

  • Enable basicAuthEnabled.
  • Set basicAuthUsername and basicAuthPassword.
  • Retry the protected URL fetch.

MCP 

MCP client cannot connect

  • Confirm the MCP server is enabled in Extension Configuration.
  • Prefer HTTPS on the site base URL.
  • For Cursor and similar clients, follow MCP Testing.
  • For stdio setups, keep the working directory and user/workspace flags correct.

MCP writes fail after a successful connect

Confirm the backend user has the required module, table, and workspace rights. See AI Permissions.

Report an issue 

Include TYPO3 version, PHP version, ns_t3af version, exact error text, and whether MCP is enabled. Submit via Support.