169 lines
18 KiB
JSON
169 lines
18 KiB
JSON
{
|
||
"config": {
|
||
"step": {
|
||
"user": {
|
||
"title": "HA-MCP Custom Component",
|
||
"description": "Wähle aus, was hinzugefügt werden soll. **HA-MCP Server** führt den vollständigen ha-mcp-Server innerhalb von Home Assistant aus und stellt ihn über einen Home Assistant Webhook bereit – dies ist die Installation, die die meisten Anwohner wünschen. Es ist ein eigenständiger Server und ein vollständiger Ersatz für alle anderen Installationsmethoden: App (Add-on), Docker, uvx/PyPI, stdio; wenn du ihn ausführst, betreibe nicht gleichzeitig eine dieser anderen. **HA-MCP File & YAML Tools** hat zwei Rollen. Wenn dein ha-mcp-Server außerhalb von Home Assistant läuft – App, Docker, uvx/PyPI, stdio – verleiht dieser Eintrag diesem Server außerdem die Funktionen der In-Process-Komponente, die er von außen nicht erreichen kann (schnelle In-Process-Suche, Konfigurationseintrags-Metadaten, registerbasierte Lesevorgänge), weshalb es sich lohnt, ihn jeder externen Installation hinzuzufügen, und er sichert die privilegierten Datei- und YAML-Bearbeitungsdienste ab, die von den optionalen Datei-/YAML-Tools von ha-mcp genutzt werden. Wenn du stattdessen den Eintrag **HA-MCP Server** hinzufügst, stellt dieser Eintrag diese gemeinsamen Funktionen bereits bereit, sodass dieser zweite Eintrag danach nur noch als Absicherung für die optionalen Datei-/YAML-Tools benötigt wird. Er funktioniert mit jedem Servertyp und kann jederzeit später hinzugefügt werden.",
|
||
"menu_options": {
|
||
"server": "HA-MCP Server (empfohlen)",
|
||
"tools": "HA-MCP File & YAML Tools (optional)"
|
||
}
|
||
},
|
||
"tools": {
|
||
"title": "HA-MCP File & YAML Tools",
|
||
"description": "Richtet die privilegierten Datei- und YAML-Konfigurationsdienste ein, die durch die optionalen Datei-/YAML-Bearbeitungswerkzeuge von ha-mcp abgesichert bleiben (Funktions-Flags, standardmäßig deaktiviert) – dies gilt für jeden Servertyp, einschließlich des In-Process-**HA-MCP Server**. Wenn dein ha-mcp-Server außerhalb von Home Assistant läuft, verleiht dieser Eintrag ihm zudem die Funktionen der In-Process-Komponente, die von außen nicht erreichbar sind (schnelle In-Process-Suche, Konfigurationseintrags-Metadaten, registerbasierte Lesevorgänge), die sich auch dann lohnen, wenn die Datei-/YAML-Tools deaktiviert sind. Du kannst diesen Eintrag jederzeit hinzufügen oder entfernen."
|
||
},
|
||
"server": {
|
||
"title": "HA-MCP Server",
|
||
"description": "Dies führt den vollständigen ha-mcp-Server innerhalb von Home Assistant aus und stellt ihn über einen Home Assistant-Webhook (erreichbar über Nabu Casa oder einen beliebigen Reverse-Proxy) remote bereit. Es ist ein eigenständiger Server und ein vollständiger Ersatz für die Installationsmethoden App (Add-on), Docker, uvx/PyPI und stdio – betreibe ihn nicht parallel zu einem anderen ha-mcp-Server. Wähle **Absenden**, um ihn zu starten; du kannst Port, Bindung und Authentifizierung später in den Integrationsoptionen ändern."
|
||
}
|
||
},
|
||
"abort": {
|
||
"already_configured": "Dieser Eintrag ist bereits eingerichtet.",
|
||
"unsupported_home_assistant": "Der In-Process HA-MCP Server erfordert Home Assistant {required} oder neuer, aber diese Instanz läuft mit {installed}. Du kannst den HA-MCP File & YAML Tools-Eintrag dieser Komponente weiterhin mit einem externen ha-mcp-Server verwenden, der als App (Add-on) oder Docker-Container läuft."
|
||
}
|
||
},
|
||
"options": {
|
||
"step": {
|
||
"tools_info": {
|
||
"title": "HA-MCP File & YAML Tools",
|
||
"description": "Konfiguriere die privilegierten Datei- und YAML-Bearbeitungsdienste, die von den opt-in Datei/YAML-Tools von ha-mcp verwendet werden. Diese Einstellungen erscheinen auch in der eigenen Einstellungs-UI des ha-mcp-Servers und werden live wirksam, ohne Neustart. Eine nicht überschreibbare Deny-Grenze blockiert weiterhin sensible Pfade (z. B. .storage) und Vertrauensgrenzen-Keys (homeassistant, http, frontend, lovelace).",
|
||
"data": {
|
||
"allowed_dirs": "Zusätzliche Dateipfade",
|
||
"extra_yaml_keys": "Zusätzliche YAML-Schreib-Keys"
|
||
},
|
||
"data_description": {
|
||
"allowed_dirs": "Pfade relativ zum Konfigurationsverzeichnis, einschließlich exakter Dateinamen wie sensor.yaml, oder Pfade unter /share, /media, /ssl und /backup. Jedem Eintrag wird Lese- und Schreibzugriff für diesen Pfad und alles darunter gewährt; gib jeden Pfad als separates Listenelement ein. Einträge werden wörtlich abgeglichen; Platzhalter wie * werden nicht unterstützt. Pfadtraversierung und andere unzulässige Pfade werden verworfen.",
|
||
"extra_yaml_keys": "Top-Level-Keys, die ha_config_set_yaml zusätzlich zu den eingebauten schreiben darf, für YAML-first-Integrationen auf dieser Installation (z. B. alert2). Vertrauensgrenzen-Keys werden verworfen."
|
||
}
|
||
},
|
||
"init": {
|
||
"title": "HA-MCP Server",
|
||
"description": "Konfiguriere den HA-MCP Server. {panel_hint}Änderungen hier werden beim Speichern angewendet.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||
"data": {
|
||
"channel": "Release-Kanal",
|
||
"auto_update": "Automatische Server-Updates",
|
||
"server_port": "MCP-Server Listening-Port",
|
||
"bind_host": "Netzwerkzugriff",
|
||
"webhook_auth": "Authentifizierungsmodus",
|
||
"oauth_client_id_override": "Legacy OAuth: benutzerdefinierte Client ID (optional)",
|
||
"oauth_client_secret_override": "Legacy OAuth: benutzerdefiniertes Client Secret (optional)",
|
||
"oauth_regenerate": "Legacy OAuth: Client ID/Secret jetzt neu generieren",
|
||
"pip_spec": "Entwickler: ha-mcp Package Override",
|
||
"server_url": "Home Assistant URL (erweitert)",
|
||
"external_url": "Externe URL (optional)",
|
||
"webhook_id_override": "Benutzerdefiniertes Webhook-Secret (optional)",
|
||
"secret_path_override": "Benutzerdefinierter Direktzugriffs-Pfad (optional)",
|
||
"regenerate_secrets": "Verbindungs-Secrets jetzt neu generieren",
|
||
"enable_webhook": "Remote-Zugriff über Webhook",
|
||
"enable_llm_api": "Conversation-Agent LLM API",
|
||
"llm_api_exposure": "Conversation-Agent Tool-Bereitstellung",
|
||
"enable_startup_notification": "Start-Benachrichtigung",
|
||
"enable_sidebar_panel": "Sidebar-Einstellungen-Panel"
|
||
},
|
||
"data_description": {
|
||
"channel": "Stable installiert das neueste stabile Release; Development installiert den neuesten Development-Build. Wenn automatische Updates an sind, installieren ein Reload oder Restart sowie eine regelmäßige Prüfung den neuesten Build des ausgewählten Kanals. Ein Developer Package Override unten hat Vorrang und deaktiviert automatische Updates.",
|
||
"auto_update": "Wenn an, wird das neueste Release des ausgewählten Kanals automatisch installiert – bei einem Reload oder Restart und über eine regelmäßige Prüfung. Wenn aus, bleibt der Server auf der aktuell installierten Version, bis du dies wieder einschaltest. Dies steuert nur das ha-mcp Server-Package; Updates für das HA-MCP Custom Component selbst kommen weiterhin über HACS.",
|
||
"server_port": "Der Port, auf dem dieser Server lauscht. Die ha-mcp App (Add-on) verwendet 9583, daher ist standardmäßig 9584 voreingestellt, damit beide nebeneinander laufen können – wenn du die App (Add-on) nicht nutzt, funktioniert jeder freie Port.",
|
||
"bind_host": "Wer sich direkt mit dem MCP-Server-Port verbinden kann. Der Standardwert entspricht der App (Add-on): erreichbar in deinem lokalen Netzwerk, mit dem geheimen Pfad als Zugangsdaten. Wähle Loopback, um nur Verbindungen von der Home Assistant-Maschine selbst zuzulassen – die Webhook-URL und das Seitenleifen-Panel funktionieren in beiden Fällen.",
|
||
"webhook_auth": "Wie sich MCP-Clients an der Webhook-URL authentifizieren. Bei der geheimen URL ist der Link selbst die einzige Anmeldeinformation – OAuth läuft weiterhin für Clients, die es nutzen, aber jede Anmeldung wird automatisch genehmigt: kein Login und keine Client-ID oder kein Secret erforderlich. Bei der Home Assistant-Anmeldung melden sich Clients wie claude.ai mit einem Home Assistant-Administratorkonto (OAuth) an. Bei Legacy OAuth betreibt diese Integration einen eigenen Anmeldedienst und stellt eine Client-ID und ein Secret aus, die in Clients eingefügt werden müssen, die eine solche benötigen – ein Neustart von Home Assistant kann erforderlich sein, um sie vollständig ein- oder auszuschalten.",
|
||
"oauth_client_id_override": "Ersetzt die automatisch generierte Legacy OAuth Client ID. Leer lassen, um die aktuelle zu behalten. Wird nur verwendet, während der Authentifizierungsmodus auf Legacy OAuth gesetzt ist.",
|
||
"oauth_client_secret_override": "Ersetzt das automatisch generierte Legacy OAuth Client Secret. Leer lassen, um das aktuelle zu behalten. Wird nur verwendet, während der Authentifizierungsmodus auf Legacy OAuth gesetzt ist.",
|
||
"oauth_regenerate": "Einmalige Aktion: erstellt eine neue Client ID und Secret für den Legacy OAuth Modus. Sie wird erst nach dem Home Assistant Restart wirksam, zu dem die Repair-Meldung auffordert – bis zum Restart funktionieren die vorherigen Client ID und Secret weiter, die neuen noch nicht. Löscht auch die beiden Override-Felder oben.",
|
||
"pip_spec": "Leer lassen. Nur zum Testen eines spezifischen ha-mcp Builds (z.B. ein Pre-Release-Pin); überschreibt den Release-Kanal und deaktiviert automatische Updates, bis es geleert wird.",
|
||
"server_url": "Die URL, die der In-Process-Server nutzt, um deinen Home Assistant zu erreichen (normalerweise diese Instanz selbst). Leer lassen, um sie aus Port und SSL-Einstellungen dieser Instanz abzuleiten; setze nur einen Wert, wenn der Server eine andere Route benötigt.",
|
||
"external_url": "Wird als primäre Verbindungs-URL angezeigt – nutze dies, wenn Home Assistant hinter deiner eigenen Domain oder einem Reverse Proxy liegt. Gib die vollständige Basisadresse inklusive Schema ein. Sie muss direkt auf Home Assistant zeigen – beim Öffnen im Browser sollte deine HA-Login-Seite erscheinen – und darf keinen Port wie :8123 (oder einen anderen Port) enthalten, sonst können remote MCP-Clients sie nicht erreichen. Leer lassen, um automatisch Nabu Casa / die lokale Adresse zu verwenden.",
|
||
"webhook_id_override": "Ersetzt das zufällige Webhook-Secret in der Verbindungs-URL (/api/webhook/...). Die URL ist das Credential – nutze einen langen, schwer zu erratenden Wert. Leer lassen, um das aktuelle zu behalten.",
|
||
"secret_path_override": "Ersetzt den zufälligen Pfad für den Direktzugriff auf dem Server-Port. Gleiche Regel: Der Pfad ist das Credential. Leer lassen, um den aktuellen zu behalten.",
|
||
"regenerate_secrets": "Einmalige Aktion: erstellt ein neues zufälliges Webhook-Secret und einen Direktzugriffs-Pfad, wodurch die alten Verbindungs-URLs sofort ungültig werden. Löscht auch die beiden Override-Felder oben.",
|
||
"enable_webhook": "Ausschalten für nur-lokal-Modus: Der Home Assistant Webhook wird gar nicht registriert, sodass nichts – einschließlich Nabu Casa – den Server über Home Assistant erreichen kann. Der direkte Server-Port und das Sidebar-Panel funktionieren weiter.",
|
||
"enable_llm_api": "Biete das vollständige Toolset für Home Assistant Conversation-Agenten (OpenAI, Google, Ollama, ...) an: Während aktiviert, können Agenten 'HA-MCP Server' unter Control Home Assistant auswählen und die Tools aus Assist-Chat und Sprache nutzen. Das Aktivieren macht es nur auswählbar – nichts wird bereitgestellt, bis du es bei einem Agenten auswählst. Nutzungsanleitung: {llm_api_docs_url}",
|
||
"llm_api_exposure": "Form des Toolsets, das Conversation-Agenten angeboten wird. Tool Search (Standard) hält den Kontext des Agenten klein: eine kompakte API mit angehefteten Tools plus Such/Ausführungs-Meta-Tools. Full Catalog listet jedes bereitgestellte Tool direkt auf – besser für Modelle mit großem Kontext. Both registriert beide nebeneinander, sodass jeder Agent unter Control Home Assistant sein eigenes wählt. Die Tool-Bereitstellung pro Tool wird im HA-MCP Settings Panel verwaltet; Details: {llm_api_docs_url}",
|
||
"enable_startup_notification": "Zeige bei jedem Server-Start eine Benachrichtigung, die auf die nur-für-Administratoren-Einstellungsoberflächen verweist. Ausschalten, um still zu starten – die Verbindungs-URLs erscheinen weiterhin im Home Assistant Log.",
|
||
"enable_sidebar_panel": "Zeige das HA-MCP Settings Panel in der Sidebar (nur Administratoren). Ausschalten, um den Sidebar-Eintrag zu entfernen – Server-Optionen bleiben auf diesem Bildschirm verfügbar."
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"issues": {
|
||
"server_start_failed": {
|
||
"title": "Der HA-MCP In-Process-Server konnte nicht gestartet werden",
|
||
"description": "Der HA-MCP In-Process-Server konnte nicht in Home Assistant gestartet werden:\n\n{detail}\n\nPrüfe die Home Assistant Logs und lade dann die Integration neu (oder behebe das zugrunde liegende Problem und lade neu), um es erneut zu versuchen."
|
||
},
|
||
"server_package_install_failed": {
|
||
"title": "Das HA-MCP In-Process-Server Package konnte nicht installiert werden",
|
||
"description": "Die Installation des ha-mcp Packages für den In-Process-Server ist fehlgeschlagen:\n\n{detail}\n\nBehebe das oben beschriebene Kompatibilitäts- oder Installationsproblem und lade dann die Integration neu, um es erneut zu versuchen."
|
||
},
|
||
"component_outdated": {
|
||
"title": "Aktualisiere das HA-MCP Custom Component über HACS",
|
||
"description": "Der installierte ha-mcp Server benötigt HA-MCP Custom Component {required} oder neuer, aber du hast {installed}. Aktualisiere das Component über HACS (öffne den HA-MCP Custom Component-Eintrag und nutze 'Update information', falls noch kein Update angezeigt wird) und starte Home Assistant neu. Der Server läuft in der Zwischenzeit weiter, aber einige neuere Features funktionieren möglicherweise nicht, bis das Component aktualisiert ist."
|
||
},
|
||
"server_update_held": {
|
||
"title": "HA-MCP Server-Update wartet auf ein Component-Update",
|
||
"description": "ha-mcp Server {latest} ist verfügbar, aber dieses Release hat auch das HA-MCP Custom Component aktualisiert (auf {shipped}; du nutzt {running}). Um zu vermeiden, dass eine Server-Version gestartet wird, die nie mit dem laufenden Component getestet wurde, ist das automatische Server-Update ausgesetzt, bis das Component aktualisiert ist.\n\nAktualisiere das Component über HACS (öffne den HA-MCP Custom Component-Eintrag und nutze 'Update information', falls noch kein Update angezeigt wird), starte dann Home Assistant neu – das Server-Update wird danach automatisch installiert. Um das Server-Update trotzdem zu installieren, drücke Install bei der HA-MCP Server Update-Entität."
|
||
},
|
||
"legacy_hacs_source": {
|
||
"title": "Component aus dem Legacy-Repository installiert",
|
||
"description": "HACS verfolgt das Haupt-Repository des ha-mcp-Servers für diese Komponente, daher zeigt HACS hier die Versionsnummern und Release Notes des Servers anstelle der eigenen der Komponente (2.x). Updates funktionieren weiterhin, bleiben aber auf diese Weise falsch beschriftet. Zur Behebung: Entferne dieses Repository aus HACS (deine Integrationseinstellungen und Konfigurationseinträge bleiben erhalten), füge homeassistant-ai/ha-mcp-integration als benutzerdefiniertes Repository hinzu, installiere die Komponente daraus neu und starte Home Assistant neu."
|
||
},
|
||
"legacy_oauth_restart": {
|
||
"title": "Starte Home Assistant neu, um die Legacy OAuth-Einstellungen anzuwenden",
|
||
"fix_flow": {
|
||
"step": {
|
||
"confirm": {
|
||
"title": "Home Assistant neu starten?",
|
||
"description": "Das Absenden dieses Formulars startet Home Assistant neu und wendet die Legacy OAuth-Einstellungen an.\n\nKlicke auf **Senden**, um jetzt neu zu starten."
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"selector": {
|
||
"server_channel": {
|
||
"options": {
|
||
"stable": "Stable (empfohlen)",
|
||
"dev": "Development (neuester Build)"
|
||
}
|
||
},
|
||
"server_webhook_auth": {
|
||
"options": {
|
||
"none": "Secret Webhook URL (Standard)",
|
||
"ha_auth": "Mit Home Assistant anmelden (OAuth)",
|
||
"legacy": "Legacy OAuth (diese Integration stellt eine Client-ID/ein Secret zum Einfügen aus)"
|
||
}
|
||
},
|
||
"llm_api_exposure": {
|
||
"options": {
|
||
"tool_search": "Tool Search (kompakt, Standard)",
|
||
"full": "Full Catalog",
|
||
"both": "Beides (pro Agent wählen)"
|
||
}
|
||
}
|
||
},
|
||
"entity": {
|
||
"update": {
|
||
"server_update": {
|
||
"name": "Update"
|
||
}
|
||
}
|
||
},
|
||
"common": {
|
||
"connect_direct_access": "Direkter Zugriff von der Home Assistant Maschine: {url}",
|
||
"connect_local_lan": "Lokal/LAN (wenn Netzwerkzugriff auf „Local network“ steht): {url}",
|
||
"connect_remote_url": "Remote-Verbindungs-URL: {url}",
|
||
"connect_urls_label": "Verbindungs-URL(s):",
|
||
"connect_urls_pending": "Die Verbindungs-URLs erscheinen hier (und im Home Assistant Log), sobald der Server gestartet ist.",
|
||
"connect_webhook_disabled": "Remote-Zugriff über Webhook ist deaktiviert (nur-lokal-Modus).",
|
||
"oauth_creds_pending": "Client ID und Client Secret erscheinen hier, sobald der Server gestartet ist.",
|
||
"oauth_not_serving": "Legacy OAuth bedient diese noch nicht — starte Home Assistant neu, wenn du dazu aufgefordert wirst, um sie zu aktivieren.",
|
||
"oauth_select_legacy_mode": "Setze den Authentifizierungsmodus oben auf Legacy OAuth und speichere, um eine Client ID und ein Client Secret zu erzeugen.",
|
||
"panel_hint": "Öffne das [HA-MCP Einstellungs-Panel](/ha-mcp) für Tool-Verwaltung und Servereinstellungen.",
|
||
"tools_module_installed": "Beta-/Erweitert-Modul für Datei- & YAML-Tools (optional): Installiert",
|
||
"tools_module_not_installed": "Beta-/Erweitert-Modul für Datei- & YAML-Tools (optional): Nicht installiert — klicke auf „Eintrag hinzufügen“ auf der Seite dieser Integration und wähle „HA-MCP File & YAML Tools“",
|
||
"tools_module_not_loaded": "Beta-/Erweitert-Modul für Datei- & YAML-Tools (optional): Installiert, aber nicht geladen — aktiviere oder lade den Eintrag „HA-MCP File & YAML Tools“ auf der Seite dieser Integration neu",
|
||
"version_line": "Komponente {component_version} - Server ha-mcp {server_version} ({channel}-Kanal)",
|
||
"version_not_installed": "noch nicht installiert",
|
||
"version_unknown": "unbekannt"
|
||
}
|
||
}
|