---
title: "Known Problems"
manual: "AI Foundation"
version: "1.2"
permalink: "https://docs.typo3.org/permalink/nitsan/ns-t3af:known-problems@1.2"
source: "Troubleshooting/KnownProblems/Index.rst"
modified: "2026-09-15T06:30:06+00:00"
---

# 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.
1.  Flush all caches.
1.  Run:

    ```bash
    ./vendor/bin/typo3 extension:setup
    ./vendor/bin/typo3 cache:flush
    ```

Also confirm `scheduler` and `workspaces` are available. See
[Installation](https://docs.typo3.org/permalink/nitsan/ns-t3af:installation@1.2).

## 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](https://docs.typo3.org/permalink/nitsan/ns-t3af:mcp-testing@1.2).
-   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](https://docs.typo3.org/permalink/nitsan/ns-t3af:ai-permissions@1.2).

## Report an issue

Include TYPO3 version, PHP version, `ns_t3af` version, exact error text, and
whether MCP is enabled. Submit via [Support](https://docs.typo3.org/permalink/nitsan/ns-t3af:support@1.2).