Claude.ai

Claude.ai läuft in Anthropics Infrastruktur. Es gibt keinen lokalen Client, den du installierst, und damit auch keinen Rechner, von dem aus die Verbindung aufgebaut wird. Anthropic ruft deinen MCP-Endpoint direkt auf. Der Server muss deshalb öffentlich über HTTPS erreichbar sein, mit einem Zertifikat einer allgemein anerkannten CA. Interne DNS-Namen, localhost, *.ddev.site und selbstsignierte Zertifikate funktionieren hier nicht. Eine Firewall oder IP-Allowlist muss Anthropics ausgehenden Bereich freigeben (siehe IP-Adressen von Anthropic).

AI Suite MCP authentifiziert Claude.ai über OAuth 2.1 mit dynamischer Client-Registrierung (Dynamic Client Registration). Eigene Request-Header, über die sich ein statisches Token wie bei Claude Desktop mitsenden ließe, bietet Claude nur eingeschränkt an. Diese Anleitung nutzt deshalb OAuth. Eigene Connectors stehen in allen Claude-Tarifen zur Verfügung, mit unterschiedlichen Grenzen (siehe Hilfe von Anthropic zu eigenen Connectors).

• enableMcp ist aktiviert (siehe Konfiguration).
• mcpAllowedRedirectUris enthält claude.ai/api/mcp/auth_callback.
• mcpAllowedOrigins enthält claude.ai.
• mcpAllowedClientIds bleibt leer. Sonst muss die per dynamischer Client-Registrierung erzeugte Client-ID nachträglich von Hand eingetragen werden.
• Die Backend-Gruppe besitzt enable_mcp_access und die benötigten Feature-Rechte (siehe Berechtigungen & Scopes).

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

Scheitert einer der beiden an einer IP-Allowlist, an HTTP Basic Auth oder an einem selbstsignierten Zertifikat, bricht Claude.ai die Verbindung ohne aussagekräftige Meldung ab. Steht die Installation hinter Basic Auth, müssen die MCP-Pfade ausgenommen werden, siehe Produktivbetrieb. Prüfe außerdem, dass der Authorization-Header PHP erreicht. Auf Apache mit mod_php oder FCGI wird er häufig verworfen, was nach erfolgreichem OAuth-Ablauf zu endlosen 401-Antworten führt. Die nötige Rewrite-Regel (Apache) beziehungsweise den fastcgi_param (Nginx) findest du unter Produktivbetrieb.

1. Connector anlegen. Lege in Claude einen eigenen Connector an und trage als URL [typo3-url]/aisuite-mcp ein. Wo das in deinem Tarif liegt und welche Felder der Dialog zeigt, beschreibt die Anleitung von Anthropic zu eigenen Connectors. Verwende ausschließlich die Wurzel-URL ohne Site-Präfix, eine URL wie [typo3-url]/[site]/aisuite-mcp endet in einem 404.

2. Anmeldung festlegen. Wähle unter Authentication „Sign in now“ und unter OAuth client „Register automatically“. Die voreingestellte Option „Use Claude's published identity“ setzt Client ID Metadata Documents voraus, die AI Suite MCP nicht anbietet.

3. Verbinden und zustimmen. Beim Verbinden registriert sich Claude.ai selbständig unter [typo3-url]/aisuite-mcp/oauth/register und öffnet dann ein Fenster mit der 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 landet das Token bei Claude.ai und der Connector gilt als verbunden.

4. Connector pro Unterhaltung aktivieren. Eigene Connectors sind nicht automatisch in jedem Chat aktiv. Schalte den Connector in der Unterhaltung ein, wie in der oben verlinkten Anleitung von Anthropic beschrieben. Erst dann bekommt das Modell die Tool-Definitionen zu sehen.

Den Zugriff kannst du von beiden Seiten beenden. In Claude.ai entfernst du den Connector, im TYPO3-Backend widerrufst du das Token im MCP-Dashboard des Backend-Moduls „AI Suite“ mit „Widerrufen“.

Claude meldet, dass der MCP-Server nicht erreichbar ist, und im TYPO3-Log steht nichts. Der Server ist aus Anthropics Netz nicht erreichbar, antwortet zu langsam, oder das Zertifikat wird nicht anerkannt (selbstsigniert, abgelaufen, falscher Hostname). Prüfe die beiden curl-Aufrufe von einem externen Rechner und ob eine Firewall Anthropics IP-Bereich blockiert (siehe IP-Adressen von Anthropic).

Das Modell behauptet, es habe keinen MCP-Zugriff, obwohl der Connector verbunden ist. Der Connector ist im aktuellen Chat nicht eingeschaltet, siehe Schritt 4.

Es fehlen einzelne Tools (Generieren, Übersetzen, Bilder, Audits). Dem Backend-Benutzer fehlen die zugehörigen AI-Suite-Feature-Rechte. Ergänze sie und authentifiziere dich im Connector neu.

Zum Debuggen ist das Access-Log des Webservers die beste Quelle, denn auf Claude.ai-Seite gibt es keine einsehbaren Protokolle. Ein 404 auf /aisuite-mcp deutet auf ein Site-Präfix in der URL, wiederholte 401 auf den fehlenden Authorization-Header. Auf ein 200 bei /aisuite-mcp/oauth/token sollte unmittelbar ein 200 bei POST /aisuite-mcp folgen. Weitere clientunabhängige Fälle sind unter Clients verbinden gesammelt.