Release 0.7.3

README.md

@@ -2,9 +2,9 @@
 
 Sendewerk ist die redaktionelle Webanwendung für den Weg vom vorbereiteten
 Inhalt bis zur moderierten und archivierten Sendung. Der aktuelle Stand umfasst
-Etappe 1 bis 5: technisches Grundgerüst, Anmeldung und Rollen, einen
-persistenten Fundus, den Sendungsbaukasten sowie Live-Steuerung und eine
-abgesicherte Präsentationsausgabe. Abschluss und Archivierung folgen in Etappe 6.
+Etappe 1 bis 7: technisches Grundgerüst, Anmeldung und Rollen, Fundus,
+Sendungsbau, Live-Steuerung, Präsentationsausgabe, Abschluss, Archiv,
+Freigaben, RSS sowie technische REST- und MCP-Zugänge.
 
 ## Voraussetzungen
 
@@ -62,6 +62,9 @@ enthält bewusst kein Konto und kein Standardpasswort.
 Relative Sendewerk-Pfade werden vom Projektverzeichnis aus aufgelöst. In
 Cloudron liegen Datenbank und Uploads unter `/app/data`.
 
+Eine öffentliche Produktions-Origin muss HTTPS verwenden. Nur für lokale
+Loopback-Adressen bleibt HTTP zulässig.
+
 Der Vorgabemodus `local` baut keine Netzwerkverbindung auf. Einladungen und
 Passwort-Resets landen als JSON-Dateien in `.data/mail-outbox`; die enthaltenen
 Links sind Geheimnisse und dürfen nicht veröffentlicht werden. Echter Versand
@@ -151,6 +154,53 @@ DNS-, Redirect-, Zeit- und Größenlimits abgerufen. Private und lokale
 Netzwerkziele sind gesperrt. Eingebettetes HTML oder Skripte einer Quellseite
 werden nicht übernommen.
 
+## MCP und ChatGPT
+
+Der lesende Streamable-HTTP-Endpunkt liegt unter `/mcp`. Seine konkrete
+Adresse ist die konfigurierte Anwendungs-Origin mit angehängtem Pfad:
+
+```text
+https://<Cloudron-App-Domain>/mcp
+```
+
+Beispiel: Bei `SENDEWERK_APP_ORIGIN=https://sendewerk.example.org` lautet die
+MCP-URL `https://sendewerk.example.org/mcp`. Niemals einen technischen
+REST-Token an die URL hängen oder in ChatGPT eintragen. MCP verwendet einen
+eigenen OAuth-2.1-Flow mit Authorization Code, PKCE und kurzlebigen Tokens.
+
+Die Verbindung stellt ausschließlich lesende Werkzeuge bereit:
+
+- `get_profile` identifiziert das verbundene Sendewerk-Konto ohne E-Mail-Adresse.
+- `list_pieces` und `get_piece` lesen Fundus-Pieces.
+- `list_shows` und `get_show_rundown` lesen Sendungen und deren Abläufe.
+
+Die Detailwerkzeuge können private Recherche, Moderationsnotizen, Quellen,
+eigene Notizen und Reserveinhalte liefern. Der angemeldete Nutzer muss diesem
+Umfang ausdrücklich zustimmen. Sperrung oder Passwortwechsel widerrufen
+bestehende OAuth-Tokens; jede MCP-Anfrage prüft Konto, Scope, Ablauf und
+Zielressource erneut. MCP kann keine Inhalte schreiben.
+
+### In ChatGPT einrichten
+
+1. Zuerst Version `0.7.3` unter der endgültigen öffentlichen HTTPS-Origin
+   bereitstellen. Lokalhost ohne öffentliches HTTPS ist für eine direkte
+   ChatGPT-Verbindung nicht erreichbar.
+2. In [ChatGPT Plugins](https://chatgpt.com/plugins) das Plus wählen und
+   **Add custom MCP server** öffnen.
+3. Einen Namen und eine Beschreibung vergeben und unter **Connection** die
+   vollständige URL `https://<Cloudron-App-Domain>/mcp` eintragen.
+4. OAuth als Authentifizierung verwenden, den Risikohinweis prüfen und
+   **Create as a plugin** wählen. ChatGPT entdeckt die OAuth-Endpunkte und
+   registriert einen öffentlichen PKCE-Client dynamisch.
+5. Im geöffneten Sendewerk-Fenster mit dem eigenen Konto anmelden, Clientname
+   und Rücksprung-Domain prüfen und den lesenden Zugriff ausdrücklich erlauben.
+6. Die gefundenen fünf Werkzeuge kontrollieren, das Plugin installieren und in
+   einer neuen Unterhaltung über `@` auswählen.
+
+Eine erfolgreich lokale OAuth- und MCP-Prüfung beweist noch keine reale
+ChatGPT-Verbindung. Diese muss nach dem Cloudron-Update separat in der
+jeweiligen ChatGPT-Workspace-Konfiguration durchgeführt werden.
+
 ## Befehle
 
 | Befehl               | Zweck                                                      |
@@ -210,6 +260,12 @@ Umgebungsvariable gesetzt werden. `CLOUDRON_APP_ORIGIN` liefert dort die feste
 HTTPS-Origin. SMTP-Zugangsdaten werden ebenfalls ausschließlich als
 Laufzeitvariablen gesetzt, nicht in Manifest oder Image geschrieben.
 
+Für MCP sind keine zusätzlichen Geheimnisse erforderlich. Nach einem Update
+auf `0.7.3` führt der bestehende Startprozess Migration `0020_oauth_mcp.sql`
+aus. Anschließend muss die von Cloudron gelieferte HTTPS-Origin mit der in
+ChatGPT eingetragenen MCP-Domain übereinstimmen. Reverse Proxy und öffentliche
+Erreichbarkeit wurden ohne Cloudron-Zugang nicht geprüft.
+
 Das ersetzt keinen Test auf einem echten Cloudron. Insbesondere Addon-Backup,
 Restore, Proxy-Origin und das read-only Laufzeitdateisystem können erst dort
 abschließend geprüft werden.