Skip to main content Skip to page footer

ChatGPT

ChatGPT läuft in der Infrastruktur von OpenAI. Es gibt keinen lokalen Client, OpenAI ruft deinen MCP-Endpoint direkt auf. Der Server muss daher öffentlich über HTTPS erreichbar sein, mit einem Zertifikat einer allgemein anerkannten CA. localhost, *.ddev.site und selbstsignierte Zertifikate funktionieren nicht. Eine Firewall oder IP-Allowlist muss den Ausgangsbereich von OpenAI freigeben (siehe IP-Bereiche von OpenAI).

Authentifiziert wird über OAuth 2.1. ChatGPT bevorzugt Client ID Metadata Documents. AI Suite MCP bietet diese nicht an, deshalb registriert sich ChatGPT per dynamischer Client-Registrierung (Dynamic Client Registration). Eigene MCP-Server stehen nur in bezahlten ChatGPT-Tarifen zur Verfügung, und Administratoren können die Funktion einschränken. Welche Tarife das sind, beschreibt die Anleitung von OpenAI zu eigenen MCP-Servern.

Voraussetzungen

Prüfe die öffentliche Erreichbarkeit von einem Rechner außerhalb deines Netzes. Beide Aufrufe müssen 200 liefern:

curl -sS [typo3-url]/aisuite-mcp/health
curl -sS [typo3-url]/.well-known/oauth-authorization-server

Blockiert eine IP-Allowlist, HTTP Basic Auth oder ein selbstsigniertes Zertifikat einen der beiden Pfade, scheitert die Verbindung ohne brauchbare Fehlermeldung. Steht die Installation hinter Basic Auth, müssen die MCP-Pfade ausgenommen werden, siehe Produktivbetrieb. Stelle außerdem sicher, dass der Authorization-Header PHP erreicht, sonst folgen nach erfolgreichem OAuth-Ablauf endlose 401-Antworten.

Verbindung einrichten

1. Eigenen MCP-Server anlegen. Lege in ChatGPT einen eigenen MCP-Server als Plugin an, trage als Server-URL [typo3-url]/aisuite-mcp ein und wähle als Authentifizierung OAuth. Nutze nur die Wurzel-URL ohne Site-Präfix. Wo das in ChatGPT liegt und welche Felder der Dialog zeigt, beschreibt die Anleitung von OpenAI zu eigenen MCP-Servern.

2. Verbinden und zustimmen. Beim Verbinden registriert sich ChatGPT unter [typo3-url]/aisuite-mcp/oauth/register und öffnet die Autorisierungsseite. Dort meldest du dich mit deinen TYPO3-Backend-Zugangsdaten an, auch wenn du im Backend schon angemeldet bist, danach folgt die Zustimmungsseite mit den angeforderten Scopes. Nach der Bestätigung ist das Plugin verbunden.

3. Im Chat aufrufen. Rufe das Plugin im Chat per @ auf. Erst dann sind die Tools für das Modell sichtbar. Wie du ein Plugin verbindest und testest, beschreibt die Anleitung von OpenAI zum Verbinden und Testen eines Plugins.

Den Zugriff beendest du entweder in ChatGPT durch Entfernen des Plugins oder im TYPO3-Backend im MCP-Dashboard des Backend-Moduls „AI Suite“ mit „Widerrufen“.

Fehlerbehebung

Beim Verbinden passiert nichts, und im TYPO3-Log steht nichts. Der Server ist aus OpenAIs Netz nicht erreichbar oder das Zertifikat wird nicht anerkannt. Prüfe die beiden curl-Aufrufe von einem externen Rechner.

Das Modell behauptet, es habe keinen MCP-Zugriff, obwohl das Plugin verbunden ist. Das Plugin ist im aktuellen Chat nicht aufgerufen, siehe Schritt 3.

Es fehlen einzelne Tools (Generieren, Übersetzen, Bilder, Audits). Dem Backend-Benutzer fehlen die zugehörigen AI-Suite-Feature-Rechte. Rechte ergänzen und im Plugin neu authentifizieren.

Auf ChatGPT-Seite sind keine Protokolle einsehbar. Aussagekräftig ist das Access-Log des Webservers. Ein 404 auf /aisuite-mcp deutet auf ein Site-Präfix, wiederholte 401 auf den fehlenden Authorization-Header. Weitere clientunabhängige Fälle sind unter Clients verbinden gesammelt.