Add native chat background and guarded HA YAML access

platform/mcp/README.md

@@ -117,6 +117,40 @@ Schreibende Aktionen bleiben hinter der jeweiligen serverseitigen Policy und
 einem Vorschau-/Bestätigungsablauf. Ein Client-Schalter allein darf niemals
 eine read-only Policy aufheben.
 
+## Home Assistant: abgesicherter YAML-Zugang
+
+Die Referenzinstallation überlagert im nativen `czechbol/hass-mcp` das Werkzeug
+`ha_yaml_config` mit
+`patches/hass_mcp/yaml_config.py`. Es erlaubt strukturierte Zugriffe nur auf
+`automations.yaml`, `scripts.yaml` und `scenes.yaml`. Für auskommentierte Blöcke
+stehen begrenztes `read_source` und `find_source` zur Verfügung;
+`configuration.yaml` darf dabei ebenfalls gelesen werden. Beliebige Pfade und
+`secrets.yaml` sind konstruktiv ausgeschlossen. Verdächtige Inline-Zugangsdaten
+und selbst Namen von `!secret`-Referenzen werden in Rohtextantworten maskiert.
+
+Jede Änderung arbeitet zweistufig: Vorschau mit einmaligem Ticket, anschließend
+derselbe unveränderte Aufruf mit `confirm=true` nach ausdrücklicher Zustimmung.
+Vor dem atomaren Schreiben wird eine lokale Sicherung erzeugt. Danach läuft die
+vollständige Home-Assistant-Konfigurationsprüfung; bei Fehlern oder gescheitertem
+Reload wird automatisch zurückgerollt. `configuration.yaml` wird nicht live neu
+geladen und meldet deshalb nach einer erfolgreichen Änderung
+`restart_required=true`.
+
+Installation auf dem Host, der das Home-Assistant-Konfigurationsverzeichnis
+besitzt:
+
+```bash
+sudo platform/mcp/install-hass-mcp-yaml-guard.sh \
+  /mnt/user/appdata/HomeAssistant/config
+```
+
+Danach Home Assistant kontrolliert neu starten und den Werkzeugkatalog prüfen.
+Der Installer aktiviert **nicht** pauschal Schreibrechte: In Home Assistant unter
+**Einstellungen → Geräte & Dienste → Native MCP for Home Assistant → Konfigurieren**
+muss `Allow write tools` bewusst eingeschaltet werden. Das gibt auch anderen
+nicht-destruktiven Schreibwerkzeugen dieser Integration Zugriff und sollte daher
+nur zusammen mit sichtbarer Tool-Freigabe im Client aktiviert werden.
+
 ## Sonarr: sichere Episodensuche
 
 Der lokale Sonarr-Patch stellt bewusst keine freie Sonarr-Command-API bereit.