WP-LIT-MCP/docs/superpowers/notes/2026-09-26-etappe-1b-abnahme.md

Etappe 1b – Manuelle Abnahme (Browser)

Vorbereitet von Task 13 (Doku/Version/E2E). Automatisiert geprüft ist bereits: alle Unit-Tests (composer test), Lint (composer lint) und die drei Integrationsskripte (tests/Integration/mcp-smoke.sh, tests/Integration/wp-basis-smoke.sh, tests/Integration/media-admin-smoke.sh) – Details im Report von Task 13 (.superpowers/sdd/2026-09-25-etappe-1b-medien-admin/task-13-report.md).

Die folgenden Punkte lassen sich nicht automatisiert oder nur mit einem echten claude.ai-Connector prüfen; das führt Jan-Niclas selbst im Browser durch. Aktueller Stand: Version 0.2.0, Branch etappe-1.

1. Einstellungen → LIT MCP: alle Tabs

• Aufrufen: WordPress-Adminbereich → Einstellungen → LIT MCP.
• Alle fünf Tabs öffnen: Verbindung, Zugriff, Tools, Protokoll, Limits. Jeder Tab lädt ohne PHP-Fehler/-Warnung (WP_DEBUG ist an) und zeigt sinnvolle Inhalte.
• Im Tab „Zugriff“: Rolle „Redakteur“ freigeben, speichern; ein Redakteur-Konto kann sich danach verbinden (Access-Capability wirkt sofort, kein Cache). Freigabe wieder entfernen, speichern.
• Im Tab „Tools“: ein Tool (z. B. lit/content-query, Standard „direkt“) auf „indirekt“ stellen, speichern – der Hinweistext dort weist bereits darauf hin, dass die Serveranweisungen erst ab der nächsten Verbindung gelten. Danach wieder auf „Standard“ zurückstellen, speichern.

2. claude.ai-Connector verbinden und Widerruf

• Mit claude.ai verbinden (Staging-Domain oder ddev share), OAuth-Flow durchlaufen.
• Die neue Verbindung erscheint unter Einstellungen → LIT MCP → Zugriff („Aktive Verbindungen“) mit Client-Namen und Zeitpunkt.
• Dort „Widerrufen“ klicken. Der nächste Tool-Aufruf in claude.ai scheitert (401) und claude.ai verlangt eine neue Anmeldung, bevor Tools wieder nutzbar sind.

3. Medien-Workflow in claude.ai

• In claude.ai anfragen: „Suche Bilder ohne Alt-Text, zeig mir eins und schlag einen Alt-Text vor.“ Erwartet: lit-media-search mit missing_alt: true liefert Treffer, lit-media-preview zeigt ein sichtbares Bild in der Unterhaltung (nicht nur eine Textbeschreibung).
• Optional weiterführen: Alt-Text mit lit/media-update speichern lassen und in der WordPress- Mediathek prüfen, dass er übernommen wurde.

4. Werkzeuge → Website-Zustand

• WordPress-Adminbereich → Werkzeuge → Website-Zustand → Reiter „Info“ bzw. die Testübersicht.
• Der Test „LIT MCP Endpunkt“ ist grün, wenn der Server erreichbar und /.well-known/ durchgereicht wird – sonst zeigt er verständlich, was fehlt (z. B. nginx-Sperre für Punkt-Pfade). Bei diesem DDEV-Setup hat mcp-smoke.sh bereits eine WARN dazu ausgegeben (/.well-known/ von der nginx-Konfiguration blockiert) – das hier im Site-Health-Test bestätigen und für die Staging-/Produktions-nginx-Konfiguration eine Ausnahme für /.well-known/ einplanen.

5. Protokoll-Tab

• Einstellungen → LIT MCP → Protokoll: Einträge der eben durchgeführten Tests (Task 13 und die manuellen Schritte hier) sind sichtbar.
• Filter nach Tool/Ability (z. B. lit/media-update) funktioniert und schränkt die Liste ein.
• Ein Eintrag mit Revisions-Link öffnet den WordPress-Revisionsvergleich (z. B. nach einer lit-content-update- oder lit/post-replace-with-copy-Änderung).
• „Protokoll leeren“ leert die Liste (Bestätigungsdialog beachten) und zeigt danach die Erfolgsmeldung „Protokoll geleert.“.

Ergebnis

Kurze Rückmeldung an den Ausführenden (Task 13 / Controller): welche Punkte grün sind und was ggf. als Folgeaufgabe (Bugfix oder Doku-Korrektur) aufgenommen werden muss.