Claude Code ist Anthropics Agent für das Terminal und läuft lokal auf macOS, Windows oder Linux. Die Verbindung zum MCP-Server wird von deinem Rechner aus aufgebaut. Der Server muss also nicht öffentlich erreichbar sein. Es funktionieren localhost, *.ddev.site, interne DNS-Namen und selbstsignierte Zertifikate, solange dein Betriebssystem der ausstellenden CA vertraut.

Es gibt drei Wege, sich anzumelden:

• Weg A, statisches Token. Am einfachsten und ohne Browser. Token im AI Suite-Backend erzeugen, mit einem Befehl auf der Kommandozeile hinterlegen. Passend für CI, Skripte und Rechner ohne Oberfläche.
• Weg B, OAuth 2.1 mit localhost-Callback. Beim ersten Kontakt öffnet Claude Code einen Browser und führt den vollen OAuth-Ablauf gegen einen kurzlebigen lokalen Port. Passend für Arbeitsplatzrechner, wenn du kurzlebige Tokens mit automatischer Erneuerung möchtest.
• Weg C, lokaler stdio-Transport. Läuft TYPO3 auf demselben Rechner, brauchst du weder Token noch OAuth noch eine erreichbare URL. Siehe Lokaler stdio-Transport.

• enableMcp ist aktiviert (siehe Konfiguration).
• mcpAllowedRedirectUris ist nicht nötig. Claude Code nutzt http://localhost:[port]/callback, und localhost ist immer erlaubt.
• mcpAllowedOrigins ist nicht nötig, es findet kein browserseitiger Aufruf von fremder Herkunft statt.
• mcpAllowHttp nur dann auf 1, wenn deine TYPO3-URL reines HTTP ist (lokale Entwicklung ohne TLS). Produktiv bleibt der Wert 0.
• Die Backend-Gruppe besitzt enable_mcp_access und die benötigten Feature-Rechte (siehe Berechtigungen & Scopes).
• Claude Code ist installiert, claude --version funktioniert.

Prüfe im selben Terminal, in dem du Claude Code startest, dass der Host erreichbar ist. Der Aufruf muss 200 liefern:

curl -sS [typo3-url]/aisuite-mcp/health

Bei einem selbstsignierten Zertifikat, etwa aus DDEV, muss die CA im Zertifikatsspeicher des Betriebssystems liegen (mkcert -install).

1. Token erstellen. Öffne im AI Suite-Backend-Modul den Tab MCP und klicke auf Create Token. Das Token ist an deinen Backend-Benutzer gebunden und enthält alle Scopes, zu denen du berechtigt bist. Die Gültigkeit steuert mcpTokenLifetimeDays (Standard 30).

2. Server registrieren. Setze die eigene TYPO3-URL und das kopierte Token ein:

Die Konfiguration landet in ~/.claude.json, mit --scope project stattdessen in der projektlokalen .claude/mcp.json. Prüfen lässt sich das Ergebnis mit claude mcp list, dort muss typo3-ai-suite auftauchen.

Läuft das Token ab, erzeugst du ein neues und registrierst den Server erneut:

1. Server ohne Token registrieren. Der fehlende --header ist genau das Signal, das den OAuth-Ablauf auslöst:

2. Erste Verbindung. Beim nächsten Kontakt mit dem Server, also beim Sitzungsstart oder beim ersten Tool-Aufruf, registriert sich Claude Code unter [typo3-url]/aisuite-mcp/oauth/register, öffnet einen lokalen Listener auf einem freien Port und ruft im Browser die Autorisierungsseite auf. Nach der TYPO3-Anmeldung und der Zustimmung zu den Scopes leitet der Browser auf den lokalen Listener zurück, und Claude Code tauscht den Code gegen Tokens, die es in ~/.claude.json ablegt. Danach werden die Tokens automatisch weiterverwendet und erneuert.

3. Verbindung prüfen. In einer laufenden Sitzung zeigt der Befehl /mcp alle konfigurierten Server samt Status. typo3-ai-suite sollte connected melden, und die Tools stehen dem Model zur Verfügung.

Der Server erscheint in claude mcp list, aber jeder Aufruf endet mit 401 oder „Authentication required“ (Weg A). Das Token ist ungültig, abgelaufen oder widerrufen, oder die URL enthält ein Site-Präfix. Token neu ausstellen und die Wurzel-URL [typo3-url]/aisuite-mcp verwenden.

/mcp meldet den Server als failed, ohne weitere Angabe. Die Verbindung scheitert vor dem Protokoll-Handshake, in der Regel an TLS, DNS oder einem falschen Pfad. Prüfe curl [typo3-url]/aisuite-mcp/health im selben Terminal, bei selbstsignierten Zertifikaten mkcert -install ausführen.

Der Browser zeigt beim Redirect eine Zertifikatswarnung (Weg B). Die CA ist dem Browser nicht bekannt. CA auf Betriebssystemebene vertrauen und den Browser neu starten.

Zum Mitlesen schreibt claude --debug ausführlich auf stderr, und /mcp logs typo3-ai-suite zeigt den letzten Verkehr. Weitere clientunabhängige Fälle sind unter Clients verbinden gesammelt.