Claude Desktop läuft lokal auf macOS, Windows oder Linux. Die Verbindung zum MCP-Server wird von deinem Rechner aus aufgebaut, nicht von Anthropics Infrastruktur. Der MCP-Server muss daher nicht öffentlich erreichbar sein: localhost, *.ddev.site, interne DNS-Namen und selbstsignierte Zertifikate funktionieren, solange dein Betriebssystem der ausstellenden CA vertraut.

Zur Authentifizierung empfiehlt sich für Claude Desktop ein statisches Bearer-Token, das im AI-Suite-Backend erzeugt wird. Das ist der einfachste Weg und kommt ohne OAuth-Einrichtung aus. Alternativ ist der OAuth-Flow möglich (identisch zu Claude.ai). Läuft TYPO3 auf demselben Rechner, gibt es zusätzlich einen lokalen stdio-Modus (siehe vollständiger Guide).

• enableMcp ist aktiviert (siehe Konfiguration).
• mcpAllowHttp nur dann auf 1, wenn die TYPO3-URL reines HTTP ist (lokale Entwicklung ohne TLS). In der Produktion bleibt der Wert 0.
• Die Backend-Gruppe besitzt enable_mcp_access und die benötigten Feature-Rechte (siehe Berechtigungen & Scopes).
• Der TYPO3-Host ist von deinem Rechner aus erreichbar. Ein Aufruf von [typo3-url]/aisuite-mcp/health muss 200 liefern. Bei selbstsigniertem Zertifikat (z. B. DDEV) die CA im System hinterlegen (mkcert -install).
• Claude Desktop ist installiert. Lokale MCP-Server funktionieren auch im kostenlosen Plan.

1. Token erstellen. Öffne im AI-Suite-Backend-Modul den Tab MCP und klicke auf Create Token. Es wird ein an deinen Backend-Benutzer gebundenes Token mit allen Scopes erzeugt, zu denen du berechtigt bist. Kopiere den angebotenen claude_desktop_config.json-Ausschnitt. Die Gültigkeit steuert mcpTokenLifetimeDays (Standard 30).

{
  "mcpServers": {
    "typo3-ai-suite": {
      "url": "[typo3-url]/aisuite-mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer [token]"
      }
    }
  }
}

2. Snippet einfügen. Trage den Ausschnitt in die Konfigurationsdatei von Claude Desktop ein. Vorhandene Einträge unter mcpServers nicht überschreiben, sondern ergänzen. Danach Claude Desktop vollständig beenden und neu starten (Fenster schließen genügt nicht).

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json

3. Verbindung prüfen. Öffne eine neue Unterhaltung und das Tools-/Connector-Menü unter dem Eingabefeld. Unter dem Servereintrag typo3-ai-suite sollten die AI-Suite-Tools erscheinen (getServerInfo, getTables, getPageTree usw.). Die Tools müssen pro Chat aktiviert sein.

• Server fehlt in der Tool-Liste: Die claude_desktop_config.json hat einen JSON-Syntaxfehler oder liegt im falschen Pfad. Datei prüfen (z. B. python -m json.tool) und Pfad gegen die Liste oben abgleichen.
• 401 oder „Authentication required“: Token ungültig, abgelaufen oder widerrufen, oder die URL enthält ein Site-Präfix. Token neu erzeugen und die Root-URL [typo3-url]/aisuite-mcp verwenden.
• SSL-Zertifikatsfehler: Selbstsigniertes Zertifikat, dessen CA dein System nicht kennt. Bei DDEV einmalig mkcert -install ausführen, sonst die CA in den System-Trust-Store importieren.
• Modell meldet „kein MCP-Zugriff“: Die AI-Suite-Tools sind im Chat nicht aktiviert. Im Tools-/Connector-Menü einschalten.

Allgemeine Fehlerquellen (Authorization-Header, leere Tool-Liste, deaktivierter Endpoint) sind unter Sicherheit & Betrieb beschrieben. Die ausführliche Anleitung steht im Connector-Guide im Repository.