.. include:: ../Includes.txt


.. _introduction-section:
.. _introduction:

============
Introduction
============

Overview
========

**AI Foundation** (``EXT:ns_t3af``) is T3Planet’s shared AI foundation for TYPO3.
It is the central engine behind all T3Planet AI extensions.

AI Foundation connects TYPO3 to AI models, manages API keys, exposes an MCP
server for AI agents, and logs every request — so your team uses AI in a safe,
consistent way. Editors work through connected extensions such as AI Assistant
or AI Chatbot. Admins configure everything in the **AI Foundation** backend
module group.

Key capabilities
----------------

* **AI Providers** — Connect OpenAI, Claude, Gemini, and other vendors with encrypted API keys
* **MCP Server** — Expose TYPO3 to Cursor, Claude Desktop, and other MCP clients
* **AI Context** — Store brand voice once for on-brand AI output
* **AI Prompts & Features** — Shared prompt templates and per-feature provider assignment
* **Usage & Logs** — Token usage, request history, and operational telemetry
* **AI Permissions** — Role-based access for backend usergroups, modules, features, records, and credit limits
* **Quick Setup** — Guided first-time configuration wizard

Helpful Links
-------------

.. note::

   * Product: https://t3planet.de/ai-foundation-fur-typo3
   * Get support: https://t3planet.de/support
   * License activation: https://docs.t3planet.de/en/latest/License/Index.html

.. _video-tutorials:

Video Tutorials
===============

Interactive Supademo walkthroughs help admins and managers learn **AI Foundation**
setup and daily operation. Follow the order below, then practice in your staging
TYPO3 instance.

Recommended viewing order
-------------------------

1. **What is AI Foundation?** — Everyone. Start here for the big picture.

   `AI Foundation Dashboard Demo <https://app.supademo.com/embed/cmrbp02gg0dysqmo5wfd0olu1?utm_source=link>`__

2. **Install and activate** — Admins. Pair with :ref:`Installation <installation>`.

   `AI Foundation Quick Setup Demo <https://app.supademo.com/embed/cmrbnnxgy0cp3qmo5e1ciofeq?utm_source=link>`__

3. **Configure AI providers** — Admins. Pair with :ref:`AI Providers <ai-providers>`.

   `AI Foundation Providers Demo <https://app.supademo.com/embed/cmrbo0w7i0d96qmo57ifnabvz?utm_source=link>`__

4. **MCP Server — connect Cursor** — Admins and developers. Pair with :ref:`MCP Server <mcp-server>`.

   `AI Foundation MCP Server Demo <https://app.supademo.com/embed/cmrbp5q660ej4qmo546ztyk1h?utm_source=link>`__

5. **AI Permissions** — Admins. Pair with :ref:`AI Permissions <ai-permissions>`.

   `AI Foundation AI Permissions Demo <https://app.supademo.com/embed/cmrbpvc5y0g0vqmo5l30iq6mc?utm_source=link>`__

6. **Usage logs and cost control** — Admins and managers. Pair with :ref:`AI Usage & Logs <ai-usage-and-logs>`.

   `AI Foundation AI Usage Demo <https://app.supademo.com/embed/cmrbpqbgz0fn3qmo5oaq6j1t9?utm_source=link>`__

.. _credits:

Credits
=======

This extension is developed and maintained by:

**T3Planet project by NITSAN**: https://nitsantech.de/typo3-agentur

Developed with modern AI tooling by the NITSAN/T3Planet team — following TYPO3 coding standards, reviewed by certified TYPO3 developers, and tested across TYPO3 v12, v13 and v14.