Neues Dokument erstellen

Dokument verschieben/umbenennen

Anhänge

Dokumentdateien

Angehängte Dateien werden geladen...

Dokumentverlauf

Frühere Versionen

Loading versions...

Vorschau

Wählen Sie eine Version zur Vorschau

Wiki-Einstellungen

Wiki-Titel

Eigentümer

Urheberrechtshinweis

Zeitzone

Oberflächensprache

Sprache für die Benutzeroberfläche

Protokollebene

Bestimmt, welche Protokollmeldungen in die Konsole geschrieben werden (debug, info, warn, error)

Dokumentversionen Anzahl der zu speichernden Versionen pro Dokument. Auf 0 setzen, um die Versionierung zu deaktivieren.

Maximale Dateigröße Maximal erlaubte Dateigröße für Uploads in MB.

Privates Wiki (Anmeldung zum Anzeigen erforderlich)

Kommentare systemweit deaktivieren

Dateiupload-Überprüfung deaktivieren

Link-Einbettung aus Zwischenablage aktivieren

Anhangsbereich in Dokumenten ausblenden

Volle Breite für Inhalte auf dem Desktop verwenden (900px-Begrenzung deaktivieren)

Kinder-Elemente im Seitenpanel stets öffnen

Benutzerverwaltung

Neuen Benutzer hinzufügen

Benutzername

Passwort Leer lassen, um das aktuelle Passwort beizubehalten

Benutzerrolle

Zugriffsgruppen

Benutzer in diesen Gruppen können auf eingeschränkte Bereiche zugreifen.

Definieren Sie pfadbasierte Zugriffsregeln für Bereiche Ihres Wikis. Regeln werden in der Reihenfolge ausgewertet. Die erste Übereinstimmung gewinnt.

Aktive Regeln

Markdown-Dateien aus einem ZIP-Archiv importieren. Dateien werden verarbeitet und in der entsprechenden Dokumentstruktur gespeichert. Die Verzeichnisstruktur in der ZIP-Datei (Kategorie/Unterkategorie) wird im Wiki beibehalten.

ZIP-Archiv auswählen Laden Sie ein ZIP-Archiv hoch, das Markdown-Dateien (.md) zum Importieren enthält.

Erstellen und verwalten Sie Backups Ihrer Wiki-Daten. Backups umfassen alle Dokumente, Bilder und Konfigurationsdateien.

Verfügbare Backups

Lade Backups...

Zugriffsregel hinzufügen/bearbeiten

Link hinzufügen

› Virtualisierung › Docker › Container als Stack › MCP-HomeAssistent

MCP-HomeAssistent ¶

HA-MCP ist ein Model-Context-Protocol-Server für Home Assistant, der Home Assistant per HTTP/Web-Schnittstelle für MCP-fähige Clients (z.B. Cherry Studio) zugänglich macht.

Voraussetzungen ¶

Ein Long-Lived Access Token aus Home Assistant (Profil → Sicherheit → Langlebige Zugriffstoken)

Tip

Optional

Wenn HA-MCP auch von außerhalb des Heimnetzes erreichbar sein soll, werden zusätzlich folgende Komponenten benötigt:

eine Domain, die auf den Router zeigt
Portweiterleitungen für 80 und 443 vom Router zum Nginx Proxy Manager (NPM)
eine Subdomain
ein entsprechender Proxy-Host im Nginx Proxy Manager, der auf den Docker-Container weiterleitet

Verzeichnisse anlegen ¶

Proxmox-VM ¶

mkdir /syno/ha-mcp

Synology ¶

Im Docker-Ordner folgende Verzeichnisstruktur anlegen:

ha-mcp

Compose-Stack ¶

services:
  ha-mcp:
    image: ghcr.io/homeassistant-ai/ha-mcp:latest
    container_name: ha-mcp
    restart: unless-stopped

    user: "1000001:1000001" # LDAP User

    volumes:
      # Für die Proxmox-VM verwenden
      - /syno/ha-mcp:/home/mcpuser/.ha-mcp

      # Für die Synology verwenden
      # Volume-Nummer ggf. anpassen
      - /volume2/docker/ha-mcp:/home/mcpuser/.ha-mcp

    environment:
      HOMEASSISTANT_URL: "http://192.168.2.63:8123"
      HOMEASSISTANT_TOKEN: "<long-lived-access-token>"
      MCP_PORT: "9000"

    command: ha-mcp-web

    ports:
      - "9000:9000"
    healthcheck:
      test: ["CMD", "python3", "-c", "import socket; socket.create_connection(('localhost', 9000), 3).close()"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 15s

Warning

Das HOMEASSISTANT_TOKEN ist im obigen Stack durch einen Platzhalter ersetzt — siehe Notizen.

Web-Zugriff ¶

Port: 9000 (intern und extern identisch gemappt)
Direktzugriff: http://<host-ip>:9000

Note

Der Healthcheck prüft per Python-Socket-Verbindung die Erreichbarkeit auf Port 9000 innerhalb des Containers.

Volumes ¶

Oberfläche	Host-Pfad	Container-Pfad	Zweck
Proxmox-VM	`/syno/ha-mcp`	`/home/mcpuser/.ha-mcp`	Konfiguration und Daten von HA-MCP
Synology	`/volume2/docker/ha-mcp`	`/home/mcpuser/.ha-mcp`	Konfiguration und Daten von HA-MCP

Umgebung ¶

Variable	Wert	Bedeutung
`HOMEASSISTANT_URL`	`http://192.168.2.63:8123`	Adresse der Home-Assistant-Instanz
`HOMEASSISTANT_TOKEN`	(siehe Notizen)	Zugriffstoken für die Home-Assistant-API
`MCP_PORT`	`9000`	Port, auf dem der MCP-Webserver läuft

Container-User: 1000001:1000001 (LDAP-User)
Neustart-Verhalten: unless-stopped

Neues Dokument erstellen

Dokument verschieben/umbenennen

Dokument löschen

Message

Confirm Action

Anhänge

Dokumentdateien

Dokumentverlauf

Frühere Versionen

Vorschau

Wiki-Einstellungen

Benutzerverwaltung

Neuen Benutzer hinzufügen

Aktive Regeln

Importergebnisse

Verfügbare Backups

Zugriffsregel hinzufügen/bearbeiten

Spalte hinzufügen

Link hinzufügen

MCP-HomeAssistent ¶

Voraussetzungen ¶

Verzeichnisse anlegen ¶

Proxmox-VM ¶

Synology ¶

Compose-Stack ¶

Web-Zugriff ¶

Volumes ¶

Umgebung ¶

Anmelden

Neues Dokument erstellen

Dokument verschieben/umbenennen

Dokument löschen

Message

Confirm Action

Anhänge

Dokumentdateien

Dokumentverlauf

Frühere Versionen

Vorschau

Wiki-Einstellungen

Benutzerverwaltung

Neuen Benutzer hinzufügen

Aktive Regeln

Importergebnisse

Verfügbare Backups

Zugriffsregel hinzufügen/bearbeiten

Spalte hinzufügen

Link hinzufügen

MCP-HomeAssistent ¶

Voraussetzungen ¶

Verzeichnisse anlegen ¶

Proxmox-VM ¶

Synology ¶

Compose-Stack ¶

Web-Zugriff ¶

Volumes ¶

Umgebung ¶