MCP in Practice for TYPO3 · Guide

Connect Gemini to TYPO3

This guide connects Gemini to your TYPO3 through the MCP server of AI Foundation, T3Planet's free and open source extension. MCP, the Model Context Protocol, lets Gemini call the tools of your TYPO3 with the rights of one backend user. Gemini passed our demo test on 30 September 2026: sign in, read a page, change one header on the live demo site, check it and put it back.

Start the setupAll guides
GeminiMCP serverAI FoundationTYPO3as one backend userOAuth sign-in100+ MCP toolsGeminiMCP serverAI FoundationTYPO3as one backend userOAuth sign-in100+ MCP tools
  • Assistant Google users (Gemini Enterprise: admin setup)
  • Tested on our demo, 30 Sep 2026.

What you can do once Gemini is connected

Start with a question that only reads, then hand over real work. Every episode of the series comes with a one-minute video.

Before you start

  • AI Foundation is installed and its MCP server is switched on. Our setup episode TYPO3 MCP setup (coming 14 Oct 2026) shows both.
  • You have the server URL of your TYPO3: in the backend, open MCP Server > Connect. It ends in /mcp.
  • You know which backend user the assistant should act as. It gets that user's rights, so choose one whose rights fit the job.
  • A Gemini product that lets you add a remote MCP server. Google describes this for the Gemini app (Google) and for Gemini Enterprise (Google Cloud), including which accounts and roles can do it.

Connect Gemini

  1. Gemini connects to TYPO3 wherever your Gemini product lets you add a remote MCP server. Add one with the server URL of your TYPO3 and OAuth as the authentication. The menu names, and whether an administrator does this, depend on the product; see Google's page for yours.
    Annotated screenshot of the Connect tab of AI Foundation's MCP server on our demo install: Remote (OAuth) marked Recommended, the server URL ending in /mcp, both OAuth discovery addresses reachable, and the setup guides per client
    MCP Server > Connect on our demo install: copy the server URL here. It ends in /mcp.
  2. If Google's setup names a redirect URI, add it under MCP Server > Advanced > Allowed Redirect URIs in TYPO3 before you sign in.
  3. Start the sign-in. Gemini opens a TYPO3 page in your browser. Sign in as the backend user the assistant should act as, and approve the access.
    Annotated screenshot of the Authorize Application page of AI Foundation on our demo install: the client that asks for access, the empty username and password fields for a TYPO3 backend account, the Authorize button and the AI Foundation MCP Server footer
    The page your browser opens on the first connection. It comes from your own TYPO3, not from the assistant's vendor.
  4. If Gemini asks you to confirm an action, read it before you confirm.

Check the connection

  1. Ask a first question that only reads, in your own words, for example: Give me a quick overview of the pages on our website and the languages they exist in.
  2. In TYPO3, open MCP Server > OAuth Tokens. The connection is listed with its backend user and when it was last used. Revoke ends this one connection and leaves every other assistant connected.
    Annotated screenshot of the OAuth Tokens tab of AI Foundation's MCP server on our demo install: one row per connection with the backend user, when the token was created and last used, when it expires, the workspace and a Revoke button
    MCP Server > OAuth Tokens: one row per connection, each with its own Revoke. Dashed cuts remove client names, an ID and the tokens.

Good to know

  • There is no dry run and no undo tool. Ask the assistant to show the current value before a change, check the page after it, and have it write the old value back if needed.
  • On Live, a change is live at once, because the assistant works as the backend user who approved it.
  • What Gemini reads through MCP goes to its vendor, as with any chat.
  • AI Foundation's core tools are free. AI Assistant, AI Accessibility, AI Chatbot and AI Search add tools of their own and need their licences.

Troubleshooting

What we met on our demo install, in the order you meet it.

The sign-in page does not open

Check that Gemini has the server URL from MCP Server > Connect, ending in /mcp. Without a token, /mcp should answer 401. A 503 means the MCP server is switched off: tick Enable MCP Server under MCP Server > Advanced, save and clear the caches.

The sign-in stops with a redirect error

If Gemini's setup names a redirect URI, add it under MCP Server > Advanced > Allowed Redirect URIs in TYPO3, then sign in again.

The discovery address does not answer with JSON

The sign-in needs your TYPO3's OAuth discovery address. If it does not answer with JSON, check that the site configuration uses your public HTTPS address, then clear the caches.

Gemini gets a 401 after it worked before

Its token expired or was revoked. Connect again from Gemini and sign in; MCP Server > OAuth Tokens then shows the new row.

Questions about Gemini and TYPO3

Is AI Foundation free?

Yes. AI Foundation and its MCP server are free and open source, with no licence key and no registration. Its core tools are free; AI Assistant, AI Accessibility, AI Chatbot and AI Search add tools of their own and need their licences. What Gemini costs is up to its vendor.

What can Gemini do in my TYPO3?

What the backend user who approved the connection may do, through the tools AI Foundation provides. AI Foundation and the AI Universe extensions together bring 100+ MCP tools. Choose a backend user whose rights fit the job.

Can I undo a change Gemini made?

There is no dry run and no undo tool. Ask Gemini to show the current value before a change, check the page after it, and have it write the old value back if needed. On Live, a change is live at once.

Where does my content go?

What Gemini reads through MCP goes to its vendor, as with any chat. Whether that fits your data protection rules is yours to judge, depending on the model you choose.

Can Gemini and another assistant use the same TYPO3?

Yes. Each connection gets its own row in MCP Server > OAuth Tokens, so your editors and your developers can each use their own assistant, and you can revoke one without touching the others.

How do I disconnect Gemini?

In TYPO3, open MCP Server > OAuth Tokens and select Revoke in its row. That ends this one connection; every other assistant stays connected.

Connect another assistant

One MCP server, a guide per assistant. Each one gets its own connection, and you can revoke one without touching the others.

Not sure which assistant fits?

TYPO3 MCP clients compared: how each assistant signs in and its status with AI Foundation.

Coming 14 Oct 2026
Which assistant fits your team?

Which assistant fits your team, on which plan, is compared in TYPO3 MCP clients compared (coming 14 Oct 2026). Every guide and episode is on the hub of MCP in Practice for TYPO3.

Get AI Foundation for TYPO3