429 files
This commit is contained in:
Home Assistant Version Control committed
1 parent
472c19bceb
commit
963cce81a7
566 files changed
+50311
-47616
No files matched your search
@@ -0,0 +1,168 @@
|
||||
{
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "Vlastní komponenta HA-MCP",
|
||||
"description": "Vyberte, co chcete přidat. **HA-MCP Server** spustí kompletní server ha-mcp uvnitř Home Assistanta a zpřístupní ho prostřednictvím webhooku Home Assistanta – toto je instalace, kterou většina uživatelů chce. Jedná se o samostatný server a kompletní náhradu za všechny ostatní způsoby instalace: Aplikace (doplněk), Docker, uvx/PyPI, stdio; pokud jej spouštíte, nespouštějte současně žádnou z nich. **HA-MCP File & YAML Tools** má dvě role. Pokud váš server ha-mcp běží mimo Home Assistanta – aplikace, Docker, uvx/PyPI, stdio – tato položka tomuto serveru poskytuje také schopnosti komponenty běžící v procesu, které nemůže dosáhnout zvenčí (rychlé vyhledávání v procesu, metadata položky konfigurace, čtení podpořená registry), takže stojí za to ji přidat ke každé externí instalaci, a slouží jako brána pro privilegované služby úprav souborů a YAML, které používají volitelné nástroje pro soubory/YAML v ha-mcp. Pokud místo toho přidáte položku HA-MCP Server, tato položka již tyto sdílené schopnosti poskytuje, takže tato druhá položka je pak potřeba pouze jako brána pro volitelné nástroje pro soubory/YAML. Funguje se všemi typy serverů a lze ji přidat kdykoliv později.",
|
||||
"menu_options": {
|
||||
"server": "Server HA-MCP (doporučeno)",
|
||||
"tools": "Nástroje souborů a YAML HA-MCP (volitelné)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "Nástroje souborů a YAML HA-MCP",
|
||||
"description": "Nastavuje privilegované služby pro úpravy konfigurace souborů a YAML, které zůstávají chráněny za volitelnými nástroji pro úpravy souborů/YAML v ha-mcp (funkční příznaky, ve výchozím nastavení vypnuto) – to platí pro každý typ serveru, včetně vnitroprocesového HA-MCP Serveru. Pokud váš server ha-mcp běží mimo Home Assistanta, tato položka mu také poskytuje schopnosti komponenty běžící v procesu, které nemůže dosáhnout zvenčí (rychlé vyhledávání v procesu, metadata položky konfigurace, čtení podpořená registry), které stojí za to mít i s vypnutými nástroji pro soubory/YAML. Tuto položku můžete kdykoliv přidat nebo odebrat."
|
||||
},
|
||||
"server": {
|
||||
"title": "Server HA-MCP",
|
||||
"description": "Tím se spustí kompletní server ha-mcp uvnitř Home Assistanta a zpřístupní se vzdáleně prostřednictvím webhooku Home Assistanta (dostupného přes Nabu Casa nebo libovolný reverzní proxy server). Jedná se o samostatný server a kompletní náhradu za instalační metody App (add-on), Docker, uvx/PyPI a stdio – nespouštějte jej současně s jiným serverem ha-mcp. Výběrem možnosti **Odeslat** jej spustíte; port, vazbu a ověřování můžete později změnit v nastavení integrace."
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "Tato položka je již nastavena.",
|
||||
"unsupported_home_assistant": "In-process HA-MCP Server vyžaduje Home Assistant {required} nebo novější, ale tato instance běží na verzi {installed}. Záznam HA-MCP File & YAML Tools této komponenty můžete stále používat s externím serverem ha-mcp běžícím jako app (add-on) nebo kontejner Docker."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "Nástroje souborů a YAML HA-MCP",
|
||||
"description": "Nakonfigurujte privilegované služby pro úpravu souborů a YAML používané volitelnými nástroji souborů/YAML ha-mcp. Tato nastavení se také zobrazují v uživatelském rozhraní nastavení serveru ha-mcp a aplikují se okamžitě, bez restartu. Nepřepisovatelná úroveň zákazu stále blokuje citlivé cesty (např. .storage) a klíče hranice důvěry (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Další adresáře souborů",
|
||||
"extra_yaml_keys": "Další klíče pro zápis YAML"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Adresáře vzhledem ke konfiguračnímu adresáři, každému je uděleno právo čtení a zápisu (např. pyscript). Průchod a položky mimo konfiguraci jsou zahozeny.",
|
||||
"extra_yaml_keys": "Klíče nejvyšší úrovně, které ha_config_set_yaml může zapisovat navíc k vestavěným, pro integrace s prioritou YAML v této instalaci (např. alert2). Klíče hranice důvěry jsou zahozeny."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "Server HA-MCP",
|
||||
"description": "Nakonfigurujte server HA-MCP. {panel_hint}Změny zde se použijí po uložení.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Kanál vydání",
|
||||
"auto_update": "Automatické aktualizace serveru",
|
||||
"server_port": "Naslouchací port serveru MCP",
|
||||
"bind_host": "Síťový přístup",
|
||||
"webhook_auth": "Režim ověřování",
|
||||
"oauth_client_id_override": "Legacy OAuth: vlastní ID klienta (volitelné)",
|
||||
"oauth_client_secret_override": "Legacy OAuth: vlastní tajný klíč klienta (volitelné)",
|
||||
"oauth_regenerate": "Legacy OAuth: vygenerovat ID/tajný klíč klienta nyní",
|
||||
"pip_spec": "Vývojář: přepsání balíčku ha-mcp",
|
||||
"server_url": "URL Home Assistanta (pokročilé)",
|
||||
"external_url": "Externí URL (volitelné)",
|
||||
"webhook_id_override": "Vlastní tajný klíč webhooku (volitelné)",
|
||||
"secret_path_override": "Vlastní cesta pro přímý přístup (volitelné)",
|
||||
"regenerate_secrets": "Vygenerovat tajné klíče připojení nyní",
|
||||
"enable_webhook": "Vzdálený přístup přes webhook",
|
||||
"enable_llm_api": "API LLM konverzačního agenta",
|
||||
"llm_api_exposure": "Zpřístupnění nástrojů konverzačního agenta",
|
||||
"enable_startup_notification": "Oznámení o spuštění",
|
||||
"enable_sidebar_panel": "Panel nastavení postranního panelu"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "Stabilní instaluje nejnovější stabilní vydání; Vývoj instaluje nejnovější vývojovou verzi. Když jsou zapnuty automatické aktualizace, opětovné načtení nebo restart, plus pravidelná kontrola, nainstalují nejnovější sestavení vybraného kanálu. Přepsání balíčku vývojáře níže má přednost a zakazuje automatické aktualizace.",
|
||||
"auto_update": "Když je zapnuto, nejnovější vydání vybraného kanálu se nainstaluje automaticky – při opětovném načtení nebo restartu a prostřednictvím pravidelné kontroly. Když je vypnuto, server zůstane na aktuálně nainstalované verzi, dokud to znovu nezapnete. Toto ovládá pouze balíček serveru ha-mcp; aktualizace samotné vlastní komponenty HA-MCP stále přicházejí přes HACS.",
|
||||
"server_port": "Port, na kterém tento server naslouchá. Aplikace (doplněk) ha-mcp používá port 9583, takže ve výchozím nastavení je nastaveno 9584, aby mohly oba běžet vedle sebe – pokud aplikaci (doplněk) nepoužíváte, funguje jakýkoliv volný port.",
|
||||
"bind_host": "Kdo se může připojit přímo k portu MCP serveru. Výchozí nastavení odpovídá aplikaci (doplněku): dosažitelné ve vaší lokální síti, přičemž přihlašovacím údajem je tajná cesta. Zvolte loopback, chcete-li povolit připojení pouze ze samotného stroje Home Assistant – adresa URL webhooku a panel postranního panelu fungují v obou případech.",
|
||||
"webhook_auth": "Jak se klienti MCP ověřují na URL webhooku. S tajnou URL je samotný odkaz jediným pověřením – OAuth stále běží pro klienty, kteří jej používají, ale každé přihlášení je schváleno automaticky: není potřeba žádné přihlášení ani Client ID nebo Secret. S přihlášením Home Assistant se klienti jako claude.ai přihlašují pomocí administrátorského účtu Home Assistant (OAuth). S legacy OAuth tato integrace spouští vlastní přihlašovací službu a vydává Client ID a Secret k vložení do klientů, kteří je vyžadují – k úplnému zapnutí nebo vypnutí může být potřeba restart Home Assistanta.",
|
||||
"oauth_client_id_override": "Nahrazuje automaticky generované legacy OAuth ID klienta. Ponechte prázdné, abyste zachovali stávající. Používá se pouze, když je režim ověřování nastaven na legacy OAuth.",
|
||||
"oauth_client_secret_override": "Nahrazuje automaticky generovaný legacy OAuth tajný klíč klienta. Ponechte prázdné, abyste zachovali stávající. Používá se pouze, když je režim ověřování nastaven na legacy OAuth.",
|
||||
"oauth_regenerate": "Jednorázová akce: vytvoří nové ID klienta a tajný klíč pro režim legacy OAuth. Projeví se až po restartu Home Assistanta, o který požádá výzva k opravě – dokud nerestartujete, předchozí ID klienta a tajný klíč fungují a nové ne. Také vymaže dvě pole pro přepsání výše.",
|
||||
"pip_spec": "Ponechte prázdné. Pouze pro testování konkrétní sestavy ha-mcp (například předběžné vydání); přepíše kanál vydání a zakáže automatické aktualizace, dokud nebude vymazáno.",
|
||||
"server_url": "Adresa URL, kterou server běžící ve stejném procesu používá k připojení k vašemu Home Assistantovi (obvykle k této instanci samotné). Ponechte prázdné, aby se odvodila z portu a nastavení SSL této instance; hodnotu nastavte pouze tehdy, když server potřebuje jinou cestu.",
|
||||
"external_url": "Zobrazeno jako primární URL pro připojení – použijte toto, když Home Assistant běží za vaší vlastní doménou nebo reverzním proxy. Zadejte celou základní adresu včetně schématu. Musí směřovat přímo na Home Assistanta – otevření v prohlížeči by mělo vést na vaši přihlašovací stránku HA – a nesmí obsahovat port, jako je :8123 (nebo jakýkoli jiný port), jinak jej vzdálení klienti MCP nebudou moci dosáhnout. Ponechte prázdné pro automatické použití Nabu Casa / místní adresy.",
|
||||
"webhook_id_override": "Nahrazuje náhodný tajný klíč webhooku v URL pro připojení (/api/webhook/...). URL je pověření – použijte dlouhou, těžko uhodnutelnou hodnotu. Ponechte prázdné, abyste zachovali stávající.",
|
||||
"secret_path_override": "Nahrazuje náhodnou cestu použitou pro přímý přístup na portu serveru. Stejné pravidlo: cesta je pověření. Ponechte prázdné, abyste zachovali stávající.",
|
||||
"regenerate_secrets": "Jednorázová akce: vytvoří nové náhodné tajemství webhooku a cestu pro přímý přístup, okamžitě zneplatní staré připojovací URL. Také vymaže dvě výše uvedená pole pro přepsání.",
|
||||
"enable_webhook": "Vypněte pro režim pouze lokální: webhook Home Assistanta není vůbec registrován, takže nic – včetně Nabu Casa – nemůže dosáhnout na server přes Home Assistant. Přímý port serveru a boční panel zůstanou funkční.",
|
||||
"enable_llm_api": "Nabídněte kompletní sadu nástrojů konverzačním agentům Home Assistanta (OpenAI, Google, Ollama, ...): pokud je povoleno, agenti mohou vybrat „HA-MCP Server“ pod „Control Home Assistant“ a ovládat nástroje z chatu a hlasu Assist. Povolení pouze zpřístupní výběr – nic není vystaveno, dokud to nevyberete u agenta. Průvodce použitím: {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Tvar sady nástrojů nabízených konverzačním agentům. Vyhledávání nástrojů (výchozí) udržuje kontext agenta malý: kompaktní API s připnutými nástroji plus meta-nástroje pro vyhledávání/spouštění. Úplný katalog uvádí každý vystavený nástroj přímo – lepší pro modely s velkým kontextem. Obě možnosti registrují obě vedle sebe, takže si každý agent vybere svou vlastní pod „Control Home Assistant“. Vystavení jednotlivých nástrojů se spravuje v panelu nastavení HA-MCP; podrobnosti: {llm_api_docs_url}",
|
||||
"enable_startup_notification": "Zobrazit oznámení při každém spuštění serveru, odkazující na nastavení pouze pro administrátory. Vypněte pro tiché spuštění – připojovací URL se stále zobrazují v protokolu Home Assistanta.",
|
||||
"enable_sidebar_panel": "Zobrazit panel nastavení HA-MCP v postranním panelu (pouze pro administrátory). Vypněte pro odstranění položky z postranního panelu – možnosti serveru zůstanou dostupné na této obrazovce."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "Server HA-MCP běžící ve stejném procesu se nepodařilo spustit",
|
||||
"description": "Server HA-MCP běžící ve stejném procesu se nepodařilo spustit uvnitř Home Assistanta:\n\n{detail}\n\nZkontrolujte protokoly Home Assistanta a poté znovu načtěte integraci (nebo opravte základní problém a znovu načtěte) pro opakování."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "Balíček serveru HA-MCP běžícího ve stejném procesu se nepodařilo nainstalovat",
|
||||
"description": "Instalace balíčku ha-mcp pro server běžící ve stejném procesu selhala:\n\n{detail}\n\nVyřešte výše popsaný problém s kompatibilitou nebo instalací a poté znovu načtěte integraci pro opakování."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "Aktualizujte vlastní komponentu HA-MCP přes HACS",
|
||||
"description": "Nainstalovaný server ha-mcp vyžaduje vlastní komponentu HA-MCP {required} nebo novější, ale máte {installed}. Aktualizujte komponentu přes HACS (otevřete položku „HA-MCP Custom Component“ a použijte „Update information“, pokud se ještě nezobrazuje žádná aktualizace) a restartujte Home Assistanta. Server mezitím zůstane spuštěný, ale některé novější funkce nemusí fungovat, dokud nebude komponenta aktualizována."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "Aktualizace serveru HA-MCP čeká na aktualizaci komponenty",
|
||||
"description": "Server ha-mcp {latest} je k dispozici, ale tato verze také aktualizovala vlastní komponentu HA-MCP (na {shipped}; vy používáte {running}). Aby se zabránilo spuštění verze serveru, se kterou spuštěná komponenta nikdy nebyla testována, je automatická aktualizace serveru pozastavena, dokud nebude komponenta aktualizována.\n\nAktualizujte komponentu přes HACS (otevřete položku „HA-MCP Custom Component“ a použijte „Update information“, pokud se ještě nezobrazuje žádná aktualizace), poté restartujte Home Assistanta – aktualizace serveru se poté nainstaluje automaticky. Chcete-li aktualizaci serveru nainstalovat i tak, stiskněte „Install“ na entitě aktualizace serveru HA-MCP."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Komponenta nainstalovaná z původního repozitáře",
|
||||
"description": "HACS sleduje hlavní repozitář serveru ha-mcp pro tuto komponentu, takže HACS zde zobrazuje čísla verzí a poznámky k vydání serveru namísto vlastních (2.x) komponenty. Aktualizace stále fungují, ale zůstávají takto chybně označeny. Pro opravu: odeberte tento repozitář z HACS (nastavení vaší integrace a konfigurační záznamy zůstanou zachovány), přidejte homeassistant-ai/ha-mcp-integration jako vlastní repozitář, přeinstalujte z něj komponentu a restartujte Home Assistanta."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Restartujte Home Assistanta pro použití nastavení legacy OAuth",
|
||||
"fix_flow": {
|
||||
"step": {
|
||||
"confirm": {
|
||||
"title": "Restartovat Home Assistanta?",
|
||||
"description": "Odesláním tohoto formuláře se restartuje Home Assistant a použijí se nastavení legacy OAuth.\n\nKlikněte na **Odeslat** pro restartování nyní."
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Stabilní (doporučeno)",
|
||||
"dev": "Vývojová (nejnovější sestavení)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "Tajná URL webhooku (výchozí)",
|
||||
"ha_auth": "Přihlásit se pomocí Home Assistanta (OAuth)",
|
||||
"legacy": "Legacy OAuth (tato integrace vydává Client ID/Secret k vložení)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "Vyhledávání nástrojů (kompaktní, výchozí)",
|
||||
"full": "Úplný katalog",
|
||||
"both": "Obě (vyberte pro každého agenta)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "Aktualizovat"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Přímý přístup ze stroje Home Assistanta: {url}",
|
||||
"connect_local_lan": "Lokální/LAN (když je „Network access“ „Local network“): {url}",
|
||||
"connect_remote_url": "Vzdálená připojovací URL: {url}",
|
||||
"connect_urls_label": "Připojovací URL:",
|
||||
"connect_urls_pending": "Připojovací URL se zde (a v protokolu Home Assistanta) objeví, jakmile se server spustí.",
|
||||
"connect_webhook_disabled": "Vzdálený přístup přes webhook je zakázán (režim pouze lokální).",
|
||||
"oauth_creds_pending": "ID klienta a tajný klíč klienta se zde objeví, jakmile se server spustí.",
|
||||
"oauth_not_serving": "Legacy OAuth je zatím neposkytuje — restartujte Home Assistanta, až vás o to požádá, abyste je aktivovali.",
|
||||
"oauth_select_legacy_mode": "Nastavte režim ověřování na „legacy OAuth“ výše a uložte pro vygenerování ID klienta a tajného klíče klienta.",
|
||||
"panel_hint": "Otevřete [panel nastavení HA-MCP](/ha-mcp) pro správu nástrojů a nastavení serveru.",
|
||||
"tools_module_installed": "Modul beta/pokročilých nástrojů pro soubory a YAML (volitelné): Nainstalováno",
|
||||
"tools_module_not_installed": "Modul beta/pokročilých nástrojů pro soubory a YAML (volitelné): Není nainstalováno – stiskněte „Add entry“ na stránce této integrace a vyberte „HA-MCP File & YAML Tools“ pro jeho přidání",
|
||||
"tools_module_not_loaded": "Modul beta/pokročilých nástrojů pro soubory a YAML (volitelné): Nainstalováno, ale nenačteno – povolte nebo znovu načtěte položku „HA-MCP File & YAML Tools“ na stránce této integrace",
|
||||
"version_line": "Komponenta {component_version} – Server ha-mcp {server_version} (kanál {channel})",
|
||||
"version_not_installed": "zatím nenainstalováno",
|
||||
"version_unknown": "neznámá"
|
||||
}
|
||||
}
|
||||
@@ -1,161 +1,168 @@
|
||||
{
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "HA-MCP Custom Component",
|
||||
"description": "Wähle aus, was du hinzufügen möchtest. **HA-MCP Server** führt den vollständigen ha-mcp-Server in Home Assistant aus und stellt ihn über einen Home Assistant Webhook bereit – das ist die Installation, die die meisten Nutzer brauchen. Er ist ein eigenständiger Server und ein vollständiger Ersatz für alle anderen Installationsmethoden (Add-on, Docker, uvx/PyPI, stdio); wenn du ihn nutzt, solltest du keine dieser anderen Methoden gleichzeitig verwenden. **HA-MCP File & YAML Tools** fügt die privilegierten Datei- und YAML-Bearbeitungsdienste hinzu, die nur benötigt werden, wenn du die opt-in Datei/YAML-Tools von ha-mcp aktivierst. Wenn dein ha-mcp-Server bereits woanders läuft (Add-on, Docker, uvx), benötigst du den Server-Eintrag nicht – füge nur diesen File & YAML-Eintrag hinzu, und auch nur, wenn du diese Tools verwendest. Er funktioniert mit jedem Server-Typ 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. Nur erforderlich, wenn du die opt-in Datei/YAML-Bearbeitungstools von ha-mcp aktivierst (Feature-Flags, standardmäßig deaktiviert) – dies gilt für jeden Server-Typ, einschließlich des In-Process HA-MCP Servers. Du kannst diesen Eintrag jederzeit hinzufügen oder entfernen."
|
||||
},
|
||||
"server": {
|
||||
"title": "HA-MCP Server",
|
||||
"description": "Dies führt den vollständigen ha-mcp-Server in Home Assistant aus und stellt ihn remote über einen Home Assistant Webhook bereit (erreichbar über Nabu Casa oder jeden Reverse Proxy). Er ist ein eigenständiger Server und ein vollständiger Ersatz für die Add-on-, Docker-, uvx/PyPI- und stdio-Installationsmethoden – führe ihn nicht neben einem anderen ha-mcp-Server aus. Wähle **Absenden**, um ihn zu starten; du kannst Port, Binding und Authentifizierung danach in den Integrationsoptionen ändern."
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "Dieser Eintrag ist bereits eingerichtet.",
|
||||
"unsupported_home_assistant": "Der In-Process HA-MCP Server benötigt Home Assistant {required} oder neuer, aber diese Instanz läuft mit {installed}. Du kannst weiterhin den HA-MCP File & YAML Tools-Eintrag dieses Components mit einem externen ha-mcp-Server verwenden, der als Add-on oder Docker-Container läuft."
|
||||
"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."
|
||||
}
|
||||
},
|
||||
"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 Datei-Verzeichnisse",
|
||||
"extra_yaml_keys": "Zusätzliche YAML-Schreib-Keys"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Verzeichnisse relativ zum Konfigurationsverzeichnis, jeweils mit Lese- und Schreibzugriff (z. B. pyscript). Traversal- und Einträge außerhalb des Konfig-Verzeichnisses 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. Das ha-mcp Add-on nutzt 9583, daher ist hier standardmäßig 9584 eingestellt, damit beide parallel laufen können – wenn du das Add-on nicht nutzt, funktioniert jeder freie Port.",
|
||||
"bind_host": "Wer sich direkt mit dem MCP-Server-Port verbinden kann. Der Standard entspricht dem Add-on: erreichbar in deinem lokalen Netzwerk, mit dem Secret-Pfad als Credential. Wähle Loopback, um nur Verbindungen von der Home Assistant Maschine selbst zuzulassen – die Webhook-URL und das Sidebar-Panel funktionieren in beiden Fällen.",
|
||||
"webhook_auth": "Wie sich MCP-Clients an der Webhook-URL authentifizieren. Mit der Secret-URL ist der Link selbst das Credential. Mit Home Assistant Sign-in melden sich Clients wie claude.ai mit einem Home Assistant Administrator-Konto an (OAuth). Mit Legacy OAuth stellt diese Integration eigene Client ID und Secret aus, die in Clients eingefügt werden, die eines benötigen, wie Google Gemini Spark – ein Home Assistant Restart ist zum Ein- oder Ausschalten erforderlich.",
|
||||
"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-ha-mcp-Server-Repository für dieses Component, daher zeigt HACS hier die Versionsnummern des Servers (7.x) und die Release-Notes des Servers statt der eigenen des Components (1.x). Updates funktionieren weiter, bleiben aber so falsch beschriftet. Um zu beheben: Entferne dieses Repository aus HACS (deine Integrationseinstellungen und Config-Einträge bleiben erhalten), füge homeassistant-ai/ha-mcp-integration als Custom Repository hinzu, installiere das Component daraus neu und starte Home Assistant neu."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Starte Home Assistant neu, um die Legacy OAuth-Änderung anzuwenden",
|
||||
"description": "Der Legacy OAuth-Authentifizierungsmodus registriert eigene /authorize- und /token-Web-Endpunkte, die Home Assistant nur bei einem vollständigen Restart binden oder freigeben kann – egal ob du diesen Modus gerade ein- oder ausgeschaltet oder Client ID/Secret geändert hast. Starte Home Assistant neu (Einstellungen - System - Neustart), um die Änderung anzuwenden; bis dahin bleibt das vorherige Verhalten aktiv."
|
||||
}
|
||||
},
|
||||
"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 (Client ID/Secret, für Google Gemini Spark)"
|
||||
}
|
||||
},
|
||||
"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"
|
||||
"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 Datei-Verzeichnisse",
|
||||
"extra_yaml_keys": "Zusätzliche YAML-Schreib-Keys"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Verzeichnisse relativ zum Konfigurationsverzeichnis, jeweils mit Lese- und Schreibzugriff (z. B. pyscript). Traversal- und Einträge außerhalb des Konfig-Verzeichnisses 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"
|
||||
}
|
||||
}
|
||||
@@ -3,7 +3,7 @@
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "HA-MCP Custom Component",
|
||||
"description": "Choose what to add. **HA-MCP Server** runs the full ha-mcp server inside Home Assistant and exposes it through a Home Assistant webhook - this is the install most people want. It is a standalone server and a complete replacement for every other install method (add-on, Docker, uvx/PyPI, stdio); if you run it, do not also run one of those. **HA-MCP File & YAML Tools** adds the privileged file and YAML editing services, needed only if you turn on ha-mcp's opt-in file/YAML tools. If your ha-mcp server already runs elsewhere (add-on, Docker, uvx), you do not need the server entry - add only this File & YAML entry, and only if you use those tools. It works with every server type and can be added later at any time.",
|
||||
"description": "Choose what to add. **HA-MCP Server** runs the full ha-mcp server inside Home Assistant and exposes it through a Home Assistant webhook - this is the install most people want. It is a standalone server and a complete replacement for every other install method: App (add-on), Docker, uvx/PyPI, stdio; if you run it, do not also run one of those. **HA-MCP File & YAML Tools** has two roles. If your ha-mcp server runs outside Home Assistant - app, Docker, uvx/PyPI, stdio - this entry also gives that server the in-process component capabilities it cannot reach from outside (fast in-process search, config entry metadata, registry-backed reads), so it is worth adding to every external install, and it gates the privileged file and YAML editing services used by ha-mcp's opt-in file/YAML tools. If you add the HA-MCP Server entry instead, that entry already provides those shared capabilities, so this second entry is then needed only as the gate for the opt-in file/YAML tools. It works with every server type and can be added later at any time.",
|
||||
"menu_options": {
|
||||
"server": "HA-MCP Server (recommended)",
|
||||
"tools": "HA-MCP File & YAML Tools (optional)"
|
||||
@@ -11,16 +11,16 @@
|
||||
},
|
||||
"tools": {
|
||||
"title": "HA-MCP File & YAML Tools",
|
||||
"description": "Sets up the privileged file and YAML configuration services. Only needed if you enable ha-mcp's opt-in file/YAML editing tools (feature flags, off by default) - this applies to every server type, including the in-process HA-MCP Server. You can add or remove this entry at any time."
|
||||
"description": "Sets up the privileged file and YAML configuration services, which stay gated behind ha-mcp's opt-in file/YAML editing tools (feature flags, off by default) - this applies to every server type, including the in-process HA-MCP Server. If your ha-mcp server runs outside Home Assistant, this entry also gives it the in-process component capabilities it cannot reach from outside (fast in-process search, config entry metadata, registry-backed reads), which are worth having even with the file/YAML tools off. You can add or remove this entry at any time."
|
||||
},
|
||||
"server": {
|
||||
"title": "HA-MCP Server",
|
||||
"description": "This runs the full ha-mcp server inside Home Assistant and exposes it remotely through a Home Assistant webhook (reachable via Nabu Casa or any reverse proxy). It is a standalone server and a complete replacement for the add-on, Docker, uvx/PyPI, and stdio install methods - do not run it alongside another ha-mcp server. Select **Submit** to start it; you can change the port, binding, and authentication afterward in the integration options."
|
||||
"description": "This runs the full ha-mcp server inside Home Assistant and exposes it remotely through a Home Assistant webhook (reachable via Nabu Casa or any reverse proxy). It is a standalone server and a complete replacement for the app (add-on), Docker, uvx/PyPI, and stdio install methods - do not run it alongside another ha-mcp server. Select **Submit** to start it; you can change the port, binding, and authentication afterward in the integration options."
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "This entry is already set up.",
|
||||
"unsupported_home_assistant": "The in-process HA-MCP Server requires Home Assistant {required} or newer, but this instance is running {installed}. You can still use this component's HA-MCP File & YAML Tools entry with an external ha-mcp server running as an add-on or Docker container."
|
||||
"unsupported_home_assistant": "The in-process HA-MCP Server requires Home Assistant {required} or newer, but this instance is running {installed}. You can still use this component's HA-MCP File & YAML Tools entry with an external ha-mcp server running as an app (add-on) or Docker container."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
@@ -29,11 +29,11 @@
|
||||
"title": "HA-MCP File & YAML Tools",
|
||||
"description": "Configure the privileged file and YAML editing services used by ha-mcp's opt-in file/YAML tools. These settings also appear in the ha-mcp server's own settings UI and apply live, with no restart. A non-overridable deny floor still blocks sensitive paths (e.g. .storage) and trust-boundary keys (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Extra file directories",
|
||||
"allowed_dirs": "Extra file paths",
|
||||
"extra_yaml_keys": "Extra YAML write keys"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Directories relative to the config directory, each granted read and write (e.g. pyscript). Traversal and out-of-config entries are dropped.",
|
||||
"allowed_dirs": "Paths relative to the config directory, including exact filenames such as sensor.yaml, or paths under /share, /media, /ssl, and /backup. Each entry is granted read and write for that path and anything below it; enter every path as a separate list item. Traversal and other disallowed paths are dropped.",
|
||||
"extra_yaml_keys": "Top-level keys ha_config_set_yaml may write in addition to the built-in ones, for YAML-first integrations on this install (e.g. alert2). Trust-boundary keys are dropped."
|
||||
}
|
||||
},
|
||||
@@ -64,9 +64,9 @@
|
||||
"data_description": {
|
||||
"channel": "Stable installs the latest stable release; Development installs the newest development build. When automatic updates are on, a reload or restart, plus a periodic check, install the newest build of the selected channel. A developer package override below takes precedence and disables automatic updates.",
|
||||
"auto_update": "When on, the newest release of the selected channel is installed automatically - on a reload or restart, and via a periodic check. When off, the server stays on the version currently installed until you turn this back on. This controls the ha-mcp server package only; updates to the HA-MCP Custom Component itself still come through HACS.",
|
||||
"server_port": "The port this server listens on. The ha-mcp add-on uses 9583, so this defaults to 9584 to let both run side by side - if you don't run the add-on, any free port works.",
|
||||
"bind_host": "Who can connect to the MCP server port directly. The default matches the add-on: reachable on your local network, with the secret path as the credential. Choose loopback to allow only connections from the Home Assistant machine itself - the webhook URL and the sidebar panel work either way.",
|
||||
"webhook_auth": "How MCP clients prove themselves at the webhook URL. With the secret URL, the link itself is the credential. With Home Assistant sign-in, clients such as claude.ai log in with a Home Assistant administrator account (OAuth). With legacy OAuth, this integration issues its own Client ID and Secret to paste into clients that require one, such as Google Gemini Spark - it needs a Home Assistant restart to turn on or off.",
|
||||
"server_port": "The port this server listens on. The ha-mcp app (add-on) uses 9583, so this defaults to 9584 to let both run side by side - if you don't run the app (add-on), any free port works.",
|
||||
"bind_host": "Who can connect to the MCP server port directly. The default matches the app (add-on): reachable on your local network, with the secret path as the credential. Choose loopback to allow only connections from the Home Assistant machine itself - the webhook URL and the sidebar panel work either way.",
|
||||
"webhook_auth": "How MCP clients prove themselves at the webhook URL. With the secret URL, the link itself is the only credential - OAuth still runs for clients that use it, but every sign-in is approved automatically: no login and no Client ID or Secret needed. With Home Assistant sign-in, clients such as claude.ai log in with a Home Assistant administrator account (OAuth). With legacy OAuth, this integration runs its own sign-in service and issues a Client ID and Secret to paste into clients that require one - a Home Assistant restart may be needed to fully turn it on or off.",
|
||||
"oauth_client_id_override": "Replaces the auto-generated legacy OAuth Client ID. Leave empty to keep the current one. Only used while Authentication mode is set to legacy OAuth.",
|
||||
"oauth_client_secret_override": "Replaces the auto-generated legacy OAuth Client Secret. Leave empty to keep the current one. Only used while Authentication mode is set to legacy OAuth.",
|
||||
"oauth_regenerate": "One-time action: mints a fresh Client ID and Secret for legacy OAuth mode. It takes effect only after the Home Assistant restart the repair prompt asks for - until you restart, the previous Client ID and Secret keep working and the new ones do not. Also clears the two override fields above.",
|
||||
@@ -104,11 +104,18 @@
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Component installed from the legacy repository",
|
||||
"description": "HACS is tracking the main ha-mcp server repository for this component, so HACS shows the server's version numbers (7.x) and the server's release notes here instead of the component's own (1.x). Updates keep working, but stay mislabeled this way. To fix: remove this repository from HACS (your integration settings and config entries are kept), add homeassistant-ai/ha-mcp-integration as a custom repository, reinstall the component from it, and restart Home Assistant."
|
||||
"description": "HACS is tracking the main ha-mcp server repository for this component, so HACS shows the server's version numbers and release notes here instead of the component's own (2.x). Updates keep working, but stay mislabeled this way. To fix: remove this repository from HACS (your integration settings and config entries are kept), add homeassistant-ai/ha-mcp-integration as a custom repository, reinstall the component from it, and restart Home Assistant."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Restart Home Assistant to apply the legacy OAuth change",
|
||||
"description": "The legacy OAuth authentication mode registers its own /authorize and /token web endpoints, which Home Assistant can only bind or release when it fully restarts - whether you just turned this mode on, turned it off, or changed its Client ID/Secret. Restart Home Assistant (Settings - System - Restart) to apply the change; until then the previous behavior stays in effect."
|
||||
"title": "Restart Home Assistant to apply the legacy OAuth settings",
|
||||
"fix_flow": {
|
||||
"step": {
|
||||
"confirm": {
|
||||
"title": "Restart Home Assistant?",
|
||||
"description": "Submitting this form will restart Home Assistant and apply the legacy OAuth settings.\n\nClick **Submit** to restart now."
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
@@ -122,7 +129,7 @@
|
||||
"options": {
|
||||
"none": "Secret webhook URL (default)",
|
||||
"ha_auth": "Sign in with Home Assistant (OAuth)",
|
||||
"legacy": "Legacy OAuth (Client ID/Secret, for Google Gemini Spark)"
|
||||
"legacy": "Legacy OAuth (this integration issues a Client ID/Secret to paste)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
|
||||
@@ -0,0 +1,168 @@
|
||||
{
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "HA-MCP Propra Komponanto",
|
||||
"description": "Elektu kion aldoni. **HA-MCP Server** rulas la plenan ha-mcp-servilon ene de Home Assistant kaj elmetas ĝin per Home Assistant-retooko (webhook) — ĉi tio estas la instalo, kiun la plej multaj homoj deziras. Ĝi estas memstara servilo kaj kompleta anstataŭaĵo por ĉiu alia instala metodo: Apo (aldonaĵo), Docker, uvx/PyPI, stdio; se vi rulas ĝin, ne krome rulas iun el tiuj. **HA-MCP File & YAML Tools** havas du rolojn. Se via ha-mcp-servilo rulas ekster Home Assistant — apo, Docker, uvx/PyPI, stdio — ĉi tiu enigo ankaŭ donas al tiu servilo la enprocezajn komponentajn kapablojn, kiujn ĝi ne povas atingi de ekstere (rapida enproceza serĉo, metadatenoj de agorda enigo, legadoj subtenataj de registro), do indas aldoni ĝin al ĉiu ekstera instalo, kaj ĝi regas la privilegiitajn dosierajn kaj YAML-redaktajn servojn uzatajn de la laŭvolaj dosieraj/YAML-iloj de ha-mcp. Se vi aldonas la enigon de HA-MCP Server anstataŭe, tiu enigo jam provizas tiujn komunajn kapablojn, do ĉi tiu dua enigo tiam necesas nur kiel la pordego por la laŭvolaj dosieraj/YAML-iloj. Ĝi funkcias kun ĉiu servilspeco kaj povas esti aldonita poste iam ajn.",
|
||||
"menu_options": {
|
||||
"server": "HA-MCP Servilo (rekomendita)",
|
||||
"tools": "HA-MCP Dosieraj & YAML Iloj (laŭvola)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "HA-MCP Dosieraj & YAML Iloj",
|
||||
"description": "Agordas la privilegiitajn dosierajn kaj YAML-agordajn servojn, kiuj restas regataj malantaŭ la laŭvolaj dosieraj/YAML-redaktaj iloj de ha-mcp (funkciaj flagoj, defaŭlte malŝaltitaj) — ĉi tio aplikiĝas al ĉiu servilspeco, inkluzive de la enproceza HA-MCP Server. Se via ha-mcp-servilo rulas ekster Home Assistant, ĉi tiu enigo ankaŭ donas al ĝi la enprocezajn komponentajn kapablojn, kiujn ĝi ne povas atingi de ekstere (rapida enproceza serĉo, metadatenoj de agorda enigo, legadoj subtenataj de registro), kiuj indas havi eĉ kiam la dosieraj/YAML-iloj estas malŝaltitaj. Vi povas aldoni aŭ forigi ĉi tiun enigon iam ajn."
|
||||
},
|
||||
"server": {
|
||||
"title": "HA-MCP Servilo",
|
||||
"description": "Ĉi tio rulas la plenan ha-mcp servilon ene de Home Assistant kaj elmetas ĝin malproksime per Home Assistant rethoko (webhook) (atingebla per Nabu Casa aŭ iu ajn inversa prokurilo). Ĝi estas memstara servilo kaj kompleta anstataŭaĵo por la apo (aldonaĵo), Docker, uvx/PyPI, kaj stdio instalaj metodoj — ne rulu ĝin kune kun alia ha-mcp servilo. Elektu **Submit** por starti ĝin; vi povas ŝalti la pordon, ligadon, kaj aŭtentigon poste en la integriĝaj opcioj."
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "Ĉi tiu eniro jam estas agordita.",
|
||||
"unsupported_home_assistant": "La enproceza HA-MCP Server postulas Home Assistant {required} aŭ pli novan, sed ĉi tiu instanco rulas {installed}. Vi ankoraŭ povas uzi la eniron HA-MCP File & YAML Tools de ĉi tiu kompenento kun ekstera ha-mcp servilo rulanta kiel apo (aldonaĵo) aŭ Docker-ujo."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "HA-MCP Dosieraj & YAML Iloj",
|
||||
"description": "Agordu la privilegiajn dosierajn kaj YAML-redaktajn servojn uzatajn de la laŭvolaj dosieraj/YAML-iloj de ha-mcp. Ĉi tiuj agordoj ankaŭ aperas en la propra agorda UI de la ha-mcp servilo kaj aplikiĝas tuj, sen rekomenco. Ne-superregebla malpermesa limo ankoraŭ blokas sentemajn vojojn (ekz. .storage) kaj fid-limajn ŝlosilojn (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Ekstraj dosierujoj",
|
||||
"extra_yaml_keys": "Ekstraj YAML-skribaj ŝlosiloj"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Dosierujoj rilataj al la agorda dosierujo, ĉiu kun legado kaj skribado permesita (ekz. pyscript). Trairo kaj ekster-agordaj eniroj estas forĵetitaj.",
|
||||
"extra_yaml_keys": "Ĉefnivelaj ŝlosiloj, kiujn ha_config_set_yaml povas skribi krom la enkonstruitaj, por YAML-unuaj integriĝoj en ĉi tiu instalaĵo (ekz. alert2). Fid-limaj ŝlosiloj estas forĵetitaj."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "HA-MCP Servilo",
|
||||
"description": "Agordu la HA-MCP servilon. {panel_hint}Ŝanĝoj ĉi tie aplikiĝas post konservado.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Eldona kanalo",
|
||||
"auto_update": "Aŭtomataj servilaj ĝisdatigoj",
|
||||
"server_port": "Aŭskulta pordo de MCP servilo",
|
||||
"bind_host": "Reta aliro",
|
||||
"webhook_auth": "Aŭtentiga reĝimo",
|
||||
"oauth_client_id_override": "Hereda OAuth: propra Klienta ID (laŭvola)",
|
||||
"oauth_client_secret_override": "Hereda OAuth: propra Klienta Sekreto (laŭvola)",
|
||||
"oauth_regenerate": "Hereda OAuth: regeneru Klientan ID/Sekreton nun",
|
||||
"pip_spec": "Programisto: ha-mcp pakaĵa superrego",
|
||||
"server_url": "Home Assistant URL (altnivela)",
|
||||
"external_url": "Ekstera URL (laŭvola)",
|
||||
"webhook_id_override": "Propra retkroĉa sekreto (laŭvola)",
|
||||
"secret_path_override": "Propra rekta-alira vojo (laŭvola)",
|
||||
"regenerate_secrets": "Regeneru konektajn sekretojn nun",
|
||||
"enable_webhook": "Malproksima aliro per retkroĉo",
|
||||
"enable_llm_api": "Konversacia-agenta LLM API",
|
||||
"llm_api_exposure": "Konversacia-agenta ilo-ekspono",
|
||||
"enable_startup_notification": "Komenca sciigo",
|
||||
"enable_sidebar_panel": "Flankbreta agorda panelo"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "Stabila instalas la plej novan stabilan eldonon; Disvolva instalas la plej novan disvolvan konstruaĵon. Kiam aŭtomataj ĝisdatigoj estas ŝaltitaj, reŝargo aŭ rekomenco, plus perioda kontrolo, instalas la plej novan konstruaĵon de la elektita kanalo. Programista pakaĵa superrego sube havas prioritaton kaj malŝaltas aŭtomatajn ĝisdatigojn.",
|
||||
"auto_update": "Kiam ŝaltita, la plej nova eldono de la elektita kanalo estas instalita aŭtomate — dum reŝargo aŭ rekomenco, kaj per perioda kontrolo. Kiam malŝaltita, la servilo restas ĉe la nuntempe instalita versio ĝis vi reŝaltas ĉi tion. Ĉi tio regas nur la ha-mcp servilan pakaĵon; ĝisdatigoj al la HA-MCP Propra Komponanto mem ankoraŭ venas per HACS.",
|
||||
"server_port": "La pordo, kiun ĉi tiu servilo aŭskultas. La ha-mcp apo (aldonaĵo) uzas 9583, do ĉi tio defaŭltas al 9584 por lasi ambaŭ ruli flank-al-flanke — se vi ne rulas la apon (aldonaĵon), iu ajn libera pordo funkcias.",
|
||||
"bind_host": "Kiu povas konekti al la MCP-servila pordo rekte. La defaŭlto kongruas kun la apo (aldonaĵo): atingebla en via loka retumo, kun la sekreta vojo kiel la akreditaĵo. Elektu enbuklon (loopback) por permesi nur konektojn de la Home Assistant-maŝino mem — la rethoka URL kaj la flanka panelo funkcias ambaŭkaze.",
|
||||
"webhook_auth": "Kiel MCP-klientoj pruvas sin ĉe la retkroĉa URL. Kun la sekreta URL, la ligilo mem estas la sola akreditaĵo — OAuth ankoraŭ funkcias por klientoj, kiuj uzas ĝin, sed ĉiu ensaluto estas aŭtomate aprobita: neniu ensaluto kaj neniu Klienta ID aŭ Sekreto necesas. Kun Home Assistant-ensaluto, klientoj kiel claude.ai ensalutas per Home Assistant-administranta konto (OAuth). Kun hereda OAuth, ĉi tiu integriĝo funkciigas sian propran ensalutan servon kaj eldonas Klientan ID-on kaj Sekreton por alglui en klientojn, kiuj postulas tian — rekomenco de Home Assistant eble necesos por plene ŝalti aŭ malŝalti ĝin.",
|
||||
"oauth_client_id_override": "Anstataŭigas la aŭtomate generitan heredan OAuth Klientan ID. Lasu malplena por konservi la nunan. Nur uzata kiam Aŭtentiga reĝimo estas agordita al hereda OAuth.",
|
||||
"oauth_client_secret_override": "Anstataŭigas la aŭtomate generitan heredan OAuth Klientan Sekreton. Lasu malplena por konservi la nunan. Nur uzata kiam Aŭtentiga reĝimo estas agordita al hereda OAuth.",
|
||||
"oauth_regenerate": "Unufoja ago: kreas novan Klientan ID kaj Sekreton por hereda OAuth-reĝimo. Ĝi ekvalidas nur post la rekomenco de Home Assistant, kiun la ripara peto petas — ĝis vi rekomencos, la antaŭaj Klienta ID kaj Sekreto daŭre funkcias kaj la novaj ne. Ankaŭ malplenigas la du superregajn kampojn supre.",
|
||||
"pip_spec": "Lasu malplena. Nur por testi specifan ha-mcp konstruaĵon (ekzemple antaŭ-eldona fiksado); superregas la eldonan kanalon kaj malŝaltas aŭtomatajn ĝisdatigojn ĝis malplenigite.",
|
||||
"server_url": "La URL, kiun la servilo funkcianta en la sama procezo uzas por atingi vian Home Assistant (kutime ĉi tiu instanco mem). Lasu ĝin malplena por derivi la valoron el la pordo kaj la SSL-agordoj de ĉi tiu instanco; agordu valoron nur kiam la servilo bezonas alian vojon.",
|
||||
"external_url": "Montrata kiel la ĉefa konekta URL — uzu ĉi tion kiam Home Assistant sidas malantaŭ via propra domajno aŭ inversa prokurilo. Enigu la plenan bazan adreson inkluzive de la skemo. Ĝi devas montri rekte al Home Assistant — malfermante ĝin en retumilo devus atingi vian HA ensalutan paĝon — kaj ne devas enhavi pordon kiel :8123 (aŭ iu ajn alia pordo), alie malproksimaj MCP klientoj ne povos atingi ĝin. Lasu malplena por uzi Nabu Casa / la lokan adreson aŭtomate.",
|
||||
"webhook_id_override": "Anstataŭigas la hazardan retkroĉan sekreton en la konekta URL (/api/webhook/...). La URL estas la akreditaĵo — uzu longan, malfacile diveneblan valoron. Lasu malplena por konservi la nunan.",
|
||||
"secret_path_override": "Anstataŭigas la hazardan vojon uzatan por rekta aliro ĉe la servila pordo. Sama regulo: la vojo estas la akreditaĵo. Lasu malplena por konservi la nunan.",
|
||||
"regenerate_secrets": "Unufoja ago: kreas novan hazardan retkroĉan sekreton kaj rektaliran vojon, tuj malvalidigante la malnovajn konektajn URL-ojn. Ankaŭ malplenigas la du superajn anstataŭigajn kampojn.",
|
||||
"enable_webhook": "Malŝaltu por nur-loka reĝimo: la retkroĉo de Home Assistant tute ne estas registrita, do nenio — inkluzive de Nabu Casa — povas atingi la servilon per Home Assistant. La rekta servila pordo kaj la flanka panelo daŭre funkcias.",
|
||||
"enable_llm_api": "Proponu la plenan ilaron al konversaciaj agentoj de Home Assistant (OpenAI, Google, Ollama, ...): dum ebligite, agentoj povas elekti 'HA-MCP Server' sub Kontroli Home Assistant kaj uzi la ilojn el Asista babilejo kaj voĉo. Ebligo nur igas ĝin elektebla — nenio estas elmontrita ĝis vi elektas ĝin ĉe agento. Gvidilo pri uzado: {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Formo de la ilaro proponita al konversaciaj agentoj. Ilo-serĉo (defaŭlta) tenas la kuntekston de la agento malgranda: kompakta API kun fiksitaj iloj plus serĉaj/ekzekutaj meta-iloj. Plena katalogo listigas ĉiun elmontritan ilon rekte — pli bone por grand-kuntekstaj modeloj. Ambaŭ registras la du flank-al-flanke, do ĉiu agento elektas sian propran sub Kontroli Home Assistant. Elmontro laŭ ilo estas administrata en la agorda panelo de HA-MCP; detaloj: {llm_api_docs_url}",
|
||||
"enable_startup_notification": "Montru sciigon ĉiufoje kiam la servilo startas, montrante al la nur-administraj agordaj surfacoj. Malŝaltu por starti silente — la konektaj URL-oj ankoraŭ aperas en la protokolo de Home Assistant.",
|
||||
"enable_sidebar_panel": "Montru la agordan panelon de HA-MCP en la flanka kolumno (nur por administrantoj). Malŝaltu por forigi la flankan eniron — servilaj opcioj restas disponeblaj sur ĉi tiu ekrano."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "La en-proceza servilo de HA-MCP ne sukcesis starti",
|
||||
"description": "La en-proceza servilo de HA-MCP ne povis esti startigita ene de Home Assistant:\n\n{detail}\n\nKontrolu la protokolojn de Home Assistant, poste reŝarĝu la integradon (aŭ riparu la suban problemon kaj reŝarĝu) por reprovi."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "La pakaĵo de la en-proceza servilo de HA-MCP ne povis esti instalita",
|
||||
"description": "Instalado de la pakaĵo ha-mcp por la en-proceza servilo malsukcesis:\n\n{detail}\n\nSolvu la kongruecan aŭ instalan problemon priskribitan supre, poste reŝarĝu la integradon por reprovi."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "Ĝisdatigu la Personan Komponanton de HA-MCP per HACS",
|
||||
"description": "La instalita servilo ha-mcp postulas Personan Komponanton de HA-MCP {required} aŭ pli novan, sed vi havas {installed}. Ĝisdatigu la komponanton per HACS (malfermu la eniron de la Persona Komponanto de HA-MCP kaj uzu 'Ĝisdatigi informojn' se neniu ĝisdatigo ankoraŭ montriĝas) kaj rekomencu Home Assistant. La servilo daŭre funkcias dume, sed iuj pli novaj funkcioj eble ne funkcios ĝis la komponanto estos ĝisdatigita."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "Ĝisdatigo de servilo HA-MCP atendas ĝisdatigon de komponanto",
|
||||
"description": "Servilo ha-mcp {latest} estas disponebla, sed tiu eldono ankaŭ ĝisdatigis la Personan Komponanton de HA-MCP (al {shipped}; vi uzas {running}). Por eviti startigi servilan version, kun kiu la nuna komponanto neniam estis testita, la aŭtomata servila ĝisdatigo estas prokrastita ĝis la komponanto estos ĝisdatigita.\n\nĜisdatigu la komponanton per HACS (malfermu la eniron de la Persona Komponanto de HA-MCP kaj uzu 'Ĝisdatigi informojn' se neniu ĝisdatigo ankoraŭ montriĝas), poste rekomencu Home Assistant — la servila ĝisdatigo instaliĝos aŭtomate poste. Por instali la servilan ĝisdatigon ĉiukaze, premu Instali ĉe la ĝisdatiga ento de la servilo HA-MCP."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Komponanto instalita el la hereda deponejo",
|
||||
"description": "HACS spuras la ĉefan deponejon de la ha-mcp-servilo por ĉi tiu komponanto, do HACS montras la versinumerojn kaj eldondetalojn de la servilo ĉi tie anstataŭ tiujn de la komponanto mem (2.x). Ĝisdatigoj daŭre funkcias, sed restas misetikeditaj tiel. Por ripari: forigu ĉi tiun deponejon el HACS (viaj integriĝaj agordoj kaj agordaj enskriboj estas konservitaj), aldonu homeassistant-ai/ha-mcp-integration kiel propran deponejon, reinstalu la komponanton el ĝi, kaj rekomencu Home Assistant."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Rekomencu Home Assistant por apliki la heredajn OAuth-agordojn",
|
||||
"fix_flow": {
|
||||
"step": {
|
||||
"confirm": {
|
||||
"title": "Rekomencu Home Assistant?",
|
||||
"description": "Sendi ĉi tiun formularon rekomencos Home Assistant kaj aplikos la heredajn OAuth-agordojn.\n\nAlklaku **Sendi** por rekomenci nun."
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Stabila (rekomendita)",
|
||||
"dev": "Disvolva (plej nova konstruo)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "Sekreta retkroĉa URL (defaŭlta)",
|
||||
"ha_auth": "Ensaluti per Home Assistant (OAuth)",
|
||||
"legacy": "Hereda OAuth (ĉi tiu integriĝo eldonas Klientan ID-on/Sekreton por alglui)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "Ilo-serĉo (kompakta, defaŭlta)",
|
||||
"full": "Plena katalogo",
|
||||
"both": "Ambaŭ (elektu laŭ agento)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "Ĝisdatigo"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Rekta aliro el la maŝino de Home Assistant: {url}",
|
||||
"connect_local_lan": "Loka/LAN (kiam Reto-aliro estas \"Local network\"): {url}",
|
||||
"connect_remote_url": "Fora konekta URL: {url}",
|
||||
"connect_urls_label": "Konektaj URL(j):",
|
||||
"connect_urls_pending": "La konektaj URL-oj aperos ĉi tie (kaj en la protokolo de Home Assistant) post kiam la servilo startos.",
|
||||
"connect_webhook_disabled": "Fora aliro per retkroĉo estas malŝaltita (nur-loka reĝimo).",
|
||||
"oauth_creds_pending": "La Klienta ID kaj Klienta Sekreto aperos ĉi tie post kiam la servilo startos.",
|
||||
"oauth_not_serving": "Legacy OAuth ankoraŭ ne liveras ilin — rekomencu Home Assistant, kiam ĝi petas vin pri tio, por aktivigi ilin.",
|
||||
"oauth_select_legacy_mode": "Agordu Aŭtentigan reĝimon al hereda OAuth supre kaj konservu por generi Klientan ID kaj Klientan Sekreton.",
|
||||
"panel_hint": "Malfermu la [agordan panelon de HA-MCP](/ha-mcp) por ilo-administrado kaj servilaj agordoj.",
|
||||
"tools_module_installed": "Beta/altnivela modulo de dosieraj & YAML-iloj (laŭvola): Instalita",
|
||||
"tools_module_not_installed": "Beta/altnivela modulo de dosieraj & YAML-iloj (laŭvola): Ne instalita — premu \"Aldoni eniron\" sur la paĝo de ĉi tiu integriĝo kaj elektu \"HA-MCP File & YAML Tools\" por aldoni ĝin",
|
||||
"tools_module_not_loaded": "Beta/altnivela modulo de dosieraj & YAML-iloj (laŭvola): Instalita sed ne ŝargita — ebligu aŭ reŝarĝu la eniron \"HA-MCP File & YAML Tools\" sur la paĝo de ĉi tiu integriĝo",
|
||||
"version_line": "Komponanto {component_version} - Servilo ha-mcp {server_version} ({channel} kanalo)",
|
||||
"version_not_installed": "ankoraŭ ne instalita",
|
||||
"version_unknown": "nekonata"
|
||||
}
|
||||
}
|
||||
@@ -1,161 +1,168 @@
|
||||
{
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "Componente personalizado HA-MCP",
|
||||
"description": "Elige qué quieres añadir. **Servidor HA-MCP** ejecuta el servidor ha-mcp completo dentro de Home Assistant y lo expone a través de un webhook de Home Assistant: es la instalación que quiere la mayoría de la gente. Es un servidor autónomo y un sustituto completo de cualquier otro método de instalación (complemento, Docker, uvx/PyPI, stdio); si lo usas, no uses además uno de esos. **Herramientas de archivos y YAML de HA-MCP** añade los servicios privilegiados de edición de archivos y YAML, necesarios solo si activas las herramientas opcionales de archivos/YAML de ha-mcp. Si tu servidor ha-mcp ya se ejecuta en otro sitio (complemento, Docker, uvx), no necesitas la entrada del servidor: añade solo esta entrada de archivos y YAML, y solo si usas esas herramientas. Funciona con cualquier tipo de servidor y se puede añadir más adelante en cualquier momento.",
|
||||
"menu_options": {
|
||||
"server": "Servidor HA-MCP (recomendado)",
|
||||
"tools": "Herramientas de archivos y YAML de HA-MCP (opcional)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "Herramientas de archivos y YAML de HA-MCP",
|
||||
"description": "Configura los servicios privilegiados de archivos y de configuración YAML. Solo hacen falta si activas las herramientas opcionales de edición de archivos/YAML de ha-mcp (indicadores de función, desactivados de forma predeterminada); esto vale para cualquier tipo de servidor, incluido el servidor HA-MCP integrado en el proceso. Puedes añadir o quitar esta entrada en cualquier momento."
|
||||
},
|
||||
"server": {
|
||||
"title": "Servidor HA-MCP",
|
||||
"description": "Esto ejecuta el servidor ha-mcp completo dentro de Home Assistant y lo expone de forma remota a través de un webhook de Home Assistant (accesible mediante Nabu Casa o cualquier proxy inverso). Es un servidor autónomo y un sustituto completo de los métodos de instalación por complemento, Docker, uvx/PyPI y stdio: no lo ejecutes junto a otro servidor ha-mcp. Pulsa **Enviar** para iniciarlo; después puedes cambiar el puerto, la vinculación y la autenticación en las opciones de la integración."
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "Esta entrada ya está configurada.",
|
||||
"unsupported_home_assistant": "El servidor HA-MCP integrado en el proceso requiere Home Assistant {required} o posterior, pero esta instancia ejecuta {installed}. Aun así puedes usar la entrada HA-MCP File & YAML Tools de este componente con un servidor ha-mcp externo que se ejecute como complemento o contenedor Docker."
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "Componente personalizado HA-MCP",
|
||||
"description": "Elige qué añadir. **HA-MCP Server** ejecuta el servidor completo de ha-mcp dentro de Home Assistant y lo expone a través de un webhook de Home Assistant; esta es la instalación que la mayoría de la gente prefiere. Es un servidor independiente y un reemplazo completo de cualquier otro método de instalación: aplicación (complemento), Docker, uvx/PyPI, stdio; si lo ejecutes, no ejecutes también uno de esos. **HA-MCP File & YAML Tools** tiene dos funciones. Si tu servidor ha-mcp se ejecuta fuera de Home Assistant (aplicación, Docker, uvx/PyPI, stdio), esta entrada también le otorga al servidor las capacidades de componentes internos a las que no puede acceder desde el exterior (búsqueda rápida interna, metadatos de entradas de configuración, lecturas respaldadas por el registro), por lo que vale la pena añadirla a cada instalación externa, y sirve como puerta de enlace para los servicios privilegiados de edición de archivos y YAML utilizados por las herramientas opcionales de archivos/YAML de ha-mcp. Si añades la entrada HA-MCP Server en su lugar, dicha entrada ya proporciona esas capacidades compartidas, por lo que esta segunda entrada solo será necesaria como puerta de enlace para las herramientas opcionales de archivos/YAML. Funciona con cualquier tipo de servidor y se puede añadir más tarde en cualquier momento.",
|
||||
"menu_options": {
|
||||
"server": "Servidor HA-MCP (recomendado)",
|
||||
"tools": "Herramientas de archivos y YAML de HA-MCP (opcional)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "Herramientas de archivos y YAML de HA-MCP",
|
||||
"description": "Configura los servicios privilegiados de configuración de archivos y YAML, que permanecen protegidos detrás de las herramientas opcionales de edición de archivos/YAML de ha-mcp (conmutadores de características, desactivados por defecto); esto se aplica a todos los tipos de servidor, incluido el HA-MCP Server interno. Si tu servidor ha-mcp se ejecuta fuera de Home Assistant, esta entrada también le otorga las capacidades de componentes internos a las que no puede acceder desde el exterior (búsqueda rápida interna, metadatos de entradas de configuración, lecturas respaldadas por el registro), las cuales vale la pena tener incluso con las herramientas de archivos/YAML desactivadas. Puedes añadir o eliminar esta entrada en cualquier momento."
|
||||
},
|
||||
"server": {
|
||||
"title": "Servidor HA-MCP",
|
||||
"description": "Esto ejecuta el servidor ha-mcp completo dentro de Home Assistant y lo expone de forma remota a través de un webhook de Home Assistant (accesible mediante Nabu Casa o cualquier proxy inverso). Es un servidor independiente y reemplaza por completo los métodos de instalación de aplicación (complemento), Docker, uvx/PyPI y stdio; no lo ejecutes junto con otro servidor ha-mcp. Selecciona **Enviar** para iniciarlo; puedes cambiar el puerto, la vinculación y la autenticación más adelante en las opciones de la integración."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "Herramientas de archivos y YAML de HA-MCP",
|
||||
"description": "Configura los servicios privilegiados de edición de archivos y YAML que usan las herramientas opcionales de archivos/YAML de ha-mcp. Estos ajustes aparecen también en la propia interfaz de ajustes del servidor ha-mcp y se aplican en caliente, sin reiniciar. Un mínimo de denegación no anulable sigue bloqueando rutas sensibles (p. ej. .storage) y claves de la frontera de confianza (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Directorios de archivos adicionales",
|
||||
"extra_yaml_keys": "Claves YAML de escritura adicionales"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Directorios relativos al directorio de configuración, cada uno con permiso de lectura y escritura (p. ej. pyscript). Se descartan los recorridos de ruta y las entradas fuera de la configuración.",
|
||||
"extra_yaml_keys": "Claves de primer nivel que ha_config_set_yaml puede escribir además de las integradas, para integraciones basadas en YAML de esta instalación (p. ej. alert2). Las claves de la frontera de confianza se descartan."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "Servidor HA-MCP",
|
||||
"description": "Configura el servidor HA-MCP. {panel_hint}Los cambios de aquí se aplican al guardar.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Canal de versiones",
|
||||
"auto_update": "Actualizaciones automáticas del servidor",
|
||||
"server_port": "Puerto de escucha del servidor MCP",
|
||||
"bind_host": "Acceso desde la red",
|
||||
"webhook_auth": "Modo de autenticación",
|
||||
"oauth_client_id_override": "OAuth heredado: Client ID personalizado (opcional)",
|
||||
"oauth_client_secret_override": "OAuth heredado: Client Secret personalizado (opcional)",
|
||||
"oauth_regenerate": "OAuth heredado: regenerar ahora el Client ID y el Client Secret",
|
||||
"pip_spec": "Desarrollo: paquete ha-mcp alternativo",
|
||||
"server_url": "URL de Home Assistant (avanzado)",
|
||||
"external_url": "URL externa (opcional)",
|
||||
"webhook_id_override": "Secreto de webhook personalizado (opcional)",
|
||||
"secret_path_override": "Ruta de acceso directo personalizada (opcional)",
|
||||
"regenerate_secrets": "Regenerar ahora los secretos de conexión",
|
||||
"enable_webhook": "Acceso remoto mediante webhook",
|
||||
"enable_llm_api": "API de LLM para agentes de conversación",
|
||||
"llm_api_exposure": "Exposición de herramientas al agente de conversación",
|
||||
"enable_startup_notification": "Notificación de inicio",
|
||||
"enable_sidebar_panel": "Panel de ajustes en la barra lateral"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "Estable instala la última versión estable; Desarrollo instala la compilación de desarrollo más reciente. Con las actualizaciones automáticas activadas, una recarga o un reinicio, más una comprobación periódica, instalan la compilación más reciente del canal elegido. El paquete alternativo de desarrollo de abajo tiene prioridad y desactiva las actualizaciones automáticas.",
|
||||
"auto_update": "Cuando está activado, la versión más reciente del canal elegido se instala automáticamente: en una recarga o reinicio y mediante una comprobación periódica. Cuando está desactivado, el servidor se queda en la versión instalada hasta que lo vuelvas a activar. Esto controla únicamente el paquete del servidor ha-mcp; las actualizaciones del propio componente personalizado HA-MCP siguen llegando por HACS.",
|
||||
"server_port": "El puerto en el que escucha este servidor. El complemento ha-mcp usa el 9583, así que aquí el valor predeterminado es 9584 para que ambos puedan convivir; si no usas el complemento, sirve cualquier puerto libre.",
|
||||
"bind_host": "Quién puede conectarse directamente al puerto del servidor MCP. El valor predeterminado coincide con el del complemento: accesible en tu red local, con la ruta secreta como credencial. Elige loopback para permitir solo conexiones desde la propia máquina de Home Assistant; la URL del webhook y el panel de la barra lateral funcionan en ambos casos.",
|
||||
"webhook_auth": "Cómo se identifican los clientes MCP en la URL del webhook. Con la URL secreta, el propio enlace es la credencial. Con el inicio de sesión de Home Assistant, clientes como claude.ai entran con una cuenta de administrador de Home Assistant (OAuth). Con OAuth heredado, esta integración emite su propio Client ID y Client Secret para pegarlos en clientes que los exijan, como Google Gemini Spark; activarlo o desactivarlo requiere reiniciar Home Assistant.",
|
||||
"oauth_client_id_override": "Sustituye el Client ID de OAuth heredado generado automáticamente. Déjalo vacío para conservar el actual. Solo se usa mientras el modo de autenticación esté en OAuth heredado.",
|
||||
"oauth_client_secret_override": "Sustituye el Client Secret de OAuth heredado generado automáticamente. Déjalo vacío para conservar el actual. Solo se usa mientras el modo de autenticación esté en OAuth heredado.",
|
||||
"oauth_regenerate": "Acción puntual: genera un Client ID y un Client Secret nuevos para el modo OAuth heredado. Solo surte efecto tras el reinicio de Home Assistant que pide el aviso de reparación; hasta que reinicies siguen funcionando el Client ID y el Client Secret anteriores, y no los nuevos. También vacía los dos campos de sustitución de arriba.",
|
||||
"pip_spec": "Déjalo vacío. Solo sirve para probar una compilación concreta de ha-mcp (por ejemplo, fijar una versión preliminar); tiene prioridad sobre el canal de versiones y desactiva las actualizaciones automáticas hasta que lo vacíes.",
|
||||
"server_url": "La URL que usa el servidor integrado para llegar a tu Home Assistant (normalmente esta misma instancia). Déjala vacía para deducirla del puerto y los ajustes SSL de esta instancia; indica un valor solo si el servidor necesita otra ruta.",
|
||||
"external_url": "Se muestra como URL de conexión principal: úsala cuando Home Assistant esté detrás de tu propio dominio o proxy inverso. Introduce la dirección base completa, incluido el esquema. Debe apuntar directamente a Home Assistant —abrirla en un navegador debería llevar a tu página de inicio de sesión de HA— y no debe contener un puerto como :8123 (ni ningún otro), o los clientes MCP remotos no podrán llegar. Déjala vacía para usar automáticamente Nabu Casa o la dirección local.",
|
||||
"webhook_id_override": "Sustituye el secreto aleatorio del webhook en la URL de conexión (/api/webhook/...). La URL es la credencial: usa un valor largo y difícil de adivinar. Déjalo vacío para conservar el actual.",
|
||||
"secret_path_override": "Sustituye la ruta aleatoria que se usa para el acceso directo en el puerto del servidor. Misma regla: la ruta es la credencial. Déjalo vacío para conservar la actual.",
|
||||
"regenerate_secrets": "Acción puntual: genera un secreto de webhook y una ruta de acceso directo aleatorios nuevos, invalidando de inmediato las URL de conexión antiguas. También vacía los dos campos de sustitución de arriba.",
|
||||
"enable_webhook": "Desactívalo para el modo solo local: el webhook de Home Assistant no se registra en absoluto, así que nada —Nabu Casa incluida— puede llegar al servidor a través de Home Assistant. El puerto directo del servidor y el panel de la barra lateral siguen funcionando.",
|
||||
"enable_llm_api": "Ofrece el conjunto completo de herramientas a los agentes de conversación de Home Assistant (OpenAI, Google, Ollama, ...): mientras esté activado, los agentes pueden seleccionar 'HA-MCP Server' en Controlar Home Assistant y manejar las herramientas desde el chat y la voz de Assist. Activarlo solo lo hace seleccionable: no se expone nada hasta que lo elijas en un agente. Guía de uso: {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Forma del conjunto de herramientas que se ofrece a los agentes de conversación. La búsqueda de herramientas (predeterminada) mantiene pequeño el contexto del agente: una API compacta con herramientas fijadas más metaherramientas de búsqueda y ejecución. El catálogo completo lista directamente todas las herramientas expuestas, mejor para modelos con contexto grande. Ambos registra las dos opciones en paralelo para que cada agente elija la suya en Controlar Home Assistant. La exposición por herramienta se gestiona en el panel de ajustes de HA-MCP; detalles: {llm_api_docs_url}",
|
||||
"enable_startup_notification": "Muestra una notificación cada vez que arranca el servidor, con enlaces a las superficies de ajustes reservadas a administradores. Desactívalo para arrancar en silencio: las URL de conexión siguen apareciendo en el registro de Home Assistant.",
|
||||
"enable_sidebar_panel": "Muestra el panel de ajustes de HA-MCP en la barra lateral (solo para administradores). Desactívalo para quitar la entrada de la barra lateral: las opciones del servidor siguen disponibles en esta pantalla."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "El servidor HA-MCP integrado en el proceso no ha podido arrancar",
|
||||
"description": "El servidor HA-MCP integrado en el proceso no se ha podido iniciar dentro de Home Assistant:\n\n{detail}\n\nRevisa los registros de Home Assistant y vuelve a cargar la integración (o corrige el problema de fondo y recárgala) para reintentarlo."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "No se ha podido instalar el paquete del servidor HA-MCP integrado en el proceso",
|
||||
"description": "Ha fallado la instalación del paquete ha-mcp para el servidor integrado en el proceso:\n\n{detail}\n\nResuelve el problema de compatibilidad o de instalación descrito arriba y vuelve a cargar la integración para reintentarlo."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "Actualiza el componente personalizado HA-MCP mediante HACS",
|
||||
"description": "El servidor ha-mcp instalado requiere el componente personalizado HA-MCP {required} o posterior, pero tienes {installed}. Actualiza el componente mediante HACS (abre la entrada del componente personalizado HA-MCP y usa 'Actualizar información' si todavía no aparece ninguna actualización) y reinicia Home Assistant. Mientras tanto el servidor sigue funcionando, pero puede que algunas funciones nuevas no funcionen hasta que se actualice el componente."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "Actualización del servidor HA-MCP a la espera de una actualización del componente",
|
||||
"description": "Está disponible el servidor ha-mcp {latest}, pero esa versión actualizó también el componente personalizado HA-MCP (a {shipped}; tú ejecutas {running}). Para evitar arrancar una versión del servidor con la que el componente en uso nunca se ha probado, la actualización automática del servidor queda en espera hasta que se actualice el componente.\n\nActualiza el componente mediante HACS (abre la entrada del componente personalizado HA-MCP y usa 'Actualizar información' si todavía no aparece ninguna actualización) y reinicia Home Assistant: después, la actualización del servidor se instala automáticamente. Para instalar la actualización del servidor de todos modos, pulsa Instalar en la entidad de actualización del servidor HA-MCP."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Componente instalado desde el repositorio antiguo",
|
||||
"description": "HACS está siguiendo el repositorio principal del servidor ha-mcp para este componente, así que aquí muestra los números de versión del servidor (7.x) y sus notas de la versión en lugar de los del propio componente (1.x). Las actualizaciones siguen funcionando, pero permanecen mal etiquetadas. Para arreglarlo: quita este repositorio de HACS (se conservan tus ajustes de integración y tus entradas de configuración), añade homeassistant-ai/ha-mcp-integration como repositorio personalizado, reinstala el componente desde ahí y reinicia Home Assistant."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Reinicia Home Assistant para aplicar el cambio de OAuth heredado",
|
||||
"description": "El modo de autenticación OAuth heredado registra sus propios extremos web /authorize y /token, que Home Assistant solo puede enlazar o liberar en un reinicio completo, tanto si acabas de activar este modo como si lo has desactivado o has cambiado su Client ID o Client Secret. Reinicia Home Assistant (Ajustes - Sistema - Reiniciar) para aplicar el cambio; hasta entonces se mantiene el comportamiento anterior."
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Estable (recomendado)",
|
||||
"dev": "Desarrollo (última compilación)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "URL de webhook secreta (predeterminada)",
|
||||
"ha_auth": "Iniciar sesión con Home Assistant (OAuth)",
|
||||
"legacy": "OAuth heredado (Client ID y Client Secret, para Google Gemini Spark)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "Búsqueda de herramientas (compacta, predeterminada)",
|
||||
"full": "Catálogo completo",
|
||||
"both": "Ambas (elegir por agente)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "Actualizar"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Acceso directo desde la máquina de Home Assistant: {url}",
|
||||
"connect_local_lan": "Local/LAN (cuando el acceso desde la red es «Local network»): {url}",
|
||||
"connect_remote_url": "URL de conexión remota: {url}",
|
||||
"connect_urls_label": "URL de conexión:",
|
||||
"connect_urls_pending": "Las URL de conexión aparecen aquí (y en el registro de Home Assistant) una vez que el servidor se ha iniciado.",
|
||||
"connect_webhook_disabled": "El acceso remoto mediante webhook está desactivado (modo solo local).",
|
||||
"oauth_creds_pending": "El Client ID y el Client Secret aparecen aquí una vez que el servidor se ha iniciado.",
|
||||
"oauth_not_serving": "OAuth heredado aún no los está sirviendo — reinicia Home Assistant cuando te lo pida para activarlos.",
|
||||
"oauth_select_legacy_mode": "Pon el modo de autenticación de arriba en OAuth heredado y guarda para generar un Client ID y un Client Secret.",
|
||||
"panel_hint": "Abre el [panel de ajustes de HA-MCP](/ha-mcp) para la gestión de herramientas y los ajustes del servidor.",
|
||||
"tools_module_installed": "Módulo beta/avanzado de herramientas de archivos y YAML (opcional): Instalado",
|
||||
"tools_module_not_installed": "Módulo beta/avanzado de herramientas de archivos y YAML (opcional): No instalado — pulsa «Añadir entrada» en la página de esta integración y elige «HA-MCP File & YAML Tools»",
|
||||
"tools_module_not_loaded": "Módulo beta/avanzado de herramientas de archivos y YAML (opcional): Instalado pero no cargado — activa o vuelve a cargar la entrada «HA-MCP File & YAML Tools» en la página de esta integración",
|
||||
"version_line": "Componente {component_version} - Servidor ha-mcp {server_version} (canal {channel})",
|
||||
"version_not_installed": "aún no instalado",
|
||||
"version_unknown": "desconocido"
|
||||
"abort": {
|
||||
"already_configured": "Esta entrada ya está configurada.",
|
||||
"unsupported_home_assistant": "El servidor HA-MCP integrado en el proceso requiere Home Assistant {required} o posterior, pero esta instancia está ejecutando {installed}. Aún puedes usar la entrada HA-MCP File & YAML Tools de este componente con un servidor ha-mcp externo que se ejecute como aplicación (complemento) o contenedor de Docker."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "Herramientas de archivos y YAML de HA-MCP",
|
||||
"description": "Configura los servicios privilegiados de edición de archivos y YAML que usan las herramientas opcionales de archivos/YAML de ha-mcp. Estos ajustes aparecen también en la propia interfaz de ajustes del servidor ha-mcp y se aplican en caliente, sin reiniciar. Un mínimo de denegación no anulable sigue bloqueando rutas sensibles (p. ej. .storage) y claves de la frontera de confianza (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Directorios de archivos adicionales",
|
||||
"extra_yaml_keys": "Claves YAML de escritura adicionales"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Directorios relativos al directorio de configuración, cada uno con permiso de lectura y escritura (p. ej. pyscript). Se descartan los recorridos de ruta y las entradas fuera de la configuración.",
|
||||
"extra_yaml_keys": "Claves de primer nivel que ha_config_set_yaml puede escribir además de las integradas, para integraciones basadas en YAML de esta instalación (p. ej. alert2). Las claves de la frontera de confianza se descartan."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "Servidor HA-MCP",
|
||||
"description": "Configura el servidor HA-MCP. {panel_hint}Los cambios de aquí se aplican al guardar.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Canal de versiones",
|
||||
"auto_update": "Actualizaciones automáticas del servidor",
|
||||
"server_port": "Puerto de escucha del servidor MCP",
|
||||
"bind_host": "Acceso desde la red",
|
||||
"webhook_auth": "Modo de autenticación",
|
||||
"oauth_client_id_override": "OAuth heredado: Client ID personalizado (opcional)",
|
||||
"oauth_client_secret_override": "OAuth heredado: Client Secret personalizado (opcional)",
|
||||
"oauth_regenerate": "OAuth heredado: regenerar ahora el Client ID y el Client Secret",
|
||||
"pip_spec": "Desarrollo: paquete ha-mcp alternativo",
|
||||
"server_url": "URL de Home Assistant (avanzado)",
|
||||
"external_url": "URL externa (opcional)",
|
||||
"webhook_id_override": "Secreto de webhook personalizado (opcional)",
|
||||
"secret_path_override": "Ruta de acceso directo personalizada (opcional)",
|
||||
"regenerate_secrets": "Regenerar ahora los secretos de conexión",
|
||||
"enable_webhook": "Acceso remoto mediante webhook",
|
||||
"enable_llm_api": "API de LLM para agentes de conversación",
|
||||
"llm_api_exposure": "Exposición de herramientas al agente de conversación",
|
||||
"enable_startup_notification": "Notificación de inicio",
|
||||
"enable_sidebar_panel": "Panel de ajustes en la barra lateral"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "Estable instala la última versión estable; Desarrollo instala la compilación de desarrollo más reciente. Con las actualizaciones automáticas activadas, una recarga o un reinicio, más una comprobación periódica, instalan la compilación más reciente del canal elegido. El paquete alternativo de desarrollo de abajo tiene prioridad y desactiva las actualizaciones automáticas.",
|
||||
"auto_update": "Cuando está activado, la versión más reciente del canal elegido se instala automáticamente: en una recarga o reinicio y mediante una comprobación periódica. Cuando está desactivado, el servidor se queda en la versión instalada hasta que lo vuelvas a activar. Esto controla únicamente el paquete del servidor ha-mcp; las actualizaciones del propio componente personalizado HA-MCP siguen llegando por HACS.",
|
||||
"server_port": "El puerto en el que escucha este servidor. La aplicación (complemento) de ha-mcp usa el 9583, por lo que el valor predeterminado es el 9584 para permitir que ambos se ejecuten simultáneamente; si no ejecutas la aplicación (complemento), cualquier puerto libre sirve.",
|
||||
"bind_host": "Quién puede conectarse directamente al puerto del servidor MCP. El valor predeterminado coincide con el de la aplicación (complemento): accesible en tu red local, con la ruta secreta como credencial. Elige bucle local (loopback) para permitir solo conexiones desde la propia máquina de Home Assistant; la URL del webhook y el panel de la barra lateral funcionan en ambos casos.",
|
||||
"webhook_auth": "Cómo los clientes de MCP se autentican en la URL del webhook. Con la URL secreta, el propio enlace es la única credencial — OAuth sigue funcionando para los clientes que lo usan, pero cada inicio de sesión se aprueba automáticamente: no se necesita iniciar sesión ni un ID de cliente o Secreto. Con el inicio de sesión de Home Assistant, clientes como claude.ai inician sesión con una cuenta de administrador de Home Assistant (OAuth). Con OAuth heredado, esta integración ejecuta su propio servicio de inicio de sesión y emite un ID de cliente y un Secreto para pegar en los clientes que lo requieran — puede ser necesario reiniciar Home Assistant para activarlo o desactivarlo por completo.",
|
||||
"oauth_client_id_override": "Sustituye el Client ID de OAuth heredado generado automáticamente. Déjalo vacío para conservar el actual. Solo se usa mientras el modo de autenticación esté en OAuth heredado.",
|
||||
"oauth_client_secret_override": "Sustituye el Client Secret de OAuth heredado generado automáticamente. Déjalo vacío para conservar el actual. Solo se usa mientras el modo de autenticación esté en OAuth heredado.",
|
||||
"oauth_regenerate": "Acción puntual: genera un Client ID y un Client Secret nuevos para el modo OAuth heredado. Solo surte efecto tras el reinicio de Home Assistant que pide el aviso de reparación; hasta que reinicies siguen funcionando el Client ID y el Client Secret anteriores, y no los nuevos. También vacía los dos campos de sustitución de arriba.",
|
||||
"pip_spec": "Déjalo vacío. Solo sirve para probar una compilación concreta de ha-mcp (por ejemplo, fijar una versión preliminar); tiene prioridad sobre el canal de versiones y desactiva las actualizaciones automáticas hasta que lo vacíes.",
|
||||
"server_url": "La URL que usa el servidor integrado para llegar a tu Home Assistant (normalmente esta misma instancia). Déjala vacía para deducirla del puerto y los ajustes SSL de esta instancia; indica un valor solo si el servidor necesita otra ruta.",
|
||||
"external_url": "Se muestra como URL de conexión principal: úsala cuando Home Assistant esté detrás de tu propio dominio o proxy inverso. Introduce la dirección base completa, incluido el esquema. Debe apuntar directamente a Home Assistant —abrirla en un navegador debería llevar a tu página de inicio de sesión de HA— y no debe contener un puerto como :8123 (ni ningún otro), o los clientes MCP remotos no podrán llegar. Déjala vacía para usar automáticamente Nabu Casa o la dirección local.",
|
||||
"webhook_id_override": "Sustituye el secreto aleatorio del webhook en la URL de conexión (/api/webhook/...). La URL es la credencial: usa un valor largo y difícil de adivinar. Déjalo vacío para conservar el actual.",
|
||||
"secret_path_override": "Sustituye la ruta aleatoria que se usa para el acceso directo en el puerto del servidor. Misma regla: la ruta es la credencial. Déjalo vacío para conservar la actual.",
|
||||
"regenerate_secrets": "Acción puntual: genera un secreto de webhook y una ruta de acceso directo aleatorios nuevos, invalidando de inmediato las URL de conexión antiguas. También vacía los dos campos de sustitución de arriba.",
|
||||
"enable_webhook": "Desactívalo para el modo solo local: el webhook de Home Assistant no se registra en absoluto, así que nada —Nabu Casa incluida— puede llegar al servidor a través de Home Assistant. El puerto directo del servidor y el panel de la barra lateral siguen funcionando.",
|
||||
"enable_llm_api": "Ofrece el conjunto completo de herramientas a los agentes de conversación de Home Assistant (OpenAI, Google, Ollama, ...): mientras esté activado, los agentes pueden seleccionar 'HA-MCP Server' en Controlar Home Assistant y manejar las herramientas desde el chat y la voz de Assist. Activarlo solo lo hace seleccionable: no se expone nada hasta que lo elijas en un agente. Guía de uso: {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Forma del conjunto de herramientas que se ofrece a los agentes de conversación. La búsqueda de herramientas (predeterminada) mantiene pequeño el contexto del agente: una API compacta con herramientas fijadas más metaherramientas de búsqueda y ejecución. El catálogo completo lista directamente todas las herramientas expuestas, mejor para modelos con contexto grande. Ambos registra las dos opciones en paralelo para que cada agente elija la suya en Controlar Home Assistant. La exposición por herramienta se gestiona en el panel de ajustes de HA-MCP; detalles: {llm_api_docs_url}",
|
||||
"enable_startup_notification": "Muestra una notificación cada vez que arranca el servidor, con enlaces a las superficies de ajustes reservadas a administradores. Desactívalo para arrancar en silencio: las URL de conexión siguen apareciendo en el registro de Home Assistant.",
|
||||
"enable_sidebar_panel": "Muestra el panel de ajustes de HA-MCP en la barra lateral (solo para administradores). Desactívalo para quitar la entrada de la barra lateral: las opciones del servidor siguen disponibles en esta pantalla."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "El servidor HA-MCP integrado en el proceso no ha podido arrancar",
|
||||
"description": "El servidor HA-MCP integrado en el proceso no se ha podido iniciar dentro de Home Assistant:\n\n{detail}\n\nRevisa los registros de Home Assistant y vuelve a cargar la integración (o corrige el problema de fondo y recárgala) para reintentarlo."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "No se ha podido instalar el paquete del servidor HA-MCP integrado en el proceso",
|
||||
"description": "Ha fallado la instalación del paquete ha-mcp para el servidor integrado en el proceso:\n\n{detail}\n\nResuelve el problema de compatibilidad o de instalación descrito arriba y vuelve a cargar la integración para reintentarlo."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "Actualiza el componente personalizado HA-MCP mediante HACS",
|
||||
"description": "El servidor ha-mcp instalado requiere el componente personalizado HA-MCP {required} o posterior, pero tienes {installed}. Actualiza el componente mediante HACS (abre la entrada del componente personalizado HA-MCP y usa 'Actualizar información' si todavía no aparece ninguna actualización) y reinicia Home Assistant. Mientras tanto el servidor sigue funcionando, pero puede que algunas funciones nuevas no funcionen hasta que se actualice el componente."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "Actualización del servidor HA-MCP a la espera de una actualización del componente",
|
||||
"description": "Está disponible el servidor ha-mcp {latest}, pero esa versión actualizó también el componente personalizado HA-MCP (a {shipped}; tú ejecutas {running}). Para evitar arrancar una versión del servidor con la que el componente en uso nunca se ha probado, la actualización automática del servidor queda en espera hasta que se actualice el componente.\n\nActualiza el componente mediante HACS (abre la entrada del componente personalizado HA-MCP y usa 'Actualizar información' si todavía no aparece ninguna actualización) y reinicia Home Assistant: después, la actualización del servidor se instala automáticamente. Para instalar la actualización del servidor de todos modos, pulsa Instalar en la entidad de actualización del servidor HA-MCP."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Componente instalado desde el repositorio antiguo",
|
||||
"description": "HACS está rastreando el repositorio principal del servidor ha-mcp para este componente, por lo que HACS muestra aquí los números de versión y las notas de la versión del servidor en lugar de los propios del componente (2.x). Las actualizaciones siguen funcionando, pero permanecen mal etiquetadas de esta manera. Para solucionarlo: elimina este repositorio de HACS (se conservan tus ajustes de integración y entradas de configuración), añade homeassistant-ai/ha-mcp-integration como un repositorio personalizado, reinstala el componente desde él y reinicia Home Assistant."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Reinicia Home Assistant para aplicar los ajustes de OAuth heredado",
|
||||
"fix_flow": {
|
||||
"step": {
|
||||
"confirm": {
|
||||
"title": "¿Reiniciar Home Assistant?",
|
||||
"description": "Al enviar este formulario se reiniciará Home Assistant y se aplicarán los ajustes de OAuth heredado.\n\nHaz clic en <strong>Enviar</strong> para reiniciar ahora."
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Estable (recomendado)",
|
||||
"dev": "Desarrollo (última compilación)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "URL de webhook secreta (predeterminada)",
|
||||
"ha_auth": "Iniciar sesión con Home Assistant (OAuth)",
|
||||
"legacy": "OAuth heredado (esta integración emite un ID de cliente/Secreto para pegar)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "Búsqueda de herramientas (compacta, predeterminada)",
|
||||
"full": "Catálogo completo",
|
||||
"both": "Ambas (elegir por agente)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "Actualizar"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Acceso directo desde la máquina de Home Assistant: {url}",
|
||||
"connect_local_lan": "Local/LAN (cuando el acceso desde la red es «Local network»): {url}",
|
||||
"connect_remote_url": "URL de conexión remota: {url}",
|
||||
"connect_urls_label": "URL de conexión:",
|
||||
"connect_urls_pending": "Las URL de conexión aparecen aquí (y en el registro de Home Assistant) una vez que el servidor se ha iniciado.",
|
||||
"connect_webhook_disabled": "El acceso remoto mediante webhook está desactivado (modo solo local).",
|
||||
"oauth_creds_pending": "El Client ID y el Client Secret aparecen aquí una vez que el servidor se ha iniciado.",
|
||||
"oauth_not_serving": "OAuth heredado aún no los está sirviendo — reinicia Home Assistant cuando te lo pida para activarlos.",
|
||||
"oauth_select_legacy_mode": "Pon el modo de autenticación de arriba en OAuth heredado y guarda para generar un Client ID y un Client Secret.",
|
||||
"panel_hint": "Abre el [panel de ajustes de HA-MCP](/ha-mcp) para la gestión de herramientas y los ajustes del servidor.",
|
||||
"tools_module_installed": "Módulo beta/avanzado de herramientas de archivos y YAML (opcional): Instalado",
|
||||
"tools_module_not_installed": "Módulo beta/avanzado de herramientas de archivos y YAML (opcional): No instalado — pulsa «Añadir entrada» en la página de esta integración y elige «HA-MCP File & YAML Tools»",
|
||||
"tools_module_not_loaded": "Módulo beta/avanzado de herramientas de archivos y YAML (opcional): Instalado pero no cargado — activa o vuelve a cargar la entrada «HA-MCP File & YAML Tools» en la página de esta integración",
|
||||
"version_line": "Componente {component_version} - Servidor ha-mcp {server_version} (canal {channel})",
|
||||
"version_not_installed": "aún no instalado",
|
||||
"version_unknown": "desconocido"
|
||||
}
|
||||
}
|
||||
@@ -1,161 +1,168 @@
|
||||
{
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "Composant personnalisé HA-MCP",
|
||||
"description": "Choisissez ce que vous souhaitez ajouter. **Serveur HA-MCP** exécute le serveur ha-mcp complet à l'intérieur de Home Assistant et l'expose via un webhook Home Assistant – c'est l'installation que la plupart des utilisateurs veulent. C'est un serveur autonome et un remplacement complet de toutes les autres méthodes d'installation (add-on, Docker, uvx/PyPI, stdio) ; si vous l'utilisez, n'en exécutez pas une autre en parallèle. **Outils Fichier & YAML HA-MCP** ajoute les services privilégiés d'édition de fichiers et de YAML, nécessaires uniquement si vous activez les outils fichier/YAML optionnels de ha-mcp. Si votre serveur ha-mcp tourne déjà ailleurs (add-on, Docker, uvx), vous n'avez pas besoin de l'entrée serveur – ajoutez uniquement cette entrée Fichier & YAML, et seulement si vous utilisez ces outils. Elle fonctionne avec tous les types de serveur et peut être ajoutée à tout moment.",
|
||||
"menu_options": {
|
||||
"server": "Serveur HA-MCP (recommandé)",
|
||||
"tools": "Outils Fichier & YAML HA-MCP (optionnel)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "Outils Fichier & YAML HA-MCP",
|
||||
"description": "Configure les services privilégiés d'édition de fichiers et de YAML. Nécessaire uniquement si vous activez les outils d'édition fichier/YAML optionnels de ha-mcp (drapeaux de fonctionnalité, désactivés par défaut) – cela s'applique à tous les types de serveur, y compris le serveur HA-MCP intégré. Vous pouvez ajouter ou supprimer cette entrée à tout moment."
|
||||
},
|
||||
"server": {
|
||||
"title": "Serveur HA-MCP",
|
||||
"description": "Cela exécute le serveur ha-mcp complet à l'intérieur de Home Assistant et l'expose à distance via un webhook Home Assistant (accessible via Nabu Casa ou tout reverse proxy). C'est un serveur autonome et un remplacement complet des méthodes d'installation add-on, Docker, uvx/PyPI et stdio – ne l'exécutez pas en parallèle d'un autre serveur ha-mcp. Sélectionnez **Soumettre** pour le démarrer ; vous pourrez modifier le port, la liaison et l'authentification ensuite dans les options de l'intégration."
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "Cette entrée est déjà configurée.",
|
||||
"unsupported_home_assistant": "Le serveur HA-MCP intégré nécessite Home Assistant {required} ou plus récent, mais cette instance utilise {installed}. Vous pouvez toujours utiliser l'entrée HA-MCP File & YAML Tools de ce composant avec un serveur ha-mcp externe fonctionnant en add-on ou conteneur Docker."
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "Composant personnalisé HA-MCP",
|
||||
"description": "Choisissez ce qu'il faut ajouter. **HA-MCP Server** exécute le serveur ha-mcp complet au sein de Home Assistant et l'expose via un webhook Home Assistant — c'est l'installation que la plupart des utilisateurs souhaitent. Il s'agit d'un serveur autonome et d'un remplacement complet pour toutes les autres méthodes d'installation : App (add-on), Docker, uvx/PyPI, stdio ; si vous l'exécutez, n'en exécutez pas un autre en même temps. **HA-MCP File & YAML Tools** a deux rôles. Si votre serveur ha-mcp s'exécute en dehors de Home Assistant — app, Docker, uvx/PyPI, stdio — cette entrée confère également à ce serveur les capacités de composants intégrés qu'il ne peut pas atteindre depuis l'extérieur (recherche rapide intégrée, métadonnées d'entrée de configuration, lectures basées sur le registre), il vaut donc la peine de l'ajouter à chaque installation externe, et elle sert de passerelle pour les services privilégiés d'édition de fichiers et de YAML utilisés par les outils de fichiers/YAML optionnels de ha-mcp. Si vous ajoutez l'entrée HA-MCP Server à la place, cette entrée fournit déjà ces capacités partagées, de sorte que cette seconde entrée n'est alors nécessaire que comme passerelle pour les outils de fichiers/YAML optionnels. Elle fonctionne avec tous les types de serveur et peut être ajoutée ultérieurement à tout moment.",
|
||||
"menu_options": {
|
||||
"server": "Serveur HA-MCP (recommandé)",
|
||||
"tools": "Outils Fichier & YAML HA-MCP (optionnel)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "Outils Fichier & YAML HA-MCP",
|
||||
"description": "Configure les services privilégiés de configuration de fichiers et de YAML, qui restent protégés derrière les outils d'édition de fichiers/YAML optionnels de ha-mcp (indicateurs de fonctionnalités, désactivés par défaut) — cela s'applique à tous les types de serveur, y compris le HA-MCP Server intégré. Si votre serveur ha-mcp s'exécute en dehors de Home Assistant, cette entrée lui confère également les capacités de composants intégrés qu'il ne peut pas atteindre depuis l'extérieur (recherche rapide intégrée, métadonnées d'entrée de configuration, lectures basées sur le registre), qui valent la peine d'être activées même si les outils de fichiers/YAML sont désactivés. Vous pouvez ajouter ou supprimer cette entrée à tout moment."
|
||||
},
|
||||
"server": {
|
||||
"title": "Serveur HA-MCP",
|
||||
"description": "Ceci exécute le serveur ha-mcp complet au sein de Home Assistant et l'expose à distance via un webhook Home Assistant (accessible via Nabu Casa ou tout autre proxy inverse). Il s'agit d'un serveur autonome et d'un remplacement complet pour les méthodes d'installation application (add-on), Docker, uvx/PyPI et stdio – ne l'exécutez pas en même temps qu'un autre serveur ha-mcp. Sélectionnez **Submit** pour le démarrer ; vous pourrez modifier le port, la liaison et l'authentification ultérieurement dans les options de l'intégration."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "Outils Fichier & YAML HA-MCP",
|
||||
"description": "Configurez les services privilégiés d'édition de fichiers et de YAML utilisés par les outils fichier/YAML optionnels de ha-mcp. Ces paramètres apparaissent également dans l'interface de configuration du serveur ha-mcp et s'appliquent en direct, sans redémarrage. Un plancher de refus non contournable bloque toujours les chemins sensibles (ex. .storage) et les clés de limite de confiance (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Répertoires de fichiers supplémentaires",
|
||||
"extra_yaml_keys": "Clés d'écriture YAML supplémentaires"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Répertoires relatifs au répertoire de configuration, chacun avec accès en lecture et écriture (ex. pyscript). Les traversées et les entrées hors du répertoire de configuration sont ignorées.",
|
||||
"extra_yaml_keys": "Clés de premier niveau que ha_config_set_yaml peut écrire en plus de celles intégrées, pour les intégrations YAML-first de cette installation (ex. alert2). Les clés de limite de confiance sont ignorées."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "Serveur HA-MCP",
|
||||
"description": "Configurez le serveur HA-MCP. {panel_hint}Les modifications ici sont appliquées à l'enregistrement.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Canal de publication",
|
||||
"auto_update": "Mises à jour automatiques du serveur",
|
||||
"server_port": "Port d'écoute du serveur MCP",
|
||||
"bind_host": "Accès réseau",
|
||||
"webhook_auth": "Mode d'authentification",
|
||||
"oauth_client_id_override": "OAuth hérité : Client ID personnalisé (optionnel)",
|
||||
"oauth_client_secret_override": "OAuth hérité : Client Secret personnalisé (optionnel)",
|
||||
"oauth_regenerate": "OAuth hérité : régénérer Client ID/Secret maintenant",
|
||||
"pip_spec": "Développeur : surcharge du paquet ha-mcp",
|
||||
"server_url": "URL Home Assistant (avancé)",
|
||||
"external_url": "URL externe (optionnel)",
|
||||
"webhook_id_override": "Secret webhook personnalisé (optionnel)",
|
||||
"secret_path_override": "Chemin d'accès direct personnalisé (optionnel)",
|
||||
"regenerate_secrets": "Régénérer les secrets de connexion maintenant",
|
||||
"enable_webhook": "Accès distant via webhook",
|
||||
"enable_llm_api": "API LLM pour agents de conversation",
|
||||
"llm_api_exposure": "Exposition des outils pour agents de conversation",
|
||||
"enable_startup_notification": "Notification au démarrage",
|
||||
"enable_sidebar_panel": "Panneau de configuration dans la barre latérale"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "Stable installe la dernière version stable ; Développement installe le dernier build de développement. Lorsque les mises à jour automatiques sont activées, un rechargement ou redémarrage, ainsi qu'une vérification périodique, installent le dernier build du canal sélectionné. Une surcharge de paquet développeur ci-dessous a la priorité et désactive les mises à jour automatiques.",
|
||||
"auto_update": "Lorsqu'activé, la dernière version du canal sélectionné est installée automatiquement – lors d'un rechargement ou redémarrage, et via une vérification périodique. Lorsqu'éteint, le serveur reste sur la version actuellement installée jusqu'à ce que vous le réactiviez. Cela contrôle uniquement le paquet serveur ha-mcp ; les mises à jour du composant personnalisé HA-MCP lui-même passent toujours par HACS.",
|
||||
"server_port": "Le port sur lequel ce serveur écoute. L'add-on ha-mcp utilise 9583, donc la valeur par défaut ici est 9584 pour permettre aux deux de coexister – si vous n'utilisez pas l'add-on, n'importe quel port libre convient.",
|
||||
"bind_host": "Qui peut se connecter directement au port du serveur MCP. La valeur par défaut correspond à l'add-on : accessible sur votre réseau local, avec le chemin secret comme identifiant. Choisissez loopback pour n'autoriser que les connexions depuis la machine Home Assistant elle-même – l'URL webhook et le panneau latéral fonctionnent dans les deux cas.",
|
||||
"webhook_auth": "Comment les clients MCP s'authentifient à l'URL webhook. Avec l'URL secrète, le lien lui-même est l'identifiant. Avec la connexion Home Assistant, les clients comme claude.ai se connectent avec un compte administrateur Home Assistant (OAuth). Avec OAuth hérité, cette intégration émet son propre Client ID et Secret à coller dans les clients qui en ont besoin, comme Google Gemini Spark – un redémarrage de Home Assistant est nécessaire pour l'activer ou le désactiver.",
|
||||
"oauth_client_id_override": "Remplace le Client ID OAuth hérité généré automatiquement. Laissez vide pour conserver l'actuel. Utilisé uniquement lorsque le mode d'authentification est défini sur OAuth hérité.",
|
||||
"oauth_client_secret_override": "Remplace le Client Secret OAuth hérité généré automatiquement. Laissez vide pour conserver l'actuel. Utilisé uniquement lorsque le mode d'authentification est défini sur OAuth hérité.",
|
||||
"oauth_regenerate": "Action unique : génère un nouveau Client ID et Secret pour le mode OAuth hérité. Cela ne prend effet qu'après le redémarrage de Home Assistant demandé par l'invite de réparation – jusqu'au redémarrage, les anciens Client ID et Secret continuent de fonctionner et les nouveaux ne sont pas encore actifs. Efface également les deux champs de surcharge ci-dessus.",
|
||||
"pip_spec": "Laissez vide. Uniquement pour tester un build spécifique de ha-mcp (par exemple un pin de pré-version) ; surcharge le canal de publication et désactive les mises à jour automatiques jusqu'à ce qu'il soit vidé.",
|
||||
"server_url": "L'URL que le serveur intégré utilise pour atteindre votre Home Assistant (généralement cette instance elle-même). Laissez vide pour la dériver du port et des paramètres SSL de cette instance ; ne définissez une valeur que si le serveur a besoin d'une autre route.",
|
||||
"external_url": "Affichée comme URL de connexion principale – utilisez-la lorsque Home Assistant est derrière votre propre domaine ou un reverse proxy. Entrez l'adresse de base complète, y compris le schéma. Elle doit pointer directement vers Home Assistant – l'ouvrir dans un navigateur doit atteindre votre page de connexion HA – et ne doit pas contenir de port tel que :8123 (ou tout autre port), sinon les clients MCP distants ne pourront pas l'atteindre. Laissez vide pour utiliser automatiquement Nabu Casa / l'adresse locale.",
|
||||
"webhook_id_override": "Remplace le secret webhook aléatoire dans l'URL de connexion (/api/webhook/...). L'URL est l'identifiant – utilisez une valeur longue et difficile à deviner. Laissez vide pour conserver l'actuel.",
|
||||
"secret_path_override": "Remplace le chemin aléatoire utilisé pour l'accès direct sur le port du serveur. Même règle : le chemin est l'identifiant. Laissez vide pour conserver l'actuel.",
|
||||
"regenerate_secrets": "Action unique : génère un nouveau secret webhook aléatoire et un chemin d'accès direct, invalidant immédiatement les anciennes URL de connexion. Efface également les deux champs de surcharge ci-dessus.",
|
||||
"enable_webhook": "Désactivez pour le mode local uniquement : le webhook Home Assistant n'est pas enregistré du tout, donc rien – y compris Nabu Casa – ne peut atteindre le serveur via Home Assistant. Le port serveur direct et le panneau latéral continuent de fonctionner.",
|
||||
"enable_llm_api": "Propose l'ensemble complet d'outils aux agents de conversation Home Assistant (OpenAI, Google, Ollama, ...) : lorsqu'activé, les agents peuvent sélectionner « HA-MCP Server » sous Contrôler Home Assistant et utiliser les outils depuis le chat Assist et la voix. L'activation le rend seulement sélectionnable – rien n'est exposé tant que vous ne le choisissez pas sur un agent. Guide d'utilisation : {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Forme de l'ensemble d'outils proposé aux agents de conversation. Recherche d'outils (par défaut) garde le contexte de l'agent compact : une API compacte avec des outils épinglés plus des méta-outils de recherche/exécution. Catalogue complet liste directement chaque outil exposé – mieux pour les modèles à grand contexte. Les deux enregistre les deux côte à côte afin que chaque agent choisisse le sien sous Contrôler Home Assistant. L'exposition par outil est gérée dans le panneau de configuration HA-MCP ; détails : {llm_api_docs_url}",
|
||||
"enable_startup_notification": "Affiche une notification à chaque démarrage du serveur, pointant vers les surfaces de configuration réservées aux administrateurs. Désactivez pour démarrer silencieusement – les URL de connexion apparaissent toujours dans le journal Home Assistant.",
|
||||
"enable_sidebar_panel": "Affiche le panneau de configuration HA-MCP dans la barre latérale (administrateurs uniquement). Désactivez pour supprimer l'entrée de la barre latérale – les options du serveur restent disponibles sur cet écran."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "Échec du démarrage du serveur HA-MCP intégré",
|
||||
"description": "Le serveur HA-MCP intégré n'a pas pu être démarré à l'intérieur de Home Assistant :\n\n{detail}\n\nVérifiez les journaux Home Assistant, puis rechargez l'intégration (ou corrigez le problème sous-jacent et rechargez) pour réessayer."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "Échec de l'installation du paquet serveur HA-MCP intégré",
|
||||
"description": "L'installation du paquet ha-mcp pour le serveur intégré a échoué :\n\n{detail}\n\nRésolvez le problème de compatibilité ou d'installation décrit ci-dessus, puis rechargez l'intégration pour réessayer."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "Mettez à jour le composant personnalisé HA-MCP via HACS",
|
||||
"description": "Le serveur ha-mcp installé nécessite le composant personnalisé HA-MCP {required} ou plus récent, mais vous avez {installed}. Mettez à jour le composant via HACS (ouvrez l'entrée Composant personnalisé HA-MCP et utilisez « Update information » si aucune mise à jour n'est encore affichée) et redémarrez Home Assistant. Le serveur continue de fonctionner entre-temps, mais certaines fonctionnalités plus récentes peuvent ne pas fonctionner tant que le composant n'est pas mis à jour."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "Mise à jour du serveur HA-MCP en attente d'une mise à jour du composant",
|
||||
"description": "Le serveur ha-mcp {latest} est disponible, mais cette version a également mis à jour le composant personnalisé HA-MCP (vers {shipped} ; vous utilisez {running}). Pour éviter de démarrer une version du serveur avec laquelle le composant en cours n'a jamais été testé, la mise à jour automatique du serveur est en attente jusqu'à la mise à jour du composant.\n\nMettez à jour le composant via HACS (ouvrez l'entrée Composant personnalisé HA-MCP et utilisez « Update information » si aucune mise à jour n'est encore affichée), puis redémarrez Home Assistant – la mise à jour du serveur s'installera automatiquement ensuite. Pour installer quand même la mise à jour du serveur, appuyez sur Installer sur l'entité de mise à jour du serveur HA-MCP."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Composant installé depuis le dépôt hérité",
|
||||
"description": "HACS suit le dépôt principal du serveur ha-mcp pour ce composant, donc HACS affiche ici les numéros de version du serveur (7.x) et les notes de version du serveur au lieu de celles du composant (1.x). Les mises à jour continuent de fonctionner, mais restent mal étiquetées de cette façon. Pour corriger : supprimez ce dépôt de HACS (vos paramètres d'intégration et entrées de configuration sont conservés), ajoutez homeassistant-ai/ha-mcp-integration comme dépôt personnalisé, réinstallez le composant depuis celui-ci, et redémarrez Home Assistant."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Redémarrez Home Assistant pour appliquer le changement OAuth hérité",
|
||||
"description": "Le mode d'authentification OAuth hérité enregistre ses propres points de terminaison web /authorize et /token, que Home Assistant ne peut lier ou libérer que lors d'un redémarrage complet – que vous veniez d'activer ce mode, de le désactiver, ou de modifier son Client ID/Secret. Redémarrez Home Assistant (Paramètres - Système - Redémarrer) pour appliquer le changement ; jusqu'alors le comportement précédent reste en vigueur."
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Stable (recommandé)",
|
||||
"dev": "Développement (dernier build)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "URL webhook secrète (par défaut)",
|
||||
"ha_auth": "Connexion avec Home Assistant (OAuth)",
|
||||
"legacy": "OAuth hérité (Client ID/Secret, pour Google Gemini Spark)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "Recherche d'outils (compact, par défaut)",
|
||||
"full": "Catalogue complet",
|
||||
"both": "Les deux (choix par agent)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "Mise à jour"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Accès direct depuis la machine Home Assistant : {url}",
|
||||
"connect_local_lan": "Local/LAN (lorsque l'accès réseau est « Local network ») : {url}",
|
||||
"connect_remote_url": "URL de connexion distante : {url}",
|
||||
"connect_urls_label": "URL de connexion :",
|
||||
"connect_urls_pending": "Les URL de connexion apparaissent ici (et dans le journal Home Assistant) une fois le serveur démarré.",
|
||||
"connect_webhook_disabled": "L'accès distant via webhook est désactivé (mode local uniquement).",
|
||||
"oauth_creds_pending": "Le Client ID et le Client Secret apparaissent ici une fois le serveur démarré.",
|
||||
"oauth_not_serving": "OAuth hérité ne les sert pas encore — redémarrez Home Assistant lorsqu'il vous le demande pour les activer.",
|
||||
"oauth_select_legacy_mode": "Réglez le mode d'authentification ci-dessus sur OAuth hérité et enregistrez pour générer un Client ID et un Client Secret.",
|
||||
"panel_hint": "Ouvrez le [panneau de réglages HA-MCP](/ha-mcp) pour la gestion des outils et les réglages du serveur.",
|
||||
"tools_module_installed": "Module bêta/avancé d'outils fichiers & YAML (facultatif) : Installé",
|
||||
"tools_module_not_installed": "Module bêta/avancé d'outils fichiers & YAML (facultatif) : Non installé — appuyez sur « Ajouter une entrée » sur la page de cette intégration et choisissez « HA-MCP File & YAML Tools »",
|
||||
"tools_module_not_loaded": "Module bêta/avancé d'outils fichiers & YAML (facultatif) : Installé mais non chargé — activez ou rechargez l'entrée « HA-MCP File & YAML Tools » sur la page de cette intégration",
|
||||
"version_line": "Composant {component_version} - Serveur ha-mcp {server_version} (canal {channel})",
|
||||
"version_not_installed": "pas encore installé",
|
||||
"version_unknown": "inconnu"
|
||||
"abort": {
|
||||
"already_configured": "Cette entrée est déjà configurée.",
|
||||
"unsupported_home_assistant": "Le serveur HA-MCP intégré nécessite Home Assistant {required} ou une version ultérieure, mais cette instance exécute {installed}. Vous pouvez toujours utiliser l'entrée HA-MCP File & YAML Tools de ce composant avec un serveur ha-mcp externe s'exécutant en tant qu'application (add-on) ou conteneur Docker."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "Outils Fichier & YAML HA-MCP",
|
||||
"description": "Configurez les services privilégiés d'édition de fichiers et de YAML utilisés par les outils fichier/YAML optionnels de ha-mcp. Ces paramètres apparaissent également dans l'interface de configuration du serveur ha-mcp et s'appliquent en direct, sans redémarrage. Un plancher de refus non contournable bloque toujours les chemins sensibles (ex. .storage) et les clés de limite de confiance (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Répertoires de fichiers supplémentaires",
|
||||
"extra_yaml_keys": "Clés d'écriture YAML supplémentaires"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Répertoires relatifs au répertoire de configuration, chacun avec accès en lecture et écriture (ex. pyscript). Les traversées et les entrées hors du répertoire de configuration sont ignorées.",
|
||||
"extra_yaml_keys": "Clés de premier niveau que ha_config_set_yaml peut écrire en plus de celles intégrées, pour les intégrations YAML-first de cette installation (ex. alert2). Les clés de limite de confiance sont ignorées."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "Serveur HA-MCP",
|
||||
"description": "Configurez le serveur HA-MCP. {panel_hint}Les modifications ici sont appliquées à l'enregistrement.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Canal de publication",
|
||||
"auto_update": "Mises à jour automatiques du serveur",
|
||||
"server_port": "Port d'écoute du serveur MCP",
|
||||
"bind_host": "Accès réseau",
|
||||
"webhook_auth": "Mode d'authentification",
|
||||
"oauth_client_id_override": "OAuth hérité : Client ID personnalisé (optionnel)",
|
||||
"oauth_client_secret_override": "OAuth hérité : Client Secret personnalisé (optionnel)",
|
||||
"oauth_regenerate": "OAuth hérité : régénérer Client ID/Secret maintenant",
|
||||
"pip_spec": "Développeur : surcharge du paquet ha-mcp",
|
||||
"server_url": "URL Home Assistant (avancé)",
|
||||
"external_url": "URL externe (optionnel)",
|
||||
"webhook_id_override": "Secret webhook personnalisé (optionnel)",
|
||||
"secret_path_override": "Chemin d'accès direct personnalisé (optionnel)",
|
||||
"regenerate_secrets": "Régénérer les secrets de connexion maintenant",
|
||||
"enable_webhook": "Accès distant via webhook",
|
||||
"enable_llm_api": "API LLM pour agents de conversation",
|
||||
"llm_api_exposure": "Exposition des outils pour agents de conversation",
|
||||
"enable_startup_notification": "Notification au démarrage",
|
||||
"enable_sidebar_panel": "Panneau de configuration dans la barre latérale"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "Stable installe la dernière version stable ; Développement installe le dernier build de développement. Lorsque les mises à jour automatiques sont activées, un rechargement ou redémarrage, ainsi qu'une vérification périodique, installent le dernier build du canal sélectionné. Une surcharge de paquet développeur ci-dessous a la priorité et désactive les mises à jour automatiques.",
|
||||
"auto_update": "Lorsqu'activé, la dernière version du canal sélectionné est installée automatiquement – lors d'un rechargement ou redémarrage, et via une vérification périodique. Lorsqu'éteint, le serveur reste sur la version actuellement installée jusqu'à ce que vous le réactiviez. Cela contrôle uniquement le paquet serveur ha-mcp ; les mises à jour du composant personnalisé HA-MCP lui-même passent toujours par HACS.",
|
||||
"server_port": "Le port sur lequel ce serveur écoute. L'application (add-on) ha-mcp utilise le port 9583, celui-ci utilise donc 9584 par défaut pour permettre aux deux de fonctionner côte à côte – si vous n'exécutez pas l'application (add-on), n'importe quel port libre convient.",
|
||||
"bind_host": "Qui peut se connecter directement au port du serveur MCP. La valeur par défaut correspond à l'application (add-on) : accessible sur votre réseau local, avec le chemin secret comme identifiant. Choisissez loopback pour n'autoriser que les connexions provenant de la machine Home Assistant elle-même – l'URL du webhook et le panneau de la barre latérale fonctionnent dans les deux cas.",
|
||||
"webhook_auth": "Comment les clients MCP s'authentifient à l'URL du webhook. Avec l'URL secrète, le lien lui-même est la seule information d'identification – OAuth fonctionne toujours pour les clients qui l'utilisent, mais chaque connexion est approuvée automatiquement : pas de connexion et pas de Client ID ou Secret nécessaires. Avec la connexion Home Assistant, les clients tels que claude.ai se connectent avec un compte administrateur Home Assistant (OAuth). Avec OAuth hérité, cette intégration exécute son propre service de connexion et émet un Client ID et un Secret à coller dans les clients qui en nécessitent un – un redémarrage de Home Assistant peut être nécessaire pour l'activer ou le désactiver complètement.",
|
||||
"oauth_client_id_override": "Remplace le Client ID OAuth hérité généré automatiquement. Laissez vide pour conserver l'actuel. Utilisé uniquement lorsque le mode d'authentification est défini sur OAuth hérité.",
|
||||
"oauth_client_secret_override": "Remplace le Client Secret OAuth hérité généré automatiquement. Laissez vide pour conserver l'actuel. Utilisé uniquement lorsque le mode d'authentification est défini sur OAuth hérité.",
|
||||
"oauth_regenerate": "Action unique : génère un nouveau Client ID et Secret pour le mode OAuth hérité. Cela ne prend effet qu'après le redémarrage de Home Assistant demandé par l'invite de réparation – jusqu'au redémarrage, les anciens Client ID et Secret continuent de fonctionner et les nouveaux ne sont pas encore actifs. Efface également les deux champs de surcharge ci-dessus.",
|
||||
"pip_spec": "Laissez vide. Uniquement pour tester un build spécifique de ha-mcp (par exemple un pin de pré-version) ; surcharge le canal de publication et désactive les mises à jour automatiques jusqu'à ce qu'il soit vidé.",
|
||||
"server_url": "L'URL que le serveur intégré utilise pour atteindre votre Home Assistant (généralement cette instance elle-même). Laissez vide pour la dériver du port et des paramètres SSL de cette instance ; ne définissez une valeur que si le serveur a besoin d'une autre route.",
|
||||
"external_url": "Affichée comme URL de connexion principale – utilisez-la lorsque Home Assistant est derrière votre propre domaine ou un reverse proxy. Entrez l'adresse de base complète, y compris le schéma. Elle doit pointer directement vers Home Assistant – l'ouvrir dans un navigateur doit atteindre votre page de connexion HA – et ne doit pas contenir de port tel que :8123 (ou tout autre port), sinon les clients MCP distants ne pourront pas l'atteindre. Laissez vide pour utiliser automatiquement Nabu Casa / l'adresse locale.",
|
||||
"webhook_id_override": "Remplace le secret webhook aléatoire dans l'URL de connexion (/api/webhook/...). L'URL est l'identifiant – utilisez une valeur longue et difficile à deviner. Laissez vide pour conserver l'actuel.",
|
||||
"secret_path_override": "Remplace le chemin aléatoire utilisé pour l'accès direct sur le port du serveur. Même règle : le chemin est l'identifiant. Laissez vide pour conserver l'actuel.",
|
||||
"regenerate_secrets": "Action unique : génère un nouveau secret webhook aléatoire et un chemin d'accès direct, invalidant immédiatement les anciennes URL de connexion. Efface également les deux champs de surcharge ci-dessus.",
|
||||
"enable_webhook": "Désactivez pour le mode local uniquement : le webhook Home Assistant n'est pas enregistré du tout, donc rien – y compris Nabu Casa – ne peut atteindre le serveur via Home Assistant. Le port serveur direct et le panneau latéral continuent de fonctionner.",
|
||||
"enable_llm_api": "Propose l'ensemble complet d'outils aux agents de conversation Home Assistant (OpenAI, Google, Ollama, ...) : lorsqu'activé, les agents peuvent sélectionner « HA-MCP Server » sous Contrôler Home Assistant et utiliser les outils depuis le chat Assist et la voix. L'activation le rend seulement sélectionnable – rien n'est exposé tant que vous ne le choisissez pas sur un agent. Guide d'utilisation : {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Forme de l'ensemble d'outils proposé aux agents de conversation. Recherche d'outils (par défaut) garde le contexte de l'agent compact : une API compacte avec des outils épinglés plus des méta-outils de recherche/exécution. Catalogue complet liste directement chaque outil exposé – mieux pour les modèles à grand contexte. Les deux enregistre les deux côte à côte afin que chaque agent choisisse le sien sous Contrôler Home Assistant. L'exposition par outil est gérée dans le panneau de configuration HA-MCP ; détails : {llm_api_docs_url}",
|
||||
"enable_startup_notification": "Affiche une notification à chaque démarrage du serveur, pointant vers les surfaces de configuration réservées aux administrateurs. Désactivez pour démarrer silencieusement – les URL de connexion apparaissent toujours dans le journal Home Assistant.",
|
||||
"enable_sidebar_panel": "Affiche le panneau de configuration HA-MCP dans la barre latérale (administrateurs uniquement). Désactivez pour supprimer l'entrée de la barre latérale – les options du serveur restent disponibles sur cet écran."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "Échec du démarrage du serveur HA-MCP intégré",
|
||||
"description": "Le serveur HA-MCP intégré n'a pas pu être démarré à l'intérieur de Home Assistant :\n\n{detail}\n\nVérifiez les journaux Home Assistant, puis rechargez l'intégration (ou corrigez le problème sous-jacent et rechargez) pour réessayer."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "Échec de l'installation du paquet serveur HA-MCP intégré",
|
||||
"description": "L'installation du paquet ha-mcp pour le serveur intégré a échoué :\n\n{detail}\n\nRésolvez le problème de compatibilité ou d'installation décrit ci-dessus, puis rechargez l'intégration pour réessayer."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "Mettez à jour le composant personnalisé HA-MCP via HACS",
|
||||
"description": "Le serveur ha-mcp installé nécessite le composant personnalisé HA-MCP {required} ou plus récent, mais vous avez {installed}. Mettez à jour le composant via HACS (ouvrez l'entrée Composant personnalisé HA-MCP et utilisez « Update information » si aucune mise à jour n'est encore affichée) et redémarrez Home Assistant. Le serveur continue de fonctionner entre-temps, mais certaines fonctionnalités plus récentes peuvent ne pas fonctionner tant que le composant n'est pas mis à jour."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "Mise à jour du serveur HA-MCP en attente d'une mise à jour du composant",
|
||||
"description": "Le serveur ha-mcp {latest} est disponible, mais cette version a également mis à jour le composant personnalisé HA-MCP (vers {shipped} ; vous utilisez {running}). Pour éviter de démarrer une version du serveur avec laquelle le composant en cours n'a jamais été testé, la mise à jour automatique du serveur est en attente jusqu'à la mise à jour du composant.\n\nMettez à jour le composant via HACS (ouvrez l'entrée Composant personnalisé HA-MCP et utilisez « Update information » si aucune mise à jour n'est encore affichée), puis redémarrez Home Assistant – la mise à jour du serveur s'installera automatiquement ensuite. Pour installer quand même la mise à jour du serveur, appuyez sur Installer sur l'entité de mise à jour du serveur HA-MCP."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Composant installé depuis le dépôt hérité",
|
||||
"description": "HACS suit le dépôt principal du serveur ha-mcp pour ce composant, donc HACS affiche ici les numéros de version et les notes de publication du serveur au lieu de ceux du composant lui-même (2.x). Les mises à jour continuent de fonctionner, mais restent mal étiquetées de cette manière. Pour corriger : supprimez ce dépôt de HACS (vos paramètres d'intégration et entrées de configuration sont conservés), ajoutez homeassistant-ai/ha-mcp-integration comme dépôt personnalisé, réinstallez le composant à partir de celui-ci, et redémarrez Home Assistant."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Redémarrez Home Assistant pour appliquer les paramètres OAuth hérités",
|
||||
"fix_flow": {
|
||||
"step": {
|
||||
"confirm": {
|
||||
"title": "Redémarrer Home Assistant ?",
|
||||
"description": "La soumission de ce formulaire redémarrera Home Assistant et appliquera les paramètres OAuth hérités.\n\nCliquez sur **Soumettre** pour redémarrer maintenant."
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Stable (recommandé)",
|
||||
"dev": "Développement (dernier build)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "URL webhook secrète (par défaut)",
|
||||
"ha_auth": "Connexion avec Home Assistant (OAuth)",
|
||||
"legacy": "OAuth hérité (cette intégration émet un Client ID/Secret à coller)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "Recherche d'outils (compact, par défaut)",
|
||||
"full": "Catalogue complet",
|
||||
"both": "Les deux (choix par agent)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "Mise à jour"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Accès direct depuis la machine Home Assistant : {url}",
|
||||
"connect_local_lan": "Local/LAN (lorsque l'accès réseau est « Local network ») : {url}",
|
||||
"connect_remote_url": "URL de connexion distante : {url}",
|
||||
"connect_urls_label": "URL de connexion :",
|
||||
"connect_urls_pending": "Les URL de connexion apparaissent ici (et dans le journal Home Assistant) une fois le serveur démarré.",
|
||||
"connect_webhook_disabled": "L'accès distant via webhook est désactivé (mode local uniquement).",
|
||||
"oauth_creds_pending": "Le Client ID et le Client Secret apparaissent ici une fois le serveur démarré.",
|
||||
"oauth_not_serving": "OAuth hérité ne les sert pas encore — redémarrez Home Assistant lorsqu'il vous le demande pour les activer.",
|
||||
"oauth_select_legacy_mode": "Réglez le mode d'authentification ci-dessus sur OAuth hérité et enregistrez pour générer un Client ID et un Client Secret.",
|
||||
"panel_hint": "Ouvrez le [panneau de réglages HA-MCP](/ha-mcp) pour la gestion des outils et les réglages du serveur.",
|
||||
"tools_module_installed": "Module bêta/avancé d'outils fichiers & YAML (facultatif) : Installé",
|
||||
"tools_module_not_installed": "Module bêta/avancé d'outils fichiers & YAML (facultatif) : Non installé — appuyez sur « Ajouter une entrée » sur la page de cette intégration et choisissez « HA-MCP File & YAML Tools »",
|
||||
"tools_module_not_loaded": "Module bêta/avancé d'outils fichiers & YAML (facultatif) : Installé mais non chargé — activez ou rechargez l'entrée « HA-MCP File & YAML Tools » sur la page de cette intégration",
|
||||
"version_line": "Composant {component_version} - Serveur ha-mcp {server_version} (canal {channel})",
|
||||
"version_not_installed": "pas encore installé",
|
||||
"version_unknown": "inconnu"
|
||||
}
|
||||
}
|
||||
@@ -1,161 +1,168 @@
|
||||
{
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "Componente personalizzato HA-MCP",
|
||||
"description": "Scegli cosa aggiungere. **Server HA-MCP** esegue il server ha-mcp completo dentro Home Assistant e lo espone tramite un webhook di Home Assistant: è l'installazione che va bene per la maggior parte delle persone. È un server autonomo e sostituisce completamente ogni altro metodo di installazione (componente aggiuntivo, Docker, uvx/PyPI, stdio); se usi questo, non usarne anche un altro. **Strumenti file e YAML di HA-MCP** aggiunge i servizi privilegiati di modifica di file e YAML, necessari solo se attivi gli strumenti file/YAML opzionali di ha-mcp. Se il tuo server ha-mcp gira già altrove (componente aggiuntivo, Docker, uvx), non ti serve la voce del server: aggiungi solo questa voce file e YAML, e solo se usi quegli strumenti. Funziona con qualsiasi tipo di server e si può aggiungere in seguito in qualsiasi momento.",
|
||||
"menu_options": {
|
||||
"server": "Server HA-MCP (consigliato)",
|
||||
"tools": "Strumenti file e YAML di HA-MCP (facoltativo)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "Strumenti file e YAML di HA-MCP",
|
||||
"description": "Configura i servizi privilegiati per i file e per la configurazione YAML. Servono solo se attivi gli strumenti opzionali di modifica file/YAML di ha-mcp (indicatori di funzione, disattivati per impostazione predefinita): vale per qualsiasi tipo di server, incluso il server HA-MCP eseguito nel processo. Puoi aggiungere o rimuovere questa voce in qualsiasi momento."
|
||||
},
|
||||
"server": {
|
||||
"title": "Server HA-MCP",
|
||||
"description": "Esegue il server ha-mcp completo dentro Home Assistant e lo espone da remoto tramite un webhook di Home Assistant (raggiungibile con Nabu Casa o con qualsiasi proxy inverso). È un server autonomo e sostituisce completamente i metodi di installazione tramite componente aggiuntivo, Docker, uvx/PyPI e stdio: non eseguirlo insieme a un altro server ha-mcp. Premi **Invia** per avviarlo; porta, associazione di rete e autenticazione si possono cambiare dopo, nelle opzioni dell'integrazione."
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "Questa voce è già configurata.",
|
||||
"unsupported_home_assistant": "Il server HA-MCP eseguito nel processo richiede Home Assistant {required} o successivo, ma questa istanza esegue {installed}. Puoi comunque usare la voce HA-MCP File & YAML Tools di questo componente con un server ha-mcp esterno eseguito come componente aggiuntivo o container Docker."
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "Componente personalizzato HA-MCP",
|
||||
"description": "Scegli cosa aggiungere. **HA-MCP Server** esegue il server ha-mcp completo all'interno di Home Assistant e lo espone tramite un webhook di Home Assistant: questa è l'installazione che la maggior parte delle persone desidera. È un server autonomo e una sostituzione completa per qualsiasi altro metodo di installazione: App (add-on), Docker, uvx/PyPI, stdio; se lo esegui, non eseguirne anche un altro. **HA-MCP File & YAML Tools** ha due ruoli. Se il tuo server ha-mcp viene eseguito al di fuori di Home Assistant - app, Docker, uvx/PyPI, stdio - questa voce fornisce anche a quel server le funzionalità del componente in-process che non può raggiungere dall'esterno (ricerca rapida in-process, metadati delle voci di configurazione, letture basate sul registro), quindi vale la pena aggiungerla a ogni installazione esterna, e fa da cancello per i servizi privilegiati di modifica di file e YAML utilizzati dagli strumenti opt-in per file/YAML di ha-mcp. Se invece aggiungi la voce HA-MCP Server, quella voce fornisce già tali capacità condivise, quindi questa seconda voce è necessaria solo come cancello per gli strumenti opt-in per file/YAML. Funziona con qualsiasi tipo di server e può essere aggiunta in seguito in qualsiasi momento.",
|
||||
"menu_options": {
|
||||
"server": "Server HA-MCP (consigliato)",
|
||||
"tools": "Strumenti file e YAML di HA-MCP (facoltativo)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "Strumenti file e YAML di HA-MCP",
|
||||
"description": "Configura i servizi privilegiati di configurazione di file e YAML, che rimangono protetti dietro gli strumenti opt-in di modifica file/YAML di ha-mcp (flag di funzionalità, disabilitati per impostazione predefinita) - questo vale per qualsiasi tipo di server, incluso l'**HA-MCP Server** in-process. Se il tuo server ha-mcp viene eseguito al di fuori di Home Assistant, questa voce gli fornisce anche le capacità del componente in-process che non può raggiungere dall'esterno (ricerca rapida in-process, metadati delle voci di configurazione, letture basate sul registro), che vale la pena avere anche con gli strumenti file/YAML disattivati. Puoi aggiungere o rimuovere questa voce in qualsiasi momento."
|
||||
},
|
||||
"server": {
|
||||
"title": "Server HA-MCP",
|
||||
"description": "Questo esegue l'intero server ha-mcp all'interno di Home Assistant e lo espone da remoto tramite un webhook di Home Assistant (raggiungibile tramite Nabu Casa o qualsiasi reverse proxy). È un server autonomo e sostituisce completamente i metodi di installazione app (add-on), Docker, uvx/PyPI e stdio: non eseguirlo insieme a un altro server ha-mcp. Seleziona **Invia** per avviarlo; puoi modificare la porta, il binding e l'autenticazione in un secondo momento nelle opzioni dell'integrazione."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "Strumenti file e YAML di HA-MCP",
|
||||
"description": "Configura i servizi privilegiati di modifica di file e YAML usati dagli strumenti file/YAML opzionali di ha-mcp. Queste impostazioni compaiono anche nell'interfaccia delle impostazioni del server ha-mcp e si applicano subito, senza riavvio. Una soglia di divieto non aggirabile continua a bloccare i percorsi sensibili (per esempio .storage) e le chiavi del confine di fiducia (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Directory di file aggiuntive",
|
||||
"extra_yaml_keys": "Chiavi YAML scrivibili aggiuntive"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Directory relative alla directory di configurazione, ciascuna con permesso di lettura e scrittura (per esempio pyscript). I percorsi che risalgono l'albero e le voci fuori dalla configurazione vengono scartati.",
|
||||
"extra_yaml_keys": "Chiavi di primo livello che ha_config_set_yaml può scrivere oltre a quelle integrate, per le integrazioni basate su YAML di questa installazione (per esempio alert2). Le chiavi del confine di fiducia vengono scartate."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "Server HA-MCP",
|
||||
"description": "Configura il server HA-MCP. {panel_hint}Le modifiche qui vengono applicate al salvataggio.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Canale di rilascio",
|
||||
"auto_update": "Aggiornamenti automatici del server",
|
||||
"server_port": "Porta di ascolto del server MCP",
|
||||
"bind_host": "Accesso dalla rete",
|
||||
"webhook_auth": "Modalità di autenticazione",
|
||||
"oauth_client_id_override": "OAuth legacy: Client ID personalizzato (facoltativo)",
|
||||
"oauth_client_secret_override": "OAuth legacy: Client Secret personalizzato (facoltativo)",
|
||||
"oauth_regenerate": "OAuth legacy: rigenera subito Client ID e Client Secret",
|
||||
"pip_spec": "Sviluppo: pacchetto ha-mcp alternativo",
|
||||
"server_url": "URL di Home Assistant (avanzato)",
|
||||
"external_url": "URL esterno (facoltativo)",
|
||||
"webhook_id_override": "Segreto del webhook personalizzato (facoltativo)",
|
||||
"secret_path_override": "Percorso di accesso diretto personalizzato (facoltativo)",
|
||||
"regenerate_secrets": "Rigenera subito i segreti di connessione",
|
||||
"enable_webhook": "Accesso remoto tramite webhook",
|
||||
"enable_llm_api": "API LLM per gli agenti conversazionali",
|
||||
"llm_api_exposure": "Esposizione degli strumenti agli agenti conversazionali",
|
||||
"enable_startup_notification": "Notifica all'avvio",
|
||||
"enable_sidebar_panel": "Pannello impostazioni nella barra laterale"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "Stabile installa l'ultima versione stabile; Sviluppo installa la build di sviluppo più recente. Con gli aggiornamenti automatici attivi, una ricarica o un riavvio, più un controllo periodico, installano la build più recente del canale scelto. Il pacchetto alternativo di sviluppo qui sotto ha la precedenza e disattiva gli aggiornamenti automatici.",
|
||||
"auto_update": "Quando è attivo, la versione più recente del canale scelto viene installata automaticamente: a una ricarica o a un riavvio e tramite un controllo periodico. Quando è disattivo, il server resta alla versione installata finché non lo riattivi. Questo riguarda solo il pacchetto del server ha-mcp; gli aggiornamenti del componente personalizzato HA-MCP continuano ad arrivare tramite HACS.",
|
||||
"server_port": "La porta su cui questo server ascolta. Il componente aggiuntivo ha-mcp usa la 9583, quindi qui il valore predefinito è 9584 per farli convivere; se non usi il componente aggiuntivo, va bene qualsiasi porta libera.",
|
||||
"bind_host": "Chi può collegarsi direttamente alla porta del server MCP. Il valore predefinito coincide con quello del componente aggiuntivo: raggiungibile sulla rete locale, con il percorso segreto come credenziale. Scegli loopback per consentire solo le connessioni dalla macchina di Home Assistant stessa: l'URL del webhook e il pannello nella barra laterale funzionano in entrambi i casi.",
|
||||
"webhook_auth": "Come i client MCP si identificano all'URL del webhook. Con l'URL segreto, il collegamento stesso è la credenziale. Con l'accesso tramite Home Assistant, client come claude.ai entrano con un account amministratore di Home Assistant (OAuth). Con OAuth legacy questa integrazione emette un proprio Client ID e Client Secret da incollare nei client che li richiedono, come Google Gemini Spark: attivarlo o disattivarlo richiede il riavvio di Home Assistant.",
|
||||
"oauth_client_id_override": "Sostituisce il Client ID OAuth legacy generato automaticamente. Lascialo vuoto per mantenere quello attuale. Viene usato solo mentre la modalità di autenticazione è impostata su OAuth legacy.",
|
||||
"oauth_client_secret_override": "Sostituisce il Client Secret OAuth legacy generato automaticamente. Lascialo vuoto per mantenere quello attuale. Viene usato solo mentre la modalità di autenticazione è impostata su OAuth legacy.",
|
||||
"oauth_regenerate": "Azione una tantum: genera un Client ID e un Client Secret nuovi per la modalità OAuth legacy. Ha effetto solo dopo il riavvio di Home Assistant che la richiesta di riparazione chiede; fino ad allora continuano a funzionare i precedenti e non i nuovi. Svuota anche i due campi di sostituzione qui sopra.",
|
||||
"pip_spec": "Lascialo vuoto. Serve solo per provare una build specifica di ha-mcp (per esempio una versione preliminare fissata); ha la precedenza sul canale di rilascio e disattiva gli aggiornamenti automatici finché non lo svuoti.",
|
||||
"server_url": "L'URL che il server nel processo usa per raggiungere il tuo Home Assistant (di solito questa stessa istanza). Lascialo vuoto per ricavarlo dalla porta e dalle impostazioni SSL di questa istanza; indica un valore solo se al server serve un percorso diverso.",
|
||||
"external_url": "Viene mostrato come URL di connessione principale: usalo quando Home Assistant sta dietro un tuo dominio o un proxy inverso. Inserisci l'indirizzo di base completo, schema incluso. Deve puntare direttamente a Home Assistant — aprendolo in un browser dovresti arrivare alla pagina di accesso di HA — e non deve contenere una porta come :8123 (né altre), altrimenti i client MCP remoti non riusciranno a raggiungerlo. Lascialo vuoto per usare automaticamente Nabu Casa o l'indirizzo locale.",
|
||||
"webhook_id_override": "Sostituisce il segreto casuale del webhook nell'URL di connessione (/api/webhook/...). L'URL è la credenziale: usa un valore lungo e difficile da indovinare. Lascialo vuoto per mantenere quello attuale.",
|
||||
"secret_path_override": "Sostituisce il percorso casuale usato per l'accesso diretto sulla porta del server. Stessa regola: il percorso è la credenziale. Lascialo vuoto per mantenere quello attuale.",
|
||||
"regenerate_secrets": "Azione una tantum: genera un nuovo segreto casuale per il webhook e un nuovo percorso di accesso diretto, invalidando subito i vecchi URL di connessione. Svuota anche i due campi di sostituzione qui sopra.",
|
||||
"enable_webhook": "Disattivalo per la modalità solo locale: il webhook di Home Assistant non viene registrato affatto, quindi nulla — Nabu Casa inclusa — può raggiungere il server attraverso Home Assistant. La porta diretta del server e il pannello nella barra laterale continuano a funzionare.",
|
||||
"enable_llm_api": "Offre l'intero set di strumenti agli agenti conversazionali di Home Assistant (OpenAI, Google, Ollama, ...): mentre è attivo, gli agenti possono selezionare «HA-MCP Server» sotto Controlla Home Assistant e usare gli strumenti dalla chat e dalla voce di Assist. Attivarlo lo rende solo selezionabile: non viene esposto nulla finché non lo scegli su un agente. Guida all'uso: {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Forma del set di strumenti offerto agli agenti conversazionali. La ricerca degli strumenti (predefinita) mantiene piccolo il contesto dell'agente: un'API compatta con strumenti fissati più meta-strumenti di ricerca ed esecuzione. Il catalogo completo elenca direttamente ogni strumento esposto, meglio per modelli con contesto ampio. Entrambi registra le due opzioni affiancate, così ogni agente sceglie la propria sotto Controlla Home Assistant. L'esposizione per singolo strumento si gestisce nel pannello impostazioni di HA-MCP; dettagli: {llm_api_docs_url}",
|
||||
"enable_startup_notification": "Mostra una notifica a ogni avvio del server, che rimanda alle superfici di impostazioni riservate agli amministratori. Disattivalo per un avvio silenzioso: gli URL di connessione restano comunque nel registro di Home Assistant.",
|
||||
"enable_sidebar_panel": "Mostra il pannello impostazioni di HA-MCP nella barra laterale (solo per gli amministratori). Disattivalo per togliere la voce dalla barra laterale: le opzioni del server restano disponibili in questa schermata."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "Il server HA-MCP nel processo non è riuscito ad avviarsi",
|
||||
"description": "Non è stato possibile avviare il server HA-MCP nel processo dentro Home Assistant:\n\n{detail}\n\nControlla i registri di Home Assistant, poi ricarica l'integrazione (o risolvi il problema di fondo e ricaricala) per riprovare."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "Non è stato possibile installare il pacchetto del server HA-MCP nel processo",
|
||||
"description": "L'installazione del pacchetto ha-mcp per il server nel processo non è riuscita:\n\n{detail}\n\nRisolvi il problema di compatibilità o di installazione descritto sopra, poi ricarica l'integrazione per riprovare."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "Aggiorna il componente personalizzato HA-MCP tramite HACS",
|
||||
"description": "Il server ha-mcp installato richiede il componente personalizzato HA-MCP {required} o successivo, ma hai {installed}. Aggiorna il componente tramite HACS (apri la voce del componente personalizzato HA-MCP e usa «Aggiorna informazioni» se non compare ancora alcun aggiornamento) e riavvia Home Assistant. Nel frattempo il server continua a funzionare, ma alcune funzioni più recenti potrebbero non funzionare finché il componente non viene aggiornato."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "Aggiornamento del server HA-MCP in attesa di un aggiornamento del componente",
|
||||
"description": "È disponibile il server ha-mcp {latest}, ma quella versione ha aggiornato anche il componente personalizzato HA-MCP (alla {shipped}; tu esegui la {running}). Per evitare di avviare una versione del server con cui il componente in uso non è mai stato provato, l'aggiornamento automatico del server resta sospeso finché il componente non viene aggiornato.\n\nAggiorna il componente tramite HACS (apri la voce del componente personalizzato HA-MCP e usa «Aggiorna informazioni» se non compare ancora alcun aggiornamento), poi riavvia Home Assistant: l'aggiornamento del server si installa automaticamente subito dopo. Per installare comunque l'aggiornamento del server, premi Installa sull'entità di aggiornamento del server HA-MCP."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Componente installato dal repository obsoleto",
|
||||
"description": "Per questo componente HACS sta seguendo il repository principale del server ha-mcp, quindi qui mostra i numeri di versione del server (7.x) e le sue note di rilascio invece di quelli del componente (1.x). Gli aggiornamenti continuano a funzionare, ma restano etichettati in modo sbagliato. Per rimediare: rimuovi questo repository da HACS (le impostazioni dell'integrazione e le voci di configurazione vengono mantenute), aggiungi homeassistant-ai/ha-mcp-integration come repository personalizzato, reinstalla il componente da lì e riavvia Home Assistant."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Riavvia Home Assistant per applicare la modifica a OAuth legacy",
|
||||
"description": "La modalità di autenticazione OAuth legacy registra propri endpoint web /authorize e /token, che Home Assistant può associare o rilasciare solo con un riavvio completo, sia che tu abbia appena attivato questa modalità, sia che l'abbia disattivata o ne abbia cambiato Client ID o Client Secret. Riavvia Home Assistant (Impostazioni - Sistema - Riavvia) per applicare la modifica; fino ad allora resta valido il comportamento precedente."
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Stabile (consigliato)",
|
||||
"dev": "Sviluppo (ultima build)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "URL webhook segreto (predefinito)",
|
||||
"ha_auth": "Accedi con Home Assistant (OAuth)",
|
||||
"legacy": "OAuth legacy (Client ID e Client Secret, per Google Gemini Spark)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "Ricerca degli strumenti (compatta, predefinita)",
|
||||
"full": "Catalogo completo",
|
||||
"both": "Entrambi (scelta per agente)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "Aggiornamento"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Accesso diretto dalla macchina Home Assistant: {url}",
|
||||
"connect_local_lan": "Locale/LAN (quando l'accesso dalla rete è «Local network»): {url}",
|
||||
"connect_remote_url": "URL di connessione remota: {url}",
|
||||
"connect_urls_label": "URL di connessione:",
|
||||
"connect_urls_pending": "Gli URL di connessione compaiono qui (e nel registro di Home Assistant) una volta avviato il server.",
|
||||
"connect_webhook_disabled": "L'accesso remoto tramite webhook è disattivato (modalità solo locale).",
|
||||
"oauth_creds_pending": "Il Client ID e il Client Secret compaiono qui una volta avviato il server.",
|
||||
"oauth_not_serving": "OAuth legacy non li sta ancora servendo — riavvia Home Assistant quando te lo chiede per attivarli.",
|
||||
"oauth_select_legacy_mode": "Imposta la modalità di autenticazione qui sopra su OAuth legacy e salva per generare un Client ID e un Client Secret.",
|
||||
"panel_hint": "Apri il [pannello impostazioni HA-MCP](/ha-mcp) per la gestione degli strumenti e le impostazioni del server.",
|
||||
"tools_module_installed": "Modulo beta/avanzato di strumenti per file e YAML (facoltativo): Installato",
|
||||
"tools_module_not_installed": "Modulo beta/avanzato di strumenti per file e YAML (facoltativo): Non installato — premi «Aggiungi voce» nella pagina di questa integrazione e scegli «HA-MCP File & YAML Tools»",
|
||||
"tools_module_not_loaded": "Modulo beta/avanzato di strumenti per file e YAML (facoltativo): Installato ma non caricato — attiva o ricarica la voce «HA-MCP File & YAML Tools» nella pagina di questa integrazione",
|
||||
"version_line": "Componente {component_version} - Server ha-mcp {server_version} (canale {channel})",
|
||||
"version_not_installed": "non ancora installato",
|
||||
"version_unknown": "sconosciuto"
|
||||
"abort": {
|
||||
"already_configured": "Questa voce è già configurata.",
|
||||
"unsupported_home_assistant": "L'in-process HA-MCP Server richiede Home Assistant {required} o superiore, ma questa istanza sta eseguendo {installed}. Puoi comunque utilizzare la voce HA-MCP File & YAML Tools di questo componente con un server ha-mcp esterno in esecuzione come app (add-on) o container Docker."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "Strumenti file e YAML di HA-MCP",
|
||||
"description": "Configura i servizi privilegiati di modifica di file e YAML usati dagli strumenti file/YAML opzionali di ha-mcp. Queste impostazioni compaiono anche nell'interfaccia delle impostazioni del server ha-mcp e si applicano subito, senza riavvio. Una soglia di divieto non aggirabile continua a bloccare i percorsi sensibili (per esempio .storage) e le chiavi del confine di fiducia (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Directory di file aggiuntive",
|
||||
"extra_yaml_keys": "Chiavi YAML scrivibili aggiuntive"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Directory relative alla directory di configurazione, ciascuna con permesso di lettura e scrittura (per esempio pyscript). I percorsi che risalgono l'albero e le voci fuori dalla configurazione vengono scartati.",
|
||||
"extra_yaml_keys": "Chiavi di primo livello che ha_config_set_yaml può scrivere oltre a quelle integrate, per le integrazioni basate su YAML di questa installazione (per esempio alert2). Le chiavi del confine di fiducia vengono scartate."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "Server HA-MCP",
|
||||
"description": "Configura il server HA-MCP. {panel_hint}Le modifiche qui vengono applicate al salvataggio.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Canale di rilascio",
|
||||
"auto_update": "Aggiornamenti automatici del server",
|
||||
"server_port": "Porta di ascolto del server MCP",
|
||||
"bind_host": "Accesso dalla rete",
|
||||
"webhook_auth": "Modalità di autenticazione",
|
||||
"oauth_client_id_override": "OAuth legacy: Client ID personalizzato (facoltativo)",
|
||||
"oauth_client_secret_override": "OAuth legacy: Client Secret personalizzato (facoltativo)",
|
||||
"oauth_regenerate": "OAuth legacy: rigenera subito Client ID e Client Secret",
|
||||
"pip_spec": "Sviluppo: pacchetto ha-mcp alternativo",
|
||||
"server_url": "URL di Home Assistant (avanzato)",
|
||||
"external_url": "URL esterno (facoltativo)",
|
||||
"webhook_id_override": "Segreto del webhook personalizzato (facoltativo)",
|
||||
"secret_path_override": "Percorso di accesso diretto personalizzato (facoltativo)",
|
||||
"regenerate_secrets": "Rigenera subito i segreti di connessione",
|
||||
"enable_webhook": "Accesso remoto tramite webhook",
|
||||
"enable_llm_api": "API LLM per gli agenti conversazionali",
|
||||
"llm_api_exposure": "Esposizione degli strumenti agli agenti conversazionali",
|
||||
"enable_startup_notification": "Notifica all'avvio",
|
||||
"enable_sidebar_panel": "Pannello impostazioni nella barra laterale"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "Stabile installa l'ultima versione stabile; Sviluppo installa la build di sviluppo più recente. Con gli aggiornamenti automatici attivi, una ricarica o un riavvio, più un controllo periodico, installano la build più recente del canale scelto. Il pacchetto alternativo di sviluppo qui sotto ha la precedenza e disattiva gli aggiornamenti automatici.",
|
||||
"auto_update": "Quando è attivo, la versione più recente del canale scelto viene installata automaticamente: a una ricarica o a un riavvio e tramite un controllo periodico. Quando è disattivo, il server resta alla versione installata finché non lo riattivi. Questo riguarda solo il pacchetto del server ha-mcp; gli aggiornamenti del componente personalizzato HA-MCP continuano ad arrivare tramite HACS.",
|
||||
"server_port": "La porta su cui questo server è in ascolto. L'app (add-on) ha-mcp utilizza la porta 9583, quindi questa è impostata per predefinita su 9584 per consentire a entrambi di funzionare fianco a fianco; se non esegui l'app (add-on), va bene qualsiasi porta libera.",
|
||||
"bind_host": "Chi può connettersi direttamente alla porta del server MCP. Il valore predefinito corrisponde all'app (add-on): raggiungibile sulla tua rete locale, con il percorso segreto come credenziale. Scegli loopback per consentire solo le connessioni dalla macchina Home Assistant stessa: l'URL del webhook e il pannello della barra laterale funzionano in entrambi i casi.",
|
||||
"webhook_auth": "Come i client MCP si autenticano all'URL del webhook. Con l'URL segreto, il link stesso è l'unica credenziale - OAuth è ancora attivo per i client che lo usano, ma ogni accesso è approvato automaticamente: non sono necessari login, ID client o Secret. Con l'accesso di Home Assistant, i client come claude.ai accedono con un account amministratore di Home Assistant (OAuth). Con OAuth legacy, questa integrazione esegue il proprio servizio di accesso e rilascia un ID client e un Secret da incollare nei client che ne richiedono uno - potrebbe essere necessario un riavvio di Home Assistant per attivarlo o disattivarlo completamente.",
|
||||
"oauth_client_id_override": "Sostituisce il Client ID OAuth legacy generato automaticamente. Lascialo vuoto per mantenere quello attuale. Viene usato solo mentre la modalità di autenticazione è impostata su OAuth legacy.",
|
||||
"oauth_client_secret_override": "Sostituisce il Client Secret OAuth legacy generato automaticamente. Lascialo vuoto per mantenere quello attuale. Viene usato solo mentre la modalità di autenticazione è impostata su OAuth legacy.",
|
||||
"oauth_regenerate": "Azione una tantum: genera un Client ID e un Client Secret nuovi per la modalità OAuth legacy. Ha effetto solo dopo il riavvio di Home Assistant che la richiesta di riparazione chiede; fino ad allora continuano a funzionare i precedenti e non i nuovi. Svuota anche i due campi di sostituzione qui sopra.",
|
||||
"pip_spec": "Lascialo vuoto. Serve solo per provare una build specifica di ha-mcp (per esempio una versione preliminare fissata); ha la precedenza sul canale di rilascio e disattiva gli aggiornamenti automatici finché non lo svuoti.",
|
||||
"server_url": "L'URL che il server nel processo usa per raggiungere il tuo Home Assistant (di solito questa stessa istanza). Lascialo vuoto per ricavarlo dalla porta e dalle impostazioni SSL di questa istanza; indica un valore solo se al server serve un percorso diverso.",
|
||||
"external_url": "Viene mostrato come URL di connessione principale: usalo quando Home Assistant sta dietro un tuo dominio o un proxy inverso. Inserisci l'indirizzo di base completo, schema incluso. Deve puntare direttamente a Home Assistant — aprendolo in un browser dovresti arrivare alla pagina di accesso di HA — e non deve contenere una porta come :8123 (né altre), altrimenti i client MCP remoti non riusciranno a raggiungerlo. Lascialo vuoto per usare automaticamente Nabu Casa o l'indirizzo locale.",
|
||||
"webhook_id_override": "Sostituisce il segreto casuale del webhook nell'URL di connessione (/api/webhook/...). L'URL è la credenziale: usa un valore lungo e difficile da indovinare. Lascialo vuoto per mantenere quello attuale.",
|
||||
"secret_path_override": "Sostituisce il percorso casuale usato per l'accesso diretto sulla porta del server. Stessa regola: il percorso è la credenziale. Lascialo vuoto per mantenere quello attuale.",
|
||||
"regenerate_secrets": "Azione una tantum: genera un nuovo segreto casuale per il webhook e un nuovo percorso di accesso diretto, invalidando subito i vecchi URL di connessione. Svuota anche i due campi di sostituzione qui sopra.",
|
||||
"enable_webhook": "Disattivalo per la modalità solo locale: il webhook di Home Assistant non viene registrato affatto, quindi nulla — Nabu Casa inclusa — può raggiungere il server attraverso Home Assistant. La porta diretta del server e il pannello nella barra laterale continuano a funzionare.",
|
||||
"enable_llm_api": "Offre l'intero set di strumenti agli agenti conversazionali di Home Assistant (OpenAI, Google, Ollama, ...): mentre è attivo, gli agenti possono selezionare «HA-MCP Server» sotto Controlla Home Assistant e usare gli strumenti dalla chat e dalla voce di Assist. Attivarlo lo rende solo selezionabile: non viene esposto nulla finché non lo scegli su un agente. Guida all'uso: {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Forma del set di strumenti offerto agli agenti conversazionali. La ricerca degli strumenti (predefinita) mantiene piccolo il contesto dell'agente: un'API compatta con strumenti fissati più meta-strumenti di ricerca ed esecuzione. Il catalogo completo elenca direttamente ogni strumento esposto, meglio per modelli con contesto ampio. Entrambi registra le due opzioni affiancate, così ogni agente sceglie la propria sotto Controlla Home Assistant. L'esposizione per singolo strumento si gestisce nel pannello impostazioni di HA-MCP; dettagli: {llm_api_docs_url}",
|
||||
"enable_startup_notification": "Mostra una notifica a ogni avvio del server, che rimanda alle superfici di impostazioni riservate agli amministratori. Disattivalo per un avvio silenzioso: gli URL di connessione restano comunque nel registro di Home Assistant.",
|
||||
"enable_sidebar_panel": "Mostra il pannello impostazioni di HA-MCP nella barra laterale (solo per gli amministratori). Disattivalo per togliere la voce dalla barra laterale: le opzioni del server restano disponibili in questa schermata."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "Il server HA-MCP nel processo non è riuscito ad avviarsi",
|
||||
"description": "Non è stato possibile avviare il server HA-MCP nel processo dentro Home Assistant:\n\n{detail}\n\nControlla i registri di Home Assistant, poi ricarica l'integrazione (o risolvi il problema di fondo e ricaricala) per riprovare."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "Non è stato possibile installare il pacchetto del server HA-MCP nel processo",
|
||||
"description": "L'installazione del pacchetto ha-mcp per il server nel processo non è riuscita:\n\n{detail}\n\nRisolvi il problema di compatibilità o di installazione descritto sopra, poi ricarica l'integrazione per riprovare."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "Aggiorna il componente personalizzato HA-MCP tramite HACS",
|
||||
"description": "Il server ha-mcp installato richiede il componente personalizzato HA-MCP {required} o successivo, ma hai {installed}. Aggiorna il componente tramite HACS (apri la voce del componente personalizzato HA-MCP e usa «Aggiorna informazioni» se non compare ancora alcun aggiornamento) e riavvia Home Assistant. Nel frattempo il server continua a funzionare, ma alcune funzioni più recenti potrebbero non funzionare finché il componente non viene aggiornato."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "Aggiornamento del server HA-MCP in attesa di un aggiornamento del componente",
|
||||
"description": "È disponibile il server ha-mcp {latest}, ma quella versione ha aggiornato anche il componente personalizzato HA-MCP (alla {shipped}; tu esegui la {running}). Per evitare di avviare una versione del server con cui il componente in uso non è mai stato provato, l'aggiornamento automatico del server resta sospeso finché il componente non viene aggiornato.\n\nAggiorna il componente tramite HACS (apri la voce del componente personalizzato HA-MCP e usa «Aggiorna informazioni» se non compare ancora alcun aggiornamento), poi riavvia Home Assistant: l'aggiornamento del server si installa automaticamente subito dopo. Per installare comunque l'aggiornamento del server, premi Installa sull'entità di aggiornamento del server HA-MCP."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Componente installato dal repository obsoleto",
|
||||
"description": "HACS sta tracciando il repository principale del server ha-mcp per questo componente, quindi HACS mostra qui i numeri di versione e le note di rilascio del server invece di quelli propri del componente (2.x). Gli aggiornamenti continuano a funzionare, ma rimangono etichettati in modo errato. Per risolvere: rimuovi questo repository da HACS (le tue impostazioni di integrazione e le voci di configurazione vengono mantenute), aggiungi homeassistant-ai/ha-mcp-integration come repository personalizzato, reinstalla il componente da esso e riavvia Home Assistant."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Riavvia Home Assistant per applicare le impostazioni OAuth legacy",
|
||||
"fix_flow": {
|
||||
"step": {
|
||||
"confirm": {
|
||||
"title": "Riavvia Home Assistant?",
|
||||
"description": "L'invio di questo modulo riavvierà Home Assistant e applicherà le impostazioni OAuth legacy.\n\nFai clic su **Invia** per riavviare ora."
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Stabile (consigliato)",
|
||||
"dev": "Sviluppo (ultima build)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "URL webhook segreto (predefinito)",
|
||||
"ha_auth": "Accedi con Home Assistant (OAuth)",
|
||||
"legacy": "OAuth legacy (questa integrazione rilascia un ID client/Secret da incollare)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "Ricerca degli strumenti (compatta, predefinita)",
|
||||
"full": "Catalogo completo",
|
||||
"both": "Entrambi (scelta per agente)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "Aggiornamento"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Accesso diretto dalla macchina Home Assistant: {url}",
|
||||
"connect_local_lan": "Locale/LAN (quando l'accesso dalla rete è «Local network»): {url}",
|
||||
"connect_remote_url": "URL di connessione remota: {url}",
|
||||
"connect_urls_label": "URL di connessione:",
|
||||
"connect_urls_pending": "Gli URL di connessione compaiono qui (e nel registro di Home Assistant) una volta avviato il server.",
|
||||
"connect_webhook_disabled": "L'accesso remoto tramite webhook è disattivato (modalità solo locale).",
|
||||
"oauth_creds_pending": "Il Client ID e il Client Secret compaiono qui una volta avviato il server.",
|
||||
"oauth_not_serving": "OAuth legacy non li sta ancora servendo — riavvia Home Assistant quando te lo chiede per attivarli.",
|
||||
"oauth_select_legacy_mode": "Imposta la modalità di autenticazione qui sopra su OAuth legacy e salva per generare un Client ID e un Client Secret.",
|
||||
"panel_hint": "Apri il [pannello impostazioni HA-MCP](/ha-mcp) per la gestione degli strumenti e le impostazioni del server.",
|
||||
"tools_module_installed": "Modulo beta/avanzato di strumenti per file e YAML (facoltativo): Installato",
|
||||
"tools_module_not_installed": "Modulo beta/avanzato di strumenti per file e YAML (facoltativo): Non installato — premi «Aggiungi voce» nella pagina di questa integrazione e scegli «HA-MCP File & YAML Tools»",
|
||||
"tools_module_not_loaded": "Modulo beta/avanzato di strumenti per file e YAML (facoltativo): Installato ma non caricato — attiva o ricarica la voce «HA-MCP File & YAML Tools» nella pagina di questa integrazione",
|
||||
"version_line": "Componente {component_version} - Server ha-mcp {server_version} (canale {channel})",
|
||||
"version_not_installed": "non ancora installato",
|
||||
"version_unknown": "sconosciuto"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,168 @@
|
||||
{
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "HA-MCP 사용자 지정 구성요소",
|
||||
"description": "추가할 항목을 선택하세요. **HA-MCP Server**는 Home Assistant 내부에 전체 ha-mcp 서버를 실행하고 Home Assistant 웹훅을 통해 노출합니다. 대부분의 사용자에게 권장되는 설치 방식입니다. 독립 실행형 서버이며 앱(애드온), Docker, uvx/PyPI, stdio 등 다른 모든 설치 방법을 완전히 대체하므로, 이 방식을 실행하는 경우 다른 방식을 함께 실행하지 마세요. **HA-MCP File & YAML Tools**에는 두 가지 역할이 있습니다. ha-mcp 서버가 Home Assistant 외부(앱, Docker, uvx/PyPI, stdio)에서 실행되는 경우, 이 항목은 외부에서 접근할 수 없는 프로세스 내 컴포넌트 기능(빠른 프로세스 내 검색, 설정 항목 메타데이터, 레지스트리 기반 읽기)을 해당 서버에 제공하므로 모든 외부 설치에 추가할 가치가 있으며, ha-mcp의 선택적 파일/YAML 도구에서 사용하는 권한 있는 파일 및 YAML 편집 서비스를 제어합니다. 대신 HA-MCP Server 항목을 추가하는 경우, 해당 항목이 이미 공유 기능을 제공하므로 이 두 번째 항목은 선택적 파일/YAML 도구의 제어 목적으로만 필요합니다. 모든 서버 유형과 호환되며 언제든지 나중에 추가할 수 있습니다.",
|
||||
"menu_options": {
|
||||
"server": "HA-MCP 서버(권장)",
|
||||
"tools": "HA-MCP 파일 및 YAML 도구(선택)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "HA-MCP 파일 및 YAML 도구",
|
||||
"description": "ha-mcp의 선택적 파일/YAML 편집 도구(기본적으로 비활성화된 기능 플래그)로 제한되는 권한 있는 파일 및 YAML 설정 서비스를 설정합니다. 이는 프로세스 내 HA-MCP Server를 포함한 모든 서버 유형에 적용됩니다. ha-mcp 서버가 Home Assistant 외부에서 실행되는 경우, 이 항목은 외부에서 접근할 수 없는 프로세스 내 컴포넌트 기능(빠른 프로세스 내 검색, 설정 항목 메타데이터, 레지스트리 기반 읽기)도 제공하므로 파일/YAML 도구가 꺼져 있는 경우에도 추가하는 것이 좋습니다. 이 항목은 언제든지 추가하거나 제거할 수 있습니다."
|
||||
},
|
||||
"server": {
|
||||
"title": "HA-MCP 서버",
|
||||
"description": "Home Assistant 안에서 전체 ha-mcp 서버를 실행하고 Home Assistant 웹훅을 통해 원격으로 노출합니다(Nabu Casa나 임의의 리버스 프록시로 접근 가능). 이는 독립 실행 서버로서 앱(애드온), 도커, uvx/PyPI, stdio 설치 방식을 완전히 대체하므로 다른 ha-mcp 서버와 함께 실행하지 마세요. **제출**을 선택하면 시작됩니다. 포트, 바인딩, 인증은 나중에 통합 구성요소 옵션에서 변경할 수 있습니다."
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "이 항목은 이미 설정되어 있습니다.",
|
||||
"unsupported_home_assistant": "프로세스 내 HA-MCP 서버는 Home Assistant {required} 이상이 필요하지만 이 인스턴스는 {installed}을(를) 실행 중입니다. 앱(애드온)이나 도커 컨테이너로 실행 중인 외부 ha-mcp 서버와 함께라면 이 구성요소의 HA-MCP 파일 및 YAML 도구 항목은 계속 사용할 수 있습니다."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "HA-MCP 파일 및 YAML 도구",
|
||||
"description": "ha-mcp의 선택형 파일/YAML 도구가 사용하는, 권한이 필요한 파일 및 YAML 편집 서비스를 구성합니다. 이 설정은 ha-mcp 서버 자체의 설정 UI에도 나타나며 다시 시작하지 않아도 즉시 적용됩니다. 재정의할 수 없는 기본 차단 규칙은 민감한 경로(예: .storage)와 신뢰 경계 키(homeassistant, http, frontend, lovelace)를 계속 차단합니다.",
|
||||
"data": {
|
||||
"allowed_dirs": "추가 파일 디렉터리",
|
||||
"extra_yaml_keys": "추가 YAML 쓰기 허용 키"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "설정 디렉터리 기준 상대 디렉터리이며 각각 읽기와 쓰기가 허용됩니다(예: pyscript). 경로 탈출과 설정 디렉터리 밖의 항목은 무시됩니다.",
|
||||
"extra_yaml_keys": "이 설치본에서 YAML 우선으로 동작하는 통합 구성요소(예: alert2)를 위해, ha_config_set_yaml이 기본 허용 키 외에 추가로 쓸 수 있는 최상위 키입니다. 신뢰 경계 키는 무시됩니다."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "HA-MCP 서버",
|
||||
"description": "HA-MCP 서버를 구성합니다. {panel_hint}여기서 변경한 내용은 저장할 때 적용됩니다.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "릴리스 채널",
|
||||
"auto_update": "서버 자동 업데이트",
|
||||
"server_port": "MCP 서버 수신 포트",
|
||||
"bind_host": "네트워크 접근 범위",
|
||||
"webhook_auth": "인증 방식",
|
||||
"oauth_client_id_override": "레거시 OAuth: 사용자 지정 클라이언트 ID(선택)",
|
||||
"oauth_client_secret_override": "레거시 OAuth: 사용자 지정 클라이언트 시크릿(선택)",
|
||||
"oauth_regenerate": "레거시 OAuth: 지금 클라이언트 ID/시크릿 재생성",
|
||||
"pip_spec": "개발자용: ha-mcp 패키지 재정의",
|
||||
"server_url": "Home Assistant URL(고급)",
|
||||
"external_url": "외부 URL(선택)",
|
||||
"webhook_id_override": "사용자 지정 웹훅 시크릿(선택)",
|
||||
"secret_path_override": "사용자 지정 직접 접속 경로(선택)",
|
||||
"regenerate_secrets": "지금 접속 시크릿 재생성",
|
||||
"enable_webhook": "웹훅을 통한 원격 접속",
|
||||
"enable_llm_api": "대화 에이전트 LLM API",
|
||||
"llm_api_exposure": "대화 에이전트 도구 노출 방식",
|
||||
"enable_startup_notification": "시작 알림",
|
||||
"enable_sidebar_panel": "사이드바 설정 패널"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "안정 채널은 최신 정식 릴리스를, 개발 채널은 최신 개발 빌드를 설치합니다. 자동 업데이트가 켜져 있으면 다시 불러오기나 재시작 때, 그리고 주기적인 확인을 통해 선택한 채널의 최신 빌드가 설치됩니다. 아래의 개발자용 패키지 재정의가 우선하며, 그 경우 자동 업데이트는 꺼집니다.",
|
||||
"auto_update": "켜면 선택한 채널의 최신 릴리스가 자동으로 설치됩니다. 다시 불러오기나 재시작 때, 그리고 주기적인 확인을 통해 설치됩니다. 끄면 다시 켤 때까지 현재 설치된 버전이 유지됩니다. 이 설정은 ha-mcp 서버 패키지에만 적용되며, HA-MCP 사용자 지정 구성요소 자체의 업데이트는 계속 HACS를 통해 이루어집니다.",
|
||||
"server_port": "이 서버가 수신할 포트입니다. ha-mcp 앱(애드온)이 9583을 사용하므로 둘을 함께 실행할 수 있도록 기본값은 9584입니다. 앱(애드온)을 실행하지 않는다면 비어 있는 아무 포트나 사용할 수 있습니다.",
|
||||
"bind_host": "MCP 서버 포트에 직접 접속할 수 있는 대상을 정합니다. 기본값은 앱(애드온)과 동일하게 로컬 네트워크에서 접근할 수 있으며, 비밀 경로가 자격 증명 역할을 합니다. 루프백을 고르면 Home Assistant가 실행 중인 머신에서만 접속할 수 있습니다. 웹훅 URL과 사이드바 패널은 어느 쪽이든 동작합니다.",
|
||||
"webhook_auth": "MCP 클라이언트가 웹훅 URL에서 자신을 증명하는 방식입니다. 비밀 URL 방식에서는 링크 자체가 유일한 자격 증명입니다. OAuth를 사용하는 클라이언트에서는 OAuth가 동작하지만 모든 로그인이 자동으로 승인되므로, 로그인도 클라이언트 ID나 시크릿도 필요 없습니다. Home Assistant 로그인 방식에서는 claude.ai 같은 클라이언트가 Home Assistant 관리자 계정으로 로그인합니다(OAuth). 레거시 OAuth 방식에서는 이 통합 구성요소가 자체 로그인 서비스를 실행하고, 클라이언트에 붙여 넣을 클라이언트 ID와 시크릿을 발급합니다. 이 방식을 완전히 켜거나 끄려면 Home Assistant를 다시 시작해야 할 수 있습니다.",
|
||||
"oauth_client_id_override": "자동 생성된 레거시 OAuth 클라이언트 ID를 대체합니다. 현재 값을 유지하려면 비워 두세요. 인증 방식이 레거시 OAuth일 때만 사용됩니다.",
|
||||
"oauth_client_secret_override": "자동 생성된 레거시 OAuth 클라이언트 시크릿을 대체합니다. 현재 값을 유지하려면 비워 두세요. 인증 방식이 레거시 OAuth일 때만 사용됩니다.",
|
||||
"oauth_regenerate": "일회성 작업입니다. 레거시 OAuth 모드용 클라이언트 ID와 시크릿을 새로 발급합니다. 복구 안내가 요청하는 Home Assistant 재시작을 마쳐야 적용되며, 재시작 전까지는 이전 클라이언트 ID와 시크릿이 계속 동작하고 새 값은 동작하지 않습니다. 위의 재정의 항목 두 개도 함께 비워집니다.",
|
||||
"pip_spec": "비워 두세요. 특정 ha-mcp 빌드를 테스트할 때(예: 사전 릴리스 고정)만 사용합니다. 릴리스 채널보다 우선하며, 값을 지울 때까지 자동 업데이트가 꺼집니다.",
|
||||
"server_url": "프로세스 내 서버가 Home Assistant(보통 이 인스턴스 자신)에 접속할 때 사용하는 URL입니다. 이 인스턴스의 포트와 SSL 설정에서 자동으로 유추하게 하려면 비워 두고, 서버가 다른 경로로 접속해야 할 때만 값을 지정하세요.",
|
||||
"external_url": "기본 접속 URL로 표시됩니다. Home Assistant가 사용자 소유 도메인이나 리버스 프록시 뒤에 있을 때 사용하세요. 스킴을 포함한 전체 기본 주소를 입력합니다. 반드시 Home Assistant를 직접 가리켜야 하며(브라우저에서 열었을 때 HA 로그인 페이지가 나와야 합니다), :8123 같은 포트(그 밖의 어떤 포트도)를 포함하면 안 됩니다. 그렇지 않으면 원격 MCP 클라이언트가 접속하지 못합니다. Nabu Casa나 로컬 주소를 자동으로 사용하려면 비워 두세요.",
|
||||
"webhook_id_override": "접속 URL(/api/webhook/...)에 들어가는 무작위 웹훅 시크릿을 대체합니다. URL 자체가 자격 증명이므로 길고 추측하기 어려운 값을 사용하세요. 현재 값을 유지하려면 비워 두세요.",
|
||||
"secret_path_override": "서버 포트로 직접 접속할 때 사용하는 무작위 경로를 대체합니다. 마찬가지로 경로 자체가 자격 증명입니다. 현재 값을 유지하려면 비워 두세요.",
|
||||
"regenerate_secrets": "일회성 작업입니다. 무작위 웹훅 시크릿과 직접 접속 경로를 새로 만들어 기존 접속 URL을 즉시 무효화합니다. 위의 재정의 항목 두 개도 함께 비워집니다.",
|
||||
"enable_webhook": "로컬 전용 모드로 쓰려면 끄세요. Home Assistant 웹훅이 아예 등록되지 않으므로 Nabu Casa를 포함해 무엇도 Home Assistant를 통해 서버에 접속할 수 없습니다. 서버 포트 직접 접속과 사이드바 패널은 계속 동작합니다.",
|
||||
"enable_llm_api": "Home Assistant 대화 에이전트(OpenAI, Google, Ollama 등)에 전체 도구 모음을 제공합니다. 켜면 에이전트의 'Home Assistant 제어' 항목에서 'HA-MCP Server'를 선택해 Assist 채팅과 음성에서 도구를 사용할 수 있습니다. 켜는 것만으로는 선택 가능해질 뿐이며, 에이전트에서 실제로 선택하기 전에는 아무것도 노출되지 않습니다. 사용 안내: {llm_api_docs_url}",
|
||||
"llm_api_exposure": "대화 에이전트에 제공할 도구 모음의 형태입니다. 도구 검색(기본값)은 고정 도구와 검색·실행 메타 도구로 이루어진 간결한 API를 제공해 에이전트의 컨텍스트를 작게 유지합니다. 전체 카탈로그는 노출된 모든 도구를 그대로 나열하며, 컨텍스트가 큰 모델에 더 적합합니다. 둘 다를 고르면 두 가지를 나란히 등록해 각 에이전트가 'Home Assistant 제어'에서 원하는 쪽을 선택할 수 있습니다. 도구별 노출 여부는 HA-MCP 설정 패널에서 관리합니다. 자세한 내용: {llm_api_docs_url}",
|
||||
"enable_startup_notification": "서버가 시작될 때마다 관리자 전용 설정 화면을 안내하는 알림을 표시합니다. 조용히 시작하려면 끄세요. 접속 URL은 Home Assistant 로그에 계속 표시됩니다.",
|
||||
"enable_sidebar_panel": "사이드바에 HA-MCP 설정 패널을 표시합니다(관리자 전용). 사이드바 항목을 없애려면 끄세요. 서버 옵션은 이 화면에서 계속 사용할 수 있습니다."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "HA-MCP 프로세스 내 서버를 시작하지 못했습니다",
|
||||
"description": "Home Assistant 안에서 HA-MCP 프로세스 내 서버를 시작하지 못했습니다:\n\n{detail}\n\nHome Assistant 로그를 확인한 뒤 통합 구성요소를 다시 불러와(또는 근본 원인을 해결한 뒤 다시 불러와) 재시도하세요."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "HA-MCP 프로세스 내 서버 패키지를 설치하지 못했습니다",
|
||||
"description": "프로세스 내 서버용 ha-mcp 패키지 설치에 실패했습니다:\n\n{detail}\n\n위에 설명된 호환성 또는 설치 문제를 해결한 뒤 통합 구성요소를 다시 불러와 재시도하세요."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "HACS에서 HA-MCP 사용자 지정 구성요소를 업데이트하세요",
|
||||
"description": "설치된 ha-mcp 서버는 HA-MCP 사용자 지정 구성요소 {required} 이상을 요구하지만 현재 {installed}을(를) 사용 중입니다. HACS에서 구성요소를 업데이트한 뒤(HA-MCP 사용자 지정 구성요소 항목을 열고 업데이트가 아직 보이지 않으면 '정보 업데이트'를 사용하세요) Home Assistant를 다시 시작하세요. 그동안에도 서버는 계속 동작하지만, 구성요소를 업데이트하기 전까지 일부 최신 기능이 동작하지 않을 수 있습니다."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "HA-MCP 서버 업데이트가 구성요소 업데이트를 기다리는 중입니다",
|
||||
"description": "ha-mcp 서버 {latest}을(를) 사용할 수 있지만, 해당 릴리스는 HA-MCP 사용자 지정 구성요소도 함께 업데이트했습니다(구성요소 {shipped} 기준, 현재 {running} 사용 중). 현재 구성요소로 한 번도 검증되지 않은 서버 버전이 시작되는 것을 막기 위해, 구성요소가 업데이트될 때까지 서버 자동 업데이트를 보류합니다.\n\nHACS에서 구성요소를 업데이트한 뒤(HA-MCP 사용자 지정 구성요소 항목을 열고 업데이트가 아직 보이지 않으면 '정보 업데이트'를 사용하세요) Home Assistant를 다시 시작하면 서버 업데이트가 자동으로 설치됩니다. 그래도 서버 업데이트를 지금 설치하려면 HA-MCP 서버 업데이트 엔티티에서 설치를 누르세요."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "구성요소가 이전 저장소에서 설치되었습니다",
|
||||
"description": "HACS가 이 구성요소에 대해 ha-mcp 서버 본체 저장소를 추적하고 있어, 구성요소 자체의 버전(2.x)이 아니라 서버의 버전 번호와 릴리스 노트가 표시됩니다. 업데이트는 계속 동작하지만 표기는 계속 어긋납니다. 해결하려면 HACS에서 이 저장소를 제거하고(통합 구성요소 설정과 설정 항목은 유지됩니다), homeassistant-ai/ha-mcp-integration을 사용자 지정 저장소로 추가한 뒤 거기에서 구성요소를 다시 설치하고 Home Assistant를 다시 시작하세요."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "레거시 OAuth 설정을 적용하려면 Home Assistant를 다시 시작하세요",
|
||||
"fix_flow": {
|
||||
"step": {
|
||||
"confirm": {
|
||||
"title": "Home Assistant를 다시 시작할까요?",
|
||||
"description": "이 양식을 제출하면 Home Assistant가 다시 시작되고 레거시 OAuth 설정이 적용됩니다.\n\n지금 다시 시작하려면 **제출**을 누르세요."
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "안정(권장)",
|
||||
"dev": "개발(최신 빌드)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "비밀 웹훅 URL(기본값)",
|
||||
"ha_auth": "Home Assistant로 로그인(OAuth)",
|
||||
"legacy": "레거시 OAuth(이 통합 구성요소가 붙여 넣을 클라이언트 ID/시크릿을 발급)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "도구 검색(간결, 기본값)",
|
||||
"full": "전체 카탈로그",
|
||||
"both": "둘 다(에이전트별로 선택)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "업데이트"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Home Assistant 머신에서 직접 접속: {url}",
|
||||
"connect_local_lan": "로컬/LAN(네트워크 접근 범위가 \"Local network\"일 때): {url}",
|
||||
"connect_remote_url": "원격 접속 URL: {url}",
|
||||
"connect_urls_label": "접속 URL:",
|
||||
"connect_urls_pending": "서버가 시작되면 접속 URL이 여기(그리고 Home Assistant 로그)에 표시됩니다.",
|
||||
"connect_webhook_disabled": "웹훅을 통한 원격 접속이 꺼져 있습니다(로컬 전용 모드).",
|
||||
"oauth_creds_pending": "서버가 시작되면 클라이언트 ID와 클라이언트 시크릿이 여기에 표시됩니다.",
|
||||
"oauth_not_serving": "레거시 OAuth가 아직 이 값들을 제공하지 않습니다 — 안내가 나오면 Home Assistant를 다시 시작해 활성화하세요.",
|
||||
"oauth_select_legacy_mode": "위에서 인증 방식을 레거시 OAuth로 설정하고 저장하면 클라이언트 ID와 클라이언트 시크릿이 생성됩니다.",
|
||||
"panel_hint": "도구 관리와 서버 설정은 [HA-MCP 설정 패널](/ha-mcp)에서 할 수 있습니다.",
|
||||
"tools_module_installed": "베타/고급 파일 및 YAML 도구 모듈(선택): 설치됨",
|
||||
"tools_module_not_installed": "베타/고급 파일 및 YAML 도구 모듈(선택): 설치되지 않음 — 이 통합 구성요소 페이지에서 \"항목 추가\"를 누르고 \"HA-MCP 파일 및 YAML 도구(HA-MCP File & YAML Tools)\"를 선택해 추가하세요",
|
||||
"tools_module_not_loaded": "베타/고급 파일 및 YAML 도구 모듈(선택): 설치되었지만 불러오지 않음 — 이 통합 구성요소 페이지에서 \"HA-MCP 파일 및 YAML 도구(HA-MCP File & YAML Tools)\" 항목을 활성화하거나 다시 불러오세요",
|
||||
"version_line": "구성요소 {component_version} - 서버 ha-mcp {server_version}({channel} 채널)",
|
||||
"version_not_installed": "아직 설치되지 않음",
|
||||
"version_unknown": "알 수 없음"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,168 @@
|
||||
{
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "HA-MCP Aangepaste Component",
|
||||
"description": "Kies wat je wilt toevoegen. **HA-MCP Server** draait de volledige ha-mcp server binnen Home Assistant en stelt deze beschikbaar via een Home Assistant webhook - dit is de installatie die de meeste mensen willen. Het is een standalone server en een volledige vervanging voor elke andere installatiemethode: App (add-on), Docker, uvx/PyPI, stdio; als je deze uitvoert, draai dan niet tegelijkertijd een van de andere. **HA-MCP File & YAML Tools** heeft twee rollen. Als je ha-mcp server buiten Home Assistant draait - app, Docker, uvx/PyPI, stdio - geeft deze vermelding die server ook de in-process componentmogelijkheden die deze van buitenaf niet kan bereiken (snelle in-process zoekopdrachten, config entry metadata, op registers gebaseerde leesbewerkingen), dus het is de moeite waard om toe te voegen aan elke externe installatie, en het fungeert als poortwachter voor de bevoorrechte file- en YAML-bewerkingsservices die worden gebruikt door de optionele file/YAML-tools van ha-mcp. Als je in plaats daarvan de HA-MCP Server-vermelding toevoegt, biedt die vermelding al deze gedeelde mogelijkeheden, dus deze tweede vermelding is dan alleen nodig als poortwachter voor de optionele file/YAML-tools. Het werkt met elk servertype en kan op elk moment later worden toegevoegd.",
|
||||
"menu_options": {
|
||||
"server": "HA-MCP Server (aanbevolen)",
|
||||
"tools": "HA-MCP Bestands- & YAML-hulpmiddelen (optioneel)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "HA-MCP Bestands- & YAML-hulpmiddelen",
|
||||
"description": "Stelt de bevoorrechte file- en YAML-configuratieservices in, die afgeschermd blijven achter de optionele file/YAML-bewerkingstools van ha-mcp (feature flags, standaard uitgeschakeld) - dit geldt voor elk servertype, inclusief de in-process HA-MCP Server. Als je ha-mcp server buiten Home Assistant draait, geeft deze vermelding de server ook de in-process componentmogelijkheden die deze van buitenaf niet kan bereiken (snelle in-process zoekopdrachten, config entry metadata, op registers gebaseerde leesbewerkingen), die de moeite waard zijn om te hebben, zelfs als de file/YAML-tools zijn uitgeschakeld. Je kunt deze vermelding op elk moment toevoegen of verwijderen."
|
||||
},
|
||||
"server": {
|
||||
"title": "HA-MCP Server",
|
||||
"description": "Hiermee draait de volledige ha-mcp server binnen Home Assistant en wordt deze op afstand beschikbaar gesteld via een Home Assistant webhook (bereikbaar via Nabu Casa of een omgekeerde proxy / reverse proxy). Het is een standalone server en een volledige vervanging voor de app (add-on)-, Docker-, uvx/PyPI- en stdio-installatiemethoden - draai deze niet tegelijkertijd met een andere ha-mcp server. Selecteer **Verzenden** om te starten; je kunt de poort, binding en authenticatie achteraf wijzigen in de integratie-opties."
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "Deze ingang is al ingesteld.",
|
||||
"unsupported_home_assistant": "De in-process HA-MCP Server vereist Home Assistant {required} of nieuwer, maar deze instantie draait {installed}. Je kunt nog steeds de HA-MCP File & YAML Tools-invoer van dit component gebruiken met een externe ha-mcp-server die als app (add-on) of Docker-container draait."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "HA-MCP Bestands- & YAML-hulpmiddelen",
|
||||
"description": "Configureer de geprivilegieerde bestands- en YAML-bewerkingsservices die worden gebruikt door de opt-in bestands-/YAML-hulpmiddelen van ha-mcp. Deze instellingen verschijnen ook in de eigen instellingen-UI van de ha-mcp server en worden direct toegepast, zonder herstart. Een niet-overbrugbare blokkade weigert nog steeds gevoelige paden (bijv. .storage) en trust-boundary sleutels (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Extra bestandsmappen",
|
||||
"extra_yaml_keys": "Extra YAML-schrijfsleutels"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Mappen relatief aan de configuratiemap, elk met lees- en schrijfrechten (bijv. pyscript). Traversale en buiten-configuratie ingangen worden genegeerd.",
|
||||
"extra_yaml_keys": "Top-level sleutels die ha_config_set_yaml mag schrijven naast de ingebouwde, voor YAML-first integraties op deze installatie (bijv. alert2). Trust-boundary sleutels worden genegeerd."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "HA-MCP Server",
|
||||
"description": "Configureer de HA-MCP server. {panel_hint}Wijzigingen hier worden toegepast bij opslaan.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Releasekanaal",
|
||||
"auto_update": "Automatische serverupdates",
|
||||
"server_port": "Luisterpoort MCP server",
|
||||
"bind_host": "Netwerktoegang",
|
||||
"webhook_auth": "Authenticatiemodus",
|
||||
"oauth_client_id_override": "Legacy OAuth: aangepaste Client ID (optioneel)",
|
||||
"oauth_client_secret_override": "Legacy OAuth: aangepaste Client Secret (optioneel)",
|
||||
"oauth_regenerate": "Legacy OAuth: genereer nu Client ID/Secret opnieuw",
|
||||
"pip_spec": "Ontwikkelaar: ha-mcp pakketoverheersing",
|
||||
"server_url": "Home Assistant URL (geavanceerd)",
|
||||
"external_url": "Externe URL (optioneel)",
|
||||
"webhook_id_override": "Aangepast webhook geheim (optioneel)",
|
||||
"secret_path_override": "Aangepast direct-toegangspad (optioneel)",
|
||||
"regenerate_secrets": "Genereer verbindingsgeheimen nu opnieuw",
|
||||
"enable_webhook": "Toegang op afstand via webhook",
|
||||
"enable_llm_api": "Conversatie-agent LLM API",
|
||||
"llm_api_exposure": "Blootstelling van conversatie-agent hulpmiddelen",
|
||||
"enable_startup_notification": "Opstartmelding",
|
||||
"enable_sidebar_panel": "Zijbalk instellingenpaneel"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "Stabiel installeert de nieuwste stabiele release; Ontwikkeling installeert de nieuwste ontwikkelingsbuild. Wanneer automatische updates zijn ingeschakeld, installeert een herlaadbeurt of herstart, plus een periodieke controle, de nieuwste build van het geselecteerde kanaal. Een ontwikkelaarspakket overschrijving hieronder heeft voorrang en schakelt automatische updates uit.",
|
||||
"auto_update": "Wanneer ingeschakeld, wordt de nieuwste release van het geselecteerde kanaal automatisch geïnstalleerd - bij een herlaadbeurt of herstart, en via een periodieke controle. Wanneer uitgeschakeld, blijft de server op de momenteel geïnstalleerde versie totdat je dit weer inschakelt. Dit beheert alleen het ha-mcp serverpakket; updates voor de HA-MCP Aangepaste Component zelf komen nog steeds via HACS.",
|
||||
"server_port": "De poort waarop deze server luistert. De ha-mcp app (add-on) gebruikt 9583, dus de standaardwaarde is 9584 zodat beide naast elkaar kunnen draaien - als je de app (add-on) niet gebruikt, werkt elke vrije poort.",
|
||||
"bind_host": "Wie er rechtstreeks verbinding kan maken met de MCP-serverpoort. De standaardwaarde komt overeen met de app (add-on): bereikbaar op je lokale netwerk, met het geheime pad als inloggegeven. Kies loopback om alleen verbindingen toe te staan vanaf de Home Assistant-machine zelf - de webhook-URL en het zijbalkpaneel werken in beide gevallen.",
|
||||
"webhook_auth": "Hoe MCP-clients zich bewijzen bij de webhook-URL. Met de geheime URL is de link zelf de enige referentie - OAuth draait nog steeds voor clients die het gebruiken, maar elke aanmelding wordt automatisch goedgekeurd: geen login en geen Client ID of Secret nodig. Met Home Assistant-aanmelding loggen clients zoals claude.ai in met een Home Assistant-beheerdersaccount (OAuth). Met legacy OAuth draait deze integratie zijn eigen aanmeldingsservice en geeft een Client ID en Secret uit om te plakken in clients die er een nodig hebben - een herstart van Home Assistant kan nodig zijn om het volledig in of uit te schakelen.",
|
||||
"oauth_client_id_override": "Vervangt de automatisch gegenereerde legacy OAuth Client ID. Laat leeg om de huidige te behouden. Alleen gebruikt wanneer Authenticatiemodus is ingesteld op legacy OAuth.",
|
||||
"oauth_client_secret_override": "Vervangt de automatisch gegenereerde legacy OAuth Client Secret. Laat leeg om de huidige te behouden. Alleen gebruikt wanneer Authenticatiemodus is ingesteld op legacy OAuth.",
|
||||
"oauth_regenerate": "Eenmalige actie: genereert een nieuwe Client ID en Secret voor legacy OAuth-modus. Het wordt pas van kracht na de Home Assistant herstart waar de reparatieprompt om vraagt - totdat je herstart, blijven de vorige Client ID en Secret werken en de nieuwe niet. Maakt ook de twee overschrijvingsvelden hierboven leeg.",
|
||||
"pip_spec": "Laat leeg. Alleen voor het testen van een specifieke ha-mcp build (bijvoorbeeld een pre-release pin); overschrijft het releasekanaal en schakelt automatische updates uit totdat het leeg is gemaakt.",
|
||||
"server_url": "De URL die de in-process server gebruikt om je Home Assistant te bereiken (meestal deze instantie zelf). Laat leeg om het af te leiden van de poort- en SSL-instellingen van deze instantie; stel alleen een waarde in wanneer de server een andere route nodig heeft.",
|
||||
"external_url": "Weergegeven als de primaire verbindings-URL - gebruik dit wanneer Home Assistant achter je eigen domein of reverse proxy zit. Voer het volledige basisadres in, inclusief het schema. Het moet direct naar Home Assistant wijzen - het openen in een browser zou je HA-inlogpagina moeten bereiken - en mag geen poort bevatten zoals :8123 (of enige andere poort), anders kunnen externe MCP-clients het niet bereiken. Laat leeg om Nabu Casa / het lokale adres automatisch te gebruiken.",
|
||||
"webhook_id_override": "Vervangt het willekeurige webhook-geheim in de verbindings-URL (/api/webhook/...). De URL is de referentie - gebruik een lange, moeilijk te raden waarde. Laat leeg om de huidige te behouden.",
|
||||
"secret_path_override": "Vervangt het willekeurige pad dat wordt gebruikt voor directe toegang op de serverpoort. Dezelfde regel: het pad is de referentie. Laat leeg om de huidige te behouden.",
|
||||
"regenerate_secrets": "Eenmalige actie: genereert een nieuw willekeurig webhook-geheim en direct-toegangspad, waardoor de oude verbindings-URL's onmiddellijk ongeldig worden. Maakt ook de twee bovenstaande overschrijvingsvelden leeg.",
|
||||
"enable_webhook": "Schakel uit voor de lokale-modus: de Home Assistant-webhook wordt helemaal niet geregistreerd, dus niets - inclusief Nabu Casa - kan de server via Home Assistant bereiken. De directe serverpoort en het zijbalkpaneel blijven werken.",
|
||||
"enable_llm_api": "Bied de volledige toolset aan Home Assistant conversatie-agents (OpenAI, Google, Ollama, ...): wanneer ingeschakeld, kunnen agents 'HA-MCP Server' selecteren onder Home Assistant bedienen en de tools aansturen vanuit Assist chat en spraak. Inschakelen maakt het alleen selecteerbaar - niets wordt blootgesteld totdat je het kiest op een agent. Gebruikershandleiding: {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Vorm van de toolset die wordt aangeboden aan conversatie-agents. Tool zoeken (standaard) houdt de context van de agent klein: een compacte API met vastgezette tools plus zoek-/uitvoer meta-tools. Volledige catalogus toont elke blootgestelde tool direct - beter voor modellen met een grote context. Beide registreert de twee naast elkaar, zodat elke agent zijn eigen kiest onder Home Assistant bedienen. Blootstelling per tool wordt beheerd in het HA-MCP instellingenpaneel; details: {llm_api_docs_url}",
|
||||
"enable_startup_notification": "Toon een melding elke keer dat de server start, verwijzend naar de instellingenpagina's die alleen voor beheerders zijn. Schakel uit om stil te starten - de verbindings-URL's verschijnen nog steeds in het Home Assistant-logboek.",
|
||||
"enable_sidebar_panel": "Toon het HA-MCP instellingenpaneel in de zijbalk (alleen beheerders). Schakel uit om de zijbalkvermelding te verwijderen - serveropties blijven beschikbaar op dit scherm."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "De HA-MCP in-process server kon niet starten",
|
||||
"description": "De HA-MCP in-process server kon niet worden gestart binnen Home Assistant:\n\n{detail}\n\nControleer de Home Assistant-logboeken en herlaad vervolgens de integratie (of los het onderliggende probleem op en herlaad) om opnieuw te proberen."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "Het HA-MCP in-process serverpakket kon niet worden geïnstalleerd",
|
||||
"description": "Het installeren van het ha-mcp pakket voor de in-process server is mislukt:\n\n{detail}\n\nLos het hierboven beschreven compatibiliteits- of installatieprobleem op en herlaad vervolgens de integratie om opnieuw te proberen."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "Update de HA-MCP Custom Component via HACS",
|
||||
"description": "De geïnstalleerde ha-mcp server vereist HA-MCP Custom Component {required} of nieuwer, maar je hebt {installed}. Update de component via HACS (open de HA-MCP Custom Component-vermelding en gebruik 'Update informatie' als er nog geen update wordt getoond) en herstart Home Assistant. De server blijft ondertussen draaien, maar sommige nieuwere functies werken mogelijk niet totdat de component is bijgewerkt."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "HA-MCP serverupdate wacht op een componentupdate",
|
||||
"description": "ha-mcp server {latest} is beschikbaar, maar die release heeft ook de HA-MCP Custom Component bijgewerkt (naar {shipped}; je draait {running}). Om te voorkomen dat een serverversie wordt gestart waarmee de draaiende component nog nooit is getest, wordt de automatische serverupdate uitgesteld totdat de component is bijgewerkt.\n\nUpdate de component via HACS (open de HA-MCP Custom Component-vermelding en gebruik 'Update informatie' als er nog geen update wordt getoond) en herstart vervolgens Home Assistant - de serverupdate wordt daarna automatisch geïnstalleerd. Om de serverupdate toch te installeren, druk je op Installeren op de HA-MCP serverupdate-entiteit."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Component geïnstalleerd vanuit de verouderde repository",
|
||||
"description": "HACS volgt de hoofdrepository van de ha-mcp-server voor dit component, dus HACS toont hier de versienummers en releasenotes van de server in plaats van die van het component zelf (2.x). Updates blijven werken, maar blijven op deze manier verkeerd gelabeld. Om dit te verhelpen: verwijder deze repository uit HACS (je integratie-instellingen en configuratie-items blijven behouden), voeg homeassistant-ai/ha-mcp-integration toe als een aangepaste repository, installeer het component opnieuw hiervandaan, en herstart Home Assistant."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Herstart Home Assistant om de legacy OAuth-instellingen toe te passen",
|
||||
"fix_flow": {
|
||||
"step": {
|
||||
"confirm": {
|
||||
"title": "Home Assistant opnieuw opstarten?",
|
||||
"description": "Het indienen van dit formulier zal Home Assistant opnieuw opstarten en de legacy OAuth-instellingen toepassen.\n\nKlik op <strong>Verzenden</strong> om nu opnieuw op te starten."
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Stabiel (aanbevolen)",
|
||||
"dev": "Ontwikkeling (laatste build)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "Geheime webhook-URL (standaard)",
|
||||
"ha_auth": "Aanmelden met Home Assistant (OAuth)",
|
||||
"legacy": "Legacy OAuth (deze integratie geeft een Client ID/Secret uit om te plakken)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "Tool zoeken (compact, standaard)",
|
||||
"full": "Volledige catalogus",
|
||||
"both": "Beide (kies per agent)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "Update"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Directe toegang vanaf de Home Assistant-machine: {url}",
|
||||
"connect_local_lan": "Lokaal/LAN (wanneer Netwerktoegang \"Local network\" is): {url}",
|
||||
"connect_remote_url": "Verbindings-URL op afstand: {url}",
|
||||
"connect_urls_label": "Verbindings-URL('s):",
|
||||
"connect_urls_pending": "De verbindings-URL's verschijnen hier (en in het Home Assistant-logboek) zodra de server is gestart.",
|
||||
"connect_webhook_disabled": "Toegang op afstand via webhook is uitgeschakeld (alleen-lokale modus).",
|
||||
"oauth_creds_pending": "De Client ID en Client Secret verschijnen hier zodra de server is gestart.",
|
||||
"oauth_not_serving": "Legacy OAuth levert deze nog niet — start Home Assistant opnieuw op wanneer je daarom wordt gevraagd, om ze te activeren.",
|
||||
"oauth_select_legacy_mode": "Stel de authenticatiemodus hierboven in op legacy OAuth en sla op om een Client ID en Client Secret te genereren.",
|
||||
"panel_hint": "Open het [HA-MCP instellingenpaneel](/ha-mcp) voor toolbeheer en serverinstellingen.",
|
||||
"tools_module_installed": "Bèta/geavanceerde bestands- & YAML-tools module (optioneel): Geïnstalleerd",
|
||||
"tools_module_not_installed": "Bèta/geavanceerde bestands- & YAML-tools module (optioneel): Niet geïnstalleerd — druk op \"Item toevoegen\" op de pagina van deze integratie en kies \"HA-MCP File & YAML Tools\" om deze toe te voegen",
|
||||
"tools_module_not_loaded": "Bèta/geavanceerde bestands- & YAML-tools module (optioneel): Geïnstalleerd maar niet geladen — schakel het \"HA-MCP File & YAML Tools\" item op de pagina van deze integratie in of herlaad het",
|
||||
"version_line": "Component {component_version} - Server ha-mcp {server_version} ({channel} kanaal)",
|
||||
"version_not_installed": "nog niet geïnstalleerd",
|
||||
"version_unknown": "onbekend"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,168 @@
|
||||
{
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "Niestandardowy komponent HA-MCP",
|
||||
"description": "Wybierz, co chcesz dodać. **HA-MCP Server** uruchamia pełny serwer ha-mcp wewnątrz Home Assistanta i udostępnia go za pomocą webhooka Home Assistanta – jest to instalacja, której wybiera większość osób. Jest to samodzielny serwer i kompletny zamiennik każdej innej metody instalacji: aplikacji (dodatku), Dockera, uvx/PyPI, stdio; jeśli go uruchamiasz, nie uruchamiaj równocześnie żadnej z nich. **HA-MCP File & YAML Tools** pełni dwie role. Jeśli Twój serwer ha-mcp działa poza Home Assistantem – w aplikacji, Dockerze, uvx/PyPI, stdio – ten wpis zapewnia również temu serwerowi możliwości komponentu w procesie, do których nie ma dostępu z zewnątrz (szybkie wyszukiwanie w procesie, metadane wpisów konfiguracji, odczyty oparte na rejestrze), więc warto go dodać do każdej zewnętrznej instalacji, a także stanowi on bramkę dla uprzywilejowanych usług edycji plików i YAML, używanych przez opcjonalne narzędzia plików/YAML w ha-mcp. Jeśli zamiast tego dodasz wpis HA-MCP Server, zapewnia on już te współdzielone możliwości, więc ten drugi wpis jest wtedy potrzebny tylko jako bramka dla opcjonalnych narzędzi plików/YAML. Działa z każdym typem serwera i można go dodać później w dowolnym momencie.",
|
||||
"menu_options": {
|
||||
"server": "Serwer HA-MCP (zalecane)",
|
||||
"tools": "Narzędzia plików i YAML HA-MCP (opcjonalne)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "Narzędzia plików i YAML HA-MCP",
|
||||
"description": "Konfiguruje uprzywilejowane usługi edycji plików i konfiguracji YAML, które pozostają zabezpieczone za opcjonalnymi narzędziami edycji plików/YAML ha-mcp (flagi funkcji, domyślnie wyłączone) – dotyczy to każdego typu serwera, w tym serwera HA-MCP Server działającego w procesie. Jeśli Twój serwer ha-mcp działa poza Home Assistantem, ten wpis zapewnia mu również możliwości komponentu w procesie, do których nie ma dostępu z zewnątrz (szybkie wyszukiwanie w procesie, metadane wpisów konfiguracji, odczyty oparte na rejestrze), które warto mieć nawet przy wyłączonych narzędziach plików/YAML. Możesz dodać lub usunąć ten wpis w dowolnym momencie."
|
||||
},
|
||||
"server": {
|
||||
"title": "Serwer HA-MCP",
|
||||
"description": "Uruchamia to pełny serwer ha-mcp wewnątrz Home Assistanta i udostępnia go zdalnie za pomocą webhooka Home Assistanta (dostępnego przez Nabu Casa lub dowolne proxy odwrotne). Jest to samodzielny serwer i kompletny zamiennik metod instalacji takich jak aplikacja (dodatek), Docker, uvx/PyPI oraz stdio – nie uruchamiaj go obok innego serwera ha-mcp. Wybierz **Wyślij**, aby go uruchomić; port, powiązanie i uwierzytelnianie możesz zmienić później w opcjach integracji."
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "Ten wpis jest już skonfigurowany.",
|
||||
"unsupported_home_assistant": "Wbudowany HA-MCP Server wymaga Home Assistanta w wersji {required} lub nowszej, ale ta instancja uruchomiona jest w wersji {installed}. Nadal możesz używać wpisu HA-MCP File & YAML Tools tego komponentu z zewnętrznym serwerem ha-mcp działającym jako aplikacja (dodatek) lub kontener Docker."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "Narzędzia plików i YAML HA-MCP",
|
||||
"description": "Skonfiguruj uprzywilejowane usługi edycji plików i YAML używane przez opcjonalne narzędzia plików/YAML ha-mcp. Te ustawienia pojawiają się również w interfejsie ustawień serwera ha-mcp i są stosowane na żywo, bez restartu. Nienadpisywalna blokada nadal blokuje wrażliwe ścieżki (np. .storage) i klucze graniczne zaufania (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Dodatkowe katalogi plików",
|
||||
"extra_yaml_keys": "Dodatkowe klucze zapisu YAML"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Katalogi względem katalogu konfiguracyjnego, każdy z uprawnieniami do odczytu i zapisu (np. pyscript). Wpisy poza konfiguracją i przechodzenie przez katalogi są odrzucane.",
|
||||
"extra_yaml_keys": "Klucze najwyższego poziomu, które ha_config_set_yaml może zapisywać oprócz wbudowanych, dla integracji opartych na YAML w tej instalacji (np. alert2). Klucze graniczne zaufania są odrzucane."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "Serwer HA-MCP",
|
||||
"description": "Skonfiguruj serwer HA-MCP. {panel_hint}Zmiany są stosowane po zapisaniu.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Kanał wydania",
|
||||
"auto_update": "Automatyczne aktualizacje serwera",
|
||||
"server_port": "Port nasłuchu serwera MCP",
|
||||
"bind_host": "Dostęp sieciowy",
|
||||
"webhook_auth": "Tryb uwierzytelniania",
|
||||
"oauth_client_id_override": "Legacy OAuth: niestandardowy Client ID (opcjonalnie)",
|
||||
"oauth_client_secret_override": "Legacy OAuth: niestandardowy Client Secret (opcjonalnie)",
|
||||
"oauth_regenerate": "Legacy OAuth: wygeneruj ponownie Client ID/Secret teraz",
|
||||
"pip_spec": "Deweloper: nadpisanie pakietu ha-mcp",
|
||||
"server_url": "URL Home Assistanta (zaawansowane)",
|
||||
"external_url": "Zewnętrzny URL (opcjonalnie)",
|
||||
"webhook_id_override": "Niestandardowy sekret webhooka (opcjonalnie)",
|
||||
"secret_path_override": "Niestandardowa ścieżka bezpośredniego dostępu (opcjonalnie)",
|
||||
"regenerate_secrets": "Wygeneruj ponownie sekrety połączenia teraz",
|
||||
"enable_webhook": "Zdalny dostęp przez webhook",
|
||||
"enable_llm_api": "API LLM agenta konwersacyjnego",
|
||||
"llm_api_exposure": "Udostępnianie narzędzi agenta konwersacyjnego",
|
||||
"enable_startup_notification": "Powiadomienie o uruchomieniu",
|
||||
"enable_sidebar_panel": "Panel ustawień paska bocznego"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "„Stable” instaluje najnowszą stabilną wersję; „Development” instaluje najnowszą wersję rozwojową. Gdy automatyczne aktualizacje są włączone, przeładowanie lub restart, a także okresowe sprawdzanie, instalują najnowszą kompilację wybranego kanału. Nadpisanie pakietu deweloperskiego poniżej ma pierwszeństwo i wyłącza automatyczne aktualizacje.",
|
||||
"auto_update": "Gdy włączone, najnowsza wersja wybranego kanału jest instalowana automatycznie – podczas przeładowania lub restartu oraz poprzez okresowe sprawdzanie. Gdy wyłączone, serwer pozostaje na aktualnie zainstalowanej wersji, dopóki nie włączysz tej opcji ponownie. Kontroluje to tylko pakiet serwera ha-mcp; aktualizacje samego niestandardowego komponentu HA-MCP nadal pochodzą z HACS.",
|
||||
"server_port": "Port, na którym nasłuchuje ten serwer. Aplikacja (dodatek) ha-mcp używa portu 9583, więc domyślnie ustawiono 9584, aby umożliwić działanie obu obok siebie – jeśli nie używasz aplikacji (dodatku), odpowiedni będzie dowolny wolny port.",
|
||||
"bind_host": "Określa, kto może łączyć się bezpośrednio z portem serwera MCP. Wartość domyślna odpowiada aplikacji (dodatkowi): osiągalny w Twojej sieci lokalnej, przy czym tajna ścieżka służy jako poświadczenie. Wybierz loopback, aby zezwolić na połączenia wyłącznie z samej maszyny Home Assistanta – adres URL webhooka oraz panel na pasku bocznym działają w obu przypadkach.",
|
||||
"webhook_auth": "Jak klienci MCP uwierzytelniają się pod adresem URL webhooka. Z tajnym adresem URL, sam link jest jedynym poświadczeniem – OAuth nadal działa dla klientów, którzy go używają, ale każde logowanie jest zatwierdzane automatycznie: nie jest potrzebne logowanie ani Client ID czy Secret. Przy logowaniu przez Home Assistant, klienci tacy jak claude.ai logują się za pomocą konta administratora Home Assistant (OAuth). Przy Legacy OAuth, ta integracja uruchamia własną usługę logowania i wydaje Client ID oraz Secret do wklejenia do klientów, którzy tego wymagają – może być potrzebny restart Home Assistanta, aby w pełni włączyć lub wyłączyć tę funkcję.",
|
||||
"oauth_client_id_override": "Zastępuje automatycznie wygenerowany Client ID legacy OAuth. Pozostaw puste, aby zachować obecny. Używane tylko, gdy tryb uwierzytelniania jest ustawiony na legacy OAuth.",
|
||||
"oauth_client_secret_override": "Zastępuje automatycznie wygenerowany Client Secret legacy OAuth. Pozostaw puste, aby zachować obecny. Używane tylko, gdy tryb uwierzytelniania jest ustawiony na legacy OAuth.",
|
||||
"oauth_regenerate": "Jednorazowa akcja: generuje nowe Client ID i Secret dla trybu legacy OAuth. Wchodzi w życie dopiero po restarcie Home Assistanta, o który prosi monit naprawy – dopóki nie zrestartujesz, poprzednie Client ID i Secret nadal działają, a nowe nie. Czyści również dwa powyższe pola nadpisania.",
|
||||
"pip_spec": "Pozostaw puste. Tylko do testowania konkretnej kompilacji ha-mcp (na przykład przypiętej wersji przedpremierowej); nadpisuje kanał wydania i wyłącza automatyczne aktualizacje, dopóki nie zostanie wyczyszczone.",
|
||||
"server_url": "URL, którego serwer działający w procesie używa do dotarcia do Twojego Home Assistanta (zazwyczaj tej samej instancji). Pozostaw puste, aby wyprowadzić go z portu i ustawień SSL tej instancji; ustaw wartość tylko wtedy, gdy serwer potrzebuje innej trasy.",
|
||||
"external_url": "Wyświetlany jako główny URL połączenia — użyj go, gdy Home Assistant znajduje się za Twoją własną domeną lub odwrotnym proxy. Wprowadź pełny adres bazowy, włączając schemat. Musi wskazywać bezpośrednio na Home Assistant – otwarcie go w przeglądarce powinno prowadzić do strony logowania HA – i nie może zawierać portu, takiego jak :8123 (ani żadnego innego portu), w przeciwnym razie zdalne klienty MCP nie będą mogły się z nim połączyć. Pozostaw puste, aby automatycznie użyć Nabu Casa / adresu lokalnego.",
|
||||
"webhook_id_override": "Zastępuje losowy sekret webhooka w URL-u połączenia (/api/webhook/...). URL jest poświadczeniem – użyj długiej, trudnej do odgadnięcia wartości. Pozostaw puste, aby zachować obecny.",
|
||||
"secret_path_override": "Zastępuje losową ścieżkę używaną do bezpośredniego dostępu na porcie serwera. Ta sama zasada: ścieżka jest poświadczeniem. Pozostaw puste, aby zachować obecny.",
|
||||
"regenerate_secrets": "Jednorazowa akcja: generuje nowy, losowy sekret webhooka i ścieżkę bezpośredniego dostępu, natychmiast unieważniając stare URL-e połączenia. Czyści również dwa powyższe pola nadpisania.",
|
||||
"enable_webhook": "Wyłącz dla trybu tylko lokalnego: webhook Home Assistant nie jest w ogóle rejestrowany, więc nic – w tym Nabu Casa – nie może dotrzeć do serwera przez Home Assistant. Bezpośredni port serwera i panel boczny nadal działają.",
|
||||
"enable_llm_api": "Oferuj pełny zestaw narzędzi agentom konwersacyjnym Home Assistant (OpenAI, Google, Ollama, ...): gdy włączone, agenci mogą wybrać „HA-MCP Server” w sekcji „Steruj Home Assistant” i używać narzędzi z czatu i głosu Assist. Włączenie tylko sprawia, że jest ono dostępne do wyboru – nic nie jest ujawniane, dopóki nie wybierzesz go dla agenta. Przewodnik użytkowania: {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Kształt zestawu narzędzi oferowanego agentom konwersacyjnym. Wyszukiwanie narzędzi (domyślne) utrzymuje mały kontekst agenta: kompaktowe API z przypiętymi narzędziami plus meta-narzędzia do wyszukiwania/wykonywania. Pełny katalog wyświetla każde ujawnione narzędzie bezpośrednio – lepsze dla modeli o dużym kontekście. Oba rejestrują się obok siebie, więc każdy agent wybiera własne w sekcji „Steruj Home Assistant”. Ujawnianie poszczególnych narzędzi jest zarządzane w panelu ustawień HA-MCP; szczegóły: {llm_api_docs_url}",
|
||||
"enable_startup_notification": "Pokazuj powiadomienie za każdym razem, gdy serwer się uruchamia, wskazujące na powierzchnie ustawień tylko dla administratorów. Wyłącz, aby uruchamiać cicho – URL-e połączenia nadal pojawiają się w logu Home Assistant.",
|
||||
"enable_sidebar_panel": "Pokaż panel ustawień HA-MCP na pasku bocznym (tylko dla administratorów). Wyłącz, aby usunąć wpis z paska bocznego – opcje serwera pozostają dostępne na tym ekranie."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "Serwer HA-MCP w procesie nie uruchomił się",
|
||||
"description": "Serwer HA-MCP w procesie nie mógł zostać uruchomiony wewnątrz Home Assistant:\n\n{detail}\n\nSprawdź logi Home Assistant, a następnie przeładuj integrację (lub napraw podstawowy problem i przeładuj), aby spróbować ponownie."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "Pakiet serwera HA-MCP w procesie nie mógł zostać zainstalowany",
|
||||
"description": "Instalacja pakietu ha-mcp dla serwera w procesie nie powiodła się:\n\n{detail}\n\nRozwiąż problem zgodności lub instalacji opisany powyżej, a następnie przeładuj integrację, aby spróbować ponownie."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "Zaktualizuj niestandardowy komponent HA-MCP przez HACS",
|
||||
"description": "Zainstalowany serwer ha-mcp wymaga niestandardowego komponentu HA-MCP {required} lub nowszego, ale masz {installed}. Zaktualizuj komponent przez HACS (otwórz wpis niestandardowego komponentu HA-MCP i użyj „Aktualizuj informacje”, jeśli aktualizacja nie jest jeszcze widoczna) i uruchom ponownie Home Assistant. Serwer działa w międzyczasie, ale niektóre nowsze funkcje mogą nie działać, dopóki komponent nie zostanie zaktualizowany."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "Aktualizacja serwera HA-MCP oczekuje na aktualizację komponentu",
|
||||
"description": "Serwer ha-mcp {latest} jest dostępny, ale ta wersja zaktualizowała również niestandardowy komponent HA-MCP (do {shipped}; używasz {running}). Aby uniknąć uruchamiania wersji serwera, z którą działający komponent nigdy nie był testowany, automatyczna aktualizacja serwera jest wstrzymana do czasu aktualizacji komponentu.\n\nZaktualizuj komponent przez HACS (otwórz wpis niestandardowego komponentu HA-MCP i użyj „Aktualizuj informacje”, jeśli aktualizacja nie jest jeszcze widoczna), a następnie uruchom ponownie Home Assistant – aktualizacja serwera zainstaluje się automatycznie później. Aby mimo wszystko zainstalować aktualizację serwera, naciśnij „Zainstaluj” na encji aktualizacji serwera HA-MCP."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Komponent zainstalowany z przestarzałego repozytorium",
|
||||
"description": "HACS śledzi główne repozytorium serwera ha-mcp dla tego komponentu, więc HACS wyświetla tutaj numery wersji serwera i uwagi do wydania zamiast własnych (2.x) komponentu. Aktualizacje nadal działają, ale pozostają błędnie oznaczone. Aby naprawić: usuń to repozytorium z HACS (Twoje ustawienia integracji i wpisy konfiguracyjne zostaną zachowane), dodaj homeassistant-ai/ha-mcp-integration jako niestandardowe repozytorium, zainstaluj ponownie komponent z niego i uruchom ponownie Home Assistanta."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Uruchom ponownie Home Assistanta, aby zastosować ustawienia Legacy OAuth",
|
||||
"fix_flow": {
|
||||
"step": {
|
||||
"confirm": {
|
||||
"title": "Uruchomić ponownie Home Assistanta?",
|
||||
"description": "Wysłanie tego formularza spowoduje ponowne uruchomienie Home Assistanta i zastosowanie ustawień Legacy OAuth.\n\nKliknij **Wyślij**, aby uruchomić ponownie teraz."
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Stabilny (zalecany)",
|
||||
"dev": "Deweloperski (najnowsza kompilacja)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "Tajny URL webhooka (domyślny)",
|
||||
"ha_auth": "Zaloguj się za pomocą Home Assistant (OAuth)",
|
||||
"legacy": "Legacy OAuth (ta integracja wydaje Client ID/Secret do wklejenia)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "Wyszukiwanie narzędzi (kompaktowe, domyślne)",
|
||||
"full": "Pełny katalog",
|
||||
"both": "Oba (wybór na agenta)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "Aktualizacja"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Bezpośredni dostęp z maszyny Home Assistant: {url}",
|
||||
"connect_local_lan": "Lokalnie/LAN (gdy dostęp do sieci to \"Local network\"): {url}",
|
||||
"connect_remote_url": "Zdalny URL połączenia: {url}",
|
||||
"connect_urls_label": "URL(e) połączenia:",
|
||||
"connect_urls_pending": "URL-e połączenia pojawią się tutaj (i w logu Home Assistant) po uruchomieniu serwera.",
|
||||
"connect_webhook_disabled": "Zdalny dostęp przez webhook jest wyłączony (tryb tylko lokalny).",
|
||||
"oauth_creds_pending": "Client ID i Client Secret pojawią się tutaj po uruchomieniu serwera.",
|
||||
"oauth_not_serving": "Legacy OAuth jeszcze ich nie udostępnia — uruchom ponownie Home Assistanta, gdy pojawi się taka prośba, aby je aktywować.",
|
||||
"oauth_select_legacy_mode": "Ustaw tryb uwierzytelniania na legacy OAuth powyżej i zapisz, aby wygenerować Client ID i Client Secret.",
|
||||
"panel_hint": "Otwórz [panel ustawień HA-MCP](/ha-mcp) do zarządzania narzędziami i ustawieniami serwera.",
|
||||
"tools_module_installed": "Moduł narzędzi beta/zaawansowanych plików i YAML (opcjonalny): Zainstalowany",
|
||||
"tools_module_not_installed": "Moduł narzędzi beta/zaawansowanych plików i YAML (opcjonalny): Niezainstalowany — naciśnij „Dodaj wpis” na stronie tej integracji i wybierz „HA-MCP File & YAML Tools”, aby go dodać",
|
||||
"tools_module_not_loaded": "Moduł narzędzi beta/zaawansowanych plików i YAML (opcjonalny): Zainstalowany, ale niezaładowany — włącz lub przeładuj wpis „HA-MCP File & YAML Tools” na stronie tej integracji",
|
||||
"version_line": "Komponent {component_version} - Serwer ha-mcp {server_version} (kanał {channel})",
|
||||
"version_not_installed": "jeszcze niezainstalowany",
|
||||
"version_unknown": "nieznany"
|
||||
}
|
||||
}
|
||||
@@ -1,161 +1,168 @@
|
||||
{
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "Пользовательский компонент HA-MCP",
|
||||
"description": "Выберите, что добавить. **Сервер HA-MCP** запускает полноценный сервер ha-mcp внутри Home Assistant и предоставляет к нему доступ через вебхук Home Assistant — этот вариант установки подходит большинству пользователей. Это автономный сервер, полностью заменяющий все остальные способы установки (дополнение, Docker, uvx/PyPI, stdio); если он запущен, не запускайте одновременно ни один из них. **Файловые инструменты и инструменты YAML HA-MCP** добавляют привилегированные службы для работы с файлами и редактирования YAML. Они нужны, только если вы включите отключённые по умолчанию файловые инструменты и инструменты YAML в ha-mcp. Если сервер ha-mcp уже работает в другом месте (как дополнение, в Docker или через uvx), добавлять серверную запись не нужно — добавьте только эту запись для файлов и YAML и только в том случае, если используете эти инструменты. Она работает с сервером любого типа, и её можно добавить позднее в любое время.",
|
||||
"menu_options": {
|
||||
"server": "Сервер HA-MCP (рекомендуется)",
|
||||
"tools": "Файловые инструменты и инструменты YAML HA-MCP (необязательно)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "Файловые инструменты и инструменты YAML HA-MCP",
|
||||
"description": "Настраивает привилегированные службы для работы с файлами и конфигурацией YAML. Требуется, только если вы включаете отключённые по умолчанию файловые инструменты и инструменты редактирования YAML в ha-mcp (флаги функций). Это относится к серверу любого типа, в том числе к внутрипроцессному серверу HA-MCP. Эту запись можно добавить или удалить в любое время."
|
||||
},
|
||||
"server": {
|
||||
"title": "Сервер HA-MCP",
|
||||
"description": "Запускает полноценный сервер ha-mcp внутри Home Assistant и предоставляет удалённый доступ к нему через вебхук Home Assistant (доступный через Nabu Casa или любой обратный прокси-сервер). Это автономный сервер, полностью заменяющий способы установки в виде дополнения, Docker, uvx/PyPI и stdio; не запускайте его одновременно с другим сервером ha-mcp. Нажмите **Отправить**, чтобы запустить его. После этого порт, сетевой интерфейс и способ аутентификации можно изменить в параметрах интеграции."
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "Эта запись уже настроена.",
|
||||
"unsupported_home_assistant": "Для внутрипроцессного сервера HA-MCP требуется Home Assistant версии {required} или новее, но в этом экземпляре установлена версия {installed}. Вы по-прежнему можете использовать запись «HA-MCP File & YAML Tools» этого компонента с внешним сервером ha-mcp, работающим как дополнение или контейнер Docker."
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "Пользовательский компонент HA-MCP",
|
||||
"description": "Выберите, что добавить. **HA-MCP Server** запускает полноценный сервер ha-mcp внутри Home Assistant и предоставляет к нему доступ через веб-хук Home Assistant — это вариант установки, который подходит большинству пользователей. Это автономный сервер и полноценная замена для всех остальных способов установки: дополнение (app/add-on), Docker, uvx/PyPI, stdio; если вы используете его, не запускайте ничего из этого параллельно. **HA-MCP File & YAML Tools** выполняет две роли. Если ваш сервер ha-mcp работает вне Home Assistant (дополнение, Docker, uvx/PyPI, stdio), эта запись также наделяет такой сервер возможностями внутрипроцессного компонента, недоступными извне (быстрый внутрипроцессный поиск, метаданные записей конфигурации, чтение из реестра), поэтому ее стоит добавить к каждой внешней установке. Она также выступает в роли шлюза для привилегированных служб редактирования файлов и YAML, используемых инструментами работы с файлами/YAML от ha-mcp (по умолчанию отключены). Если вместо этого вы добавите запись HA-MCP Server, она уже предоставит эти общие возможности, поэтому вторая запись потребуется только в качестве шлюза для дополнительных инструментов работы с файлами и YAML. Она работает с серверами любого типа и может быть добавлена в любой момент.",
|
||||
"menu_options": {
|
||||
"server": "Сервер HA-MCP (рекомендуется)",
|
||||
"tools": "Файловые инструменты и инструменты YAML HA-MCP (необязательно)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "Файловые инструменты и инструменты YAML HA-MCP",
|
||||
"description": "Настраивает привилегированные службы редактирования конфигурационных файлов и YAML, которые остаются заблокированными за дополнительными инструментами работы с файлами/YAML от ha-mcp (управляются флагами функций, по умолчанию отключены) — это относится к серверам любого типа, включая встроенный HA-MCP Server. Если ваш сервер ha-mcp работает вне Home Assistant, эта запись также предоставляет ему возможности внутрипроцессного компонента, недоступные извне (быстрый внутрипроцессный поиск, метаданные записей конфигурации, чтение из реестра), которые полезны даже при отключенных инструментах работы с файлами/YAML. Вы можете добавить или удалить эту запись в любое время."
|
||||
},
|
||||
"server": {
|
||||
"title": "Сервер HA-MCP",
|
||||
"description": "Запускает полный сервер ha-mcp внутри Home Assistant и предоставляет к нему удаленный доступ через веб-хук Home Assistant (доступен через Nabu Casa или любой обратный прокси-сервер). Это автономный сервер и полноценная замена для способов установки через дополнение (app/add-on), Docker, uvx/PyPI и stdio — не запускайте его параллельно с другим сервером ha-mcp. Нажмите **Отправить**, чтобы запустить его; в дальнейшем вы сможете изменить порт, привязку и аутентификацию в настройках интеграции."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "Файловые инструменты и инструменты YAML HA-MCP",
|
||||
"description": "Настройка привилегированных служб для работы с файлами и редактирования YAML, которые используются отключёнными по умолчанию файловыми инструментами и инструментами YAML в ha-mcp. Эти параметры также отображаются в собственном интерфейсе настроек сервера ha-mcp и применяются сразу, без перезапуска. Неотключаемый базовый запрет по-прежнему блокирует чувствительные пути (например, .storage) и ключи границы доверия (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Дополнительные файловые каталоги",
|
||||
"extra_yaml_keys": "Дополнительные YAML-ключи для записи"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Каталоги относительно каталога конфигурации, каждому предоставляется доступ на чтение и запись (например, pyscript). Записи с обходом пути и вне каталога конфигурации отбрасываются.",
|
||||
"extra_yaml_keys": "Верхнеуровневые ключи, которые ha_config_set_yaml может записывать вдобавок к встроенным, — для YAML-ориентированных интеграций на этой установке (например, alert2). Ключи границы доверия отбрасываются."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "Сервер HA-MCP",
|
||||
"description": "Настройте сервер HA-MCP. {panel_hint}Изменения применяются при сохранении.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Канал выпуска",
|
||||
"auto_update": "Автоматические обновления сервера",
|
||||
"server_port": "Порт прослушивания MCP-сервера",
|
||||
"bind_host": "Сетевой доступ",
|
||||
"webhook_auth": "Режим аутентификации",
|
||||
"oauth_client_id_override": "Устаревший OAuth: пользовательский Client ID (необязательно)",
|
||||
"oauth_client_secret_override": "Устаревший OAuth: пользовательский Client Secret (необязательно)",
|
||||
"oauth_regenerate": "Устаревший OAuth: создать новые Client ID и Secret сейчас",
|
||||
"pip_spec": "Для разработчиков: переопределение пакета ha-mcp",
|
||||
"server_url": "URL-адрес Home Assistant (расширенная настройка)",
|
||||
"external_url": "Внешний URL-адрес (необязательно)",
|
||||
"webhook_id_override": "Пользовательский секрет вебхука (необязательно)",
|
||||
"secret_path_override": "Пользовательский путь прямого доступа (необязательно)",
|
||||
"regenerate_secrets": "Создать новые секреты подключения сейчас",
|
||||
"enable_webhook": "Удалённый доступ через вебхук",
|
||||
"enable_llm_api": "LLM API диалогового агента",
|
||||
"llm_api_exposure": "Набор инструментов для диалогового агента",
|
||||
"enable_startup_notification": "Уведомление о запуске",
|
||||
"enable_sidebar_panel": "Панель настроек в боковой панели"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "Стабильный канал устанавливает последнюю стабильную версию, а канал разработки — самую новую сборку для разработки. Если автоматические обновления включены, последняя сборка выбранного канала устанавливается при перезагрузке интеграции или перезапуске, а также во время периодической проверки. Указанное ниже переопределение пакета для разработчиков имеет приоритет и отключает автоматические обновления.",
|
||||
"auto_update": "Если параметр включён, последняя версия выбранного канала устанавливается автоматически при перезагрузке интеграции или перезапуске, а также во время периодической проверки. Если параметр выключен, сервер остаётся на текущей установленной версии, пока вы снова не включите его. Это относится только к пакету сервера ha-mcp; обновления самого пользовательского компонента HA-MCP по-прежнему устанавливаются через HACS.",
|
||||
"server_port": "Порт, который прослушивает этот сервер. Дополнение ha-mcp использует порт 9583, поэтому по умолчанию выбран порт 9584, чтобы оба сервера могли работать одновременно. Если дополнение не используется, подойдёт любой свободный порт.",
|
||||
"bind_host": "Определяет, кто может подключаться непосредственно к порту MCP-сервера. Значение по умолчанию соответствует дополнению: сервер доступен в локальной сети, а секретный путь используется как учётные данные. Выберите loopback, чтобы разрешить подключения только с самого компьютера Home Assistant. URL-адрес вебхука и панель в боковом меню будут работать в любом случае.",
|
||||
"webhook_auth": "Определяет, как MCP-клиенты подтверждают свою подлинность при обращении к URL-адресу вебхука. При использовании секретного URL-адреса учётными данными служит сама ссылка. При использовании входа через Home Assistant такие клиенты, как claude.ai, входят с учётной записью администратора Home Assistant (OAuth). При использовании устаревшего OAuth интеграция выдаёт собственные Client ID и Secret, которые нужно вставить в клиенты, где они требуются, например Google Gemini Spark. Для включения или выключения этого режима необходимо перезапустить Home Assistant.",
|
||||
"oauth_client_id_override": "Заменяет автоматически созданный Client ID устаревшего OAuth. Оставьте поле пустым, чтобы сохранить текущее значение. Используется, только когда выбран режим аутентификации «Устаревший OAuth».",
|
||||
"oauth_client_secret_override": "Заменяет автоматически созданный Client Secret устаревшего OAuth. Оставьте поле пустым, чтобы сохранить текущее значение. Используется, только когда выбран режим аутентификации «Устаревший OAuth».",
|
||||
"oauth_regenerate": "Одноразовое действие: создаёт новые Client ID и Secret для режима устаревшего OAuth. Они начнут действовать только после перезапуска Home Assistant, который будет предложен в уведомлении о восстановлении. До перезапуска прежние Client ID и Secret продолжат работать, а новые работать не будут. Также очищает два поля переопределения выше.",
|
||||
"pip_spec": "Оставьте пустым. Предназначено только для тестирования определённой сборки ha-mcp (например, для фиксации предварительной версии). Переопределяет канал выпуска и отключает автоматические обновления, пока поле не будет очищено.",
|
||||
"server_url": "URL-адрес, по которому внутрипроцессный сервер обращается к Home Assistant (обычно к этому же экземпляру). Оставьте пустым, чтобы сформировать адрес из порта и настроек SSL этого экземпляра. Указывайте значение только в том случае, если сервер должен использовать другой маршрут.",
|
||||
"external_url": "Отображается как основной URL-адрес подключения. Используйте его, если Home Assistant доступен через собственный домен или обратный прокси-сервер. Введите полный базовый адрес, включая схему. Он должен указывать непосредственно на Home Assistant: при открытии в браузере должна появляться страница входа HA. Адрес не должен содержать порт, например :8123 или любой другой, иначе удалённые MCP-клиенты не смогут подключиться. Оставьте поле пустым, чтобы автоматически использовать Nabu Casa или локальный адрес.",
|
||||
"webhook_id_override": "Заменяет случайный секрет вебхука в URL-адресе подключения (/api/webhook/...). URL-адрес служит учётными данными, поэтому используйте длинное значение, которое трудно угадать. Оставьте поле пустым, чтобы сохранить текущее значение.",
|
||||
"secret_path_override": "Заменяет случайный путь для прямого доступа через порт сервера. Действует то же правило: путь служит учётными данными. Оставьте поле пустым, чтобы сохранить текущее значение.",
|
||||
"regenerate_secrets": "Одноразовое действие: создаёт новый случайный секрет вебхука и путь прямого доступа, немедленно делая прежние URL-адреса подключения недействительными. Также очищает два поля переопределения выше.",
|
||||
"enable_webhook": "Выключите для работы только в локальном режиме: вебхук Home Assistant вообще не будет зарегистрирован, поэтому ничто, включая Nabu Casa, не сможет обратиться к серверу через Home Assistant. Прямой порт сервера и панель в боковом меню продолжат работать.",
|
||||
"enable_llm_api": "Предоставляет полный набор инструментов диалоговым агентам Home Assistant (OpenAI, Google, Ollama и другим). Пока параметр включён, агенты могут выбрать «HA-MCP Server» в разделе управления Home Assistant и использовать инструменты из чата и голосового интерфейса Assist. Включение лишь делает его доступным для выбора: ничего не предоставляется, пока вы не выберете его в настройках агента. Руководство по использованию: {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Определяет вид набора инструментов, предоставляемого диалоговым агентам. Поиск инструментов (по умолчанию) уменьшает контекст агента: используется компактный API с закреплёнными инструментами и метаинструментами поиска и выполнения. Полный каталог перечисляет все доступные инструменты напрямую и лучше подходит моделям с большим контекстом. Вариант «Оба» регистрирует оба набора параллельно, чтобы каждый агент мог выбрать свой в разделе управления Home Assistant. Доступность отдельных инструментов настраивается в панели HA-MCP; подробности: {llm_api_docs_url}",
|
||||
"enable_startup_notification": "Показывает уведомление при каждом запуске сервера со ссылками на доступные только администраторам страницы настроек. Выключите, чтобы запускать сервер без уведомлений. URL-адреса подключения всё равно будут записываться в журнал Home Assistant.",
|
||||
"enable_sidebar_panel": "Показывает панель настроек HA-MCP в боковом меню (только для администраторов). Выключите, чтобы убрать пункт из бокового меню. Параметры сервера останутся доступны на этом экране."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "Не удалось запустить внутрипроцессный сервер HA-MCP",
|
||||
"description": "Не удалось запустить внутрипроцессный сервер HA-MCP внутри Home Assistant:\n\n{detail}\n\nПроверьте журналы Home Assistant, затем перезагрузите интеграцию (либо устраните основную проблему и перезагрузите её), чтобы повторить попытку."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "Не удалось установить пакет внутрипроцессного сервера HA-MCP",
|
||||
"description": "Не удалось установить пакет ha-mcp для внутрипроцессного сервера:\n\n{detail}\n\nУстраните описанную выше проблему совместимости или установки, затем перезагрузите интеграцию, чтобы повторить попытку."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "Обновите пользовательский компонент HA-MCP через HACS",
|
||||
"description": "Для установленного сервера ha-mcp требуется пользовательский компонент HA-MCP версии {required} или новее, но у вас установлена версия {installed}. Обновите компонент через HACS (откройте запись пользовательского компонента HA-MCP и выберите «Обновить информацию», если обновление ещё не отображается) и перезапустите Home Assistant. Тем временем сервер продолжит работать, но некоторые новые функции могут не работать до обновления компонента."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "Обновление сервера HA-MCP ожидает обновления компонента",
|
||||
"description": "Доступен сервер ha-mcp версии {latest}, но в этом выпуске также обновлён пользовательский компонент HA-MCP (до версии {shipped}; у вас работает версия {running}). Чтобы не запускать версию сервера, которая не тестировалась с работающим компонентом, автоматическое обновление сервера приостановлено до обновления компонента.\n\nОбновите компонент через HACS (откройте запись пользовательского компонента HA-MCP и выберите «Обновить информацию», если обновление ещё не отображается), затем перезапустите Home Assistant. После этого обновление сервера установится автоматически. Чтобы всё равно установить обновление сервера, нажмите «Установить» у сущности обновления сервера HA-MCP."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Компонент установлен из устаревшего репозитория",
|
||||
"description": "HACS отслеживает для этого компонента основной репозиторий сервера ha-mcp, поэтому здесь отображаются номера версий сервера (7.x) и примечания к его выпускам вместо собственных версий компонента (1.x). Обновления продолжают работать, но будут и дальше обозначаться неверно. Чтобы исправить это, удалите этот репозиторий из HACS (настройки интеграции и записи конфигурации сохранятся), добавьте homeassistant-ai/ha-mcp-integration как пользовательский репозиторий, переустановите из него компонент и перезапустите Home Assistant."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Перезапустите Home Assistant, чтобы применить изменение устаревшего OAuth",
|
||||
"description": "Режим аутентификации с устаревшим OAuth регистрирует собственные веб-точки /authorize и /token, которые Home Assistant может привязать или освободить только при полном перезапуске — независимо от того, включили вы этот режим, выключили его или изменили Client ID/Secret. Перезапустите Home Assistant («Настройки» → «Система» → «Перезапустить»), чтобы применить изменение. До этого продолжит действовать прежнее поведение."
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Стабильный (рекомендуется)",
|
||||
"dev": "Для разработки (последняя сборка)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "Секретный URL-адрес вебхука (по умолчанию)",
|
||||
"ha_auth": "Вход через Home Assistant (OAuth)",
|
||||
"legacy": "Устаревший OAuth (Client ID/Secret, для Google Gemini Spark)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "Поиск инструментов (компактный, по умолчанию)",
|
||||
"full": "Полный каталог",
|
||||
"both": "Оба (выбор для каждого агента)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "Обновление"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Прямой доступ с компьютера Home Assistant: {url}",
|
||||
"connect_local_lan": "Локально/LAN (когда сетевой доступ — «Local network»): {url}",
|
||||
"connect_remote_url": "URL-адрес удалённого подключения: {url}",
|
||||
"connect_urls_label": "URL-адреса подключения:",
|
||||
"connect_urls_pending": "URL-адреса подключения появятся здесь (и в журнале Home Assistant) после запуска сервера.",
|
||||
"connect_webhook_disabled": "Удалённый доступ через вебхук отключён (только локальный режим).",
|
||||
"oauth_creds_pending": "Client ID и Client Secret появятся здесь после запуска сервера.",
|
||||
"oauth_not_serving": "Устаревший OAuth пока их не обслуживает — перезапустите Home Assistant, когда он об этом попросит, чтобы активировать их.",
|
||||
"oauth_select_legacy_mode": "Установите режим аутентификации выше на устаревший OAuth и сохраните, чтобы создать Client ID и Client Secret.",
|
||||
"panel_hint": "Откройте [панель настроек HA-MCP](/ha-mcp) для управления инструментами и настройками сервера.",
|
||||
"tools_module_installed": "Бета-модуль расширенных инструментов для файлов и YAML (необязательно): Установлен",
|
||||
"tools_module_not_installed": "Бета-модуль расширенных инструментов для файлов и YAML (необязательно): Не установлен — нажмите «Добавить запись» на странице этой интеграции и выберите «HA-MCP File & YAML Tools»",
|
||||
"tools_module_not_loaded": "Бета-модуль расширенных инструментов для файлов и YAML (необязательно): Установлен, но не загружен — включите или перезагрузите запись «HA-MCP File & YAML Tools» на странице этой интеграции",
|
||||
"version_line": "Компонент {component_version} - Сервер ha-mcp {server_version} (канал {channel})",
|
||||
"version_not_installed": "ещё не установлен",
|
||||
"version_unknown": "неизвестен"
|
||||
"abort": {
|
||||
"already_configured": "Эта запись уже настроена.",
|
||||
"unsupported_home_assistant": "Для встроенного сервера HA-MCP требуется Home Assistant версии {required} или новее, но на этом экземпляре запущенна версия {installed}. Вы по-прежнему можете использовать запись HA-MCP File & YAML Tools этой компоненты с внешним сервером ha-mcp, запущенным в качестве дополнения (app/add-on) или контейнера Docker."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "Файловые инструменты и инструменты YAML HA-MCP",
|
||||
"description": "Настройка привилегированных служб для работы с файлами и редактирования YAML, которые используются отключёнными по умолчанию файловыми инструментами и инструментами YAML в ha-mcp. Эти параметры также отображаются в собственном интерфейсе настроек сервера ha-mcp и применяются сразу, без перезапуска. Неотключаемый базовый запрет по-прежнему блокирует чувствительные пути (например, .storage) и ключи границы доверия (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Дополнительные файловые каталоги",
|
||||
"extra_yaml_keys": "Дополнительные YAML-ключи для записи"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Каталоги относительно каталога конфигурации, каждому предоставляется доступ на чтение и запись (например, pyscript). Записи с обходом пути и вне каталога конфигурации отбрасываются.",
|
||||
"extra_yaml_keys": "Верхнеуровневые ключи, которые ha_config_set_yaml может записывать вдобавок к встроенным, — для YAML-ориентированных интеграций на этой установке (например, alert2). Ключи границы доверия отбрасываются."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "Сервер HA-MCP",
|
||||
"description": "Настройте сервер HA-MCP. {panel_hint}Изменения применяются при сохранении.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Канал выпуска",
|
||||
"auto_update": "Автоматические обновления сервера",
|
||||
"server_port": "Порт прослушивания MCP-сервера",
|
||||
"bind_host": "Сетевой доступ",
|
||||
"webhook_auth": "Режим аутентификации",
|
||||
"oauth_client_id_override": "Устаревший OAuth: пользовательский Client ID (необязательно)",
|
||||
"oauth_client_secret_override": "Устаревший OAuth: пользовательский Client Secret (необязательно)",
|
||||
"oauth_regenerate": "Устаревший OAuth: создать новые Client ID и Secret сейчас",
|
||||
"pip_spec": "Для разработчиков: переопределение пакета ha-mcp",
|
||||
"server_url": "URL-адрес Home Assistant (расширенная настройка)",
|
||||
"external_url": "Внешний URL-адрес (необязательно)",
|
||||
"webhook_id_override": "Пользовательский секрет вебхука (необязательно)",
|
||||
"secret_path_override": "Пользовательский путь прямого доступа (необязательно)",
|
||||
"regenerate_secrets": "Создать новые секреты подключения сейчас",
|
||||
"enable_webhook": "Удалённый доступ через вебхук",
|
||||
"enable_llm_api": "LLM API диалогового агента",
|
||||
"llm_api_exposure": "Набор инструментов для диалогового агента",
|
||||
"enable_startup_notification": "Уведомление о запуске",
|
||||
"enable_sidebar_panel": "Панель настроек в боковой панели"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "Стабильный канал устанавливает последнюю стабильную версию, а канал разработки — самую новую сборку для разработки. Если автоматические обновления включены, последняя сборка выбранного канала устанавливается при перезагрузке интеграции или перезапуске, а также во время периодической проверки. Указанное ниже переопределение пакета для разработчиков имеет приоритет и отключает автоматические обновления.",
|
||||
"auto_update": "Если параметр включён, последняя версия выбранного канала устанавливается автоматически при перезагрузке интеграции или перезапуске, а также во время периодической проверки. Если параметр выключен, сервер остаётся на текущей установленной версии, пока вы снова не включите его. Это относится только к пакету сервера ha-mcp; обновления самого пользовательского компонента HA-MCP по-прежнему устанавливаются через HACS.",
|
||||
"server_port": "Порт, на котором прослушивает этот сервер. Дополнение (app/add-on) ha-mcp использует порт 9583, поэтому по умолчанию установлено значение 9584, чтобы они могли работать одновременно. Если вы не используете дополнение, подойдет любой свободный порт.",
|
||||
"bind_host": "Кто может подключаться напрямую к порту MCP-сервера. Значение по умолчанию соответствует дополнению (app/add-on): доступ из вашей локальной сети, где секретный путь выступает в роли учетных данных. Выберите loopback, чтобы разрешить подключения только с самого компьютера Home Assistant — URL веб-хука и панель бокового меню будут работать в любом случае.",
|
||||
"webhook_auth": "Как клиенты MCP подтверждают свою подлинность по URL-адресу веб-хука. С секретным URL-адресом сама ссылка является единственным учётным данным — OAuth по-прежнему работает для клиентов, которые его используют, но каждый вход одобряется автоматически: не требуется ни логин, ни Client ID, ни Secret. При входе через Home Assistant клиенты, такие как claude.ai, входят в систему с учётной записью администратора Home Assistant (OAuth). При использовании устаревшего OAuth эта интеграция запускает собственную службу входа и выдаёт Client ID и Secret для вставки в клиенты, которым они требуются — для полного включения или выключения может потребоваться перезапуск Home Assistant.",
|
||||
"oauth_client_id_override": "Заменяет автоматически созданный Client ID устаревшего OAuth. Оставьте поле пустым, чтобы сохранить текущее значение. Используется, только когда выбран режим аутентификации «Устаревший OAuth».",
|
||||
"oauth_client_secret_override": "Заменяет автоматически созданный Client Secret устаревшего OAuth. Оставьте поле пустым, чтобы сохранить текущее значение. Используется, только когда выбран режим аутентификации «Устаревший OAuth».",
|
||||
"oauth_regenerate": "Одноразовое действие: создаёт новые Client ID и Secret для режима устаревшего OAuth. Они начнут действовать только после перезапуска Home Assistant, который будет предложен в уведомлении о восстановлении. До перезапуска прежние Client ID и Secret продолжат работать, а новые работать не будут. Также очищает два поля переопределения выше.",
|
||||
"pip_spec": "Оставьте пустым. Предназначено только для тестирования определённой сборки ha-mcp (например, для фиксации предварительной версии). Переопределяет канал выпуска и отключает автоматические обновления, пока поле не будет очищено.",
|
||||
"server_url": "URL-адрес, по которому внутрипроцессный сервер обращается к Home Assistant (обычно к этому же экземпляру). Оставьте пустым, чтобы сформировать адрес из порта и настроек SSL этого экземпляра. Указывайте значение только в том случае, если сервер должен использовать другой маршрут.",
|
||||
"external_url": "Отображается как основной URL-адрес подключения. Используйте его, если Home Assistant доступен через собственный домен или обратный прокси-сервер. Введите полный базовый адрес, включая схему. Он должен указывать непосредственно на Home Assistant: при открытии в браузере должна появляться страница входа HA. Адрес не должен содержать порт, например :8123 или любой другой, иначе удалённые MCP-клиенты не смогут подключиться. Оставьте поле пустым, чтобы автоматически использовать Nabu Casa или локальный адрес.",
|
||||
"webhook_id_override": "Заменяет случайный секрет вебхука в URL-адресе подключения (/api/webhook/...). URL-адрес служит учётными данными, поэтому используйте длинное значение, которое трудно угадать. Оставьте поле пустым, чтобы сохранить текущее значение.",
|
||||
"secret_path_override": "Заменяет случайный путь для прямого доступа через порт сервера. Действует то же правило: путь служит учётными данными. Оставьте поле пустым, чтобы сохранить текущее значение.",
|
||||
"regenerate_secrets": "Одноразовое действие: создаёт новый случайный секрет вебхука и путь прямого доступа, немедленно делая прежние URL-адреса подключения недействительными. Также очищает два поля переопределения выше.",
|
||||
"enable_webhook": "Выключите для работы только в локальном режиме: вебхук Home Assistant вообще не будет зарегистрирован, поэтому ничто, включая Nabu Casa, не сможет обратиться к серверу через Home Assistant. Прямой порт сервера и панель в боковом меню продолжат работать.",
|
||||
"enable_llm_api": "Предоставляет полный набор инструментов диалоговым агентам Home Assistant (OpenAI, Google, Ollama и другим). Пока параметр включён, агенты могут выбрать «HA-MCP Server» в разделе управления Home Assistant и использовать инструменты из чата и голосового интерфейса Assist. Включение лишь делает его доступным для выбора: ничего не предоставляется, пока вы не выберете его в настройках агента. Руководство по использованию: {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Определяет вид набора инструментов, предоставляемого диалоговым агентам. Поиск инструментов (по умолчанию) уменьшает контекст агента: используется компактный API с закреплёнными инструментами и метаинструментами поиска и выполнения. Полный каталог перечисляет все доступные инструменты напрямую и лучше подходит моделям с большим контекстом. Вариант «Оба» регистрирует оба набора параллельно, чтобы каждый агент мог выбрать свой в разделе управления Home Assistant. Доступность отдельных инструментов настраивается в панели HA-MCP; подробности: {llm_api_docs_url}",
|
||||
"enable_startup_notification": "Показывает уведомление при каждом запуске сервера со ссылками на доступные только администраторам страницы настроек. Выключите, чтобы запускать сервер без уведомлений. URL-адреса подключения всё равно будут записываться в журнал Home Assistant.",
|
||||
"enable_sidebar_panel": "Показывает панель настроек HA-MCP в боковом меню (только для администраторов). Выключите, чтобы убрать пункт из бокового меню. Параметры сервера останутся доступны на этом экране."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "Не удалось запустить внутрипроцессный сервер HA-MCP",
|
||||
"description": "Не удалось запустить внутрипроцессный сервер HA-MCP внутри Home Assistant:\n\n{detail}\n\nПроверьте журналы Home Assistant, затем перезагрузите интеграцию (либо устраните основную проблему и перезагрузите её), чтобы повторить попытку."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "Не удалось установить пакет внутрипроцессного сервера HA-MCP",
|
||||
"description": "Не удалось установить пакет ha-mcp для внутрипроцессного сервера:\n\n{detail}\n\nУстраните описанную выше проблему совместимости или установки, затем перезагрузите интеграцию, чтобы повторить попытку."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "Обновите пользовательский компонент HA-MCP через HACS",
|
||||
"description": "Для установленного сервера ha-mcp требуется пользовательский компонент HA-MCP версии {required} или новее, но у вас установлена версия {installed}. Обновите компонент через HACS (откройте запись пользовательского компонента HA-MCP и выберите «Обновить информацию», если обновление ещё не отображается) и перезапустите Home Assistant. Тем временем сервер продолжит работать, но некоторые новые функции могут не работать до обновления компонента."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "Обновление сервера HA-MCP ожидает обновления компонента",
|
||||
"description": "Доступен сервер ha-mcp версии {latest}, но в этом выпуске также обновлён пользовательский компонент HA-MCP (до версии {shipped}; у вас работает версия {running}). Чтобы не запускать версию сервера, которая не тестировалась с работающим компонентом, автоматическое обновление сервера приостановлено до обновления компонента.\n\nОбновите компонент через HACS (откройте запись пользовательского компонента HA-MCP и выберите «Обновить информацию», если обновление ещё не отображается), затем перезапустите Home Assistant. После этого обновление сервера установится автоматически. Чтобы всё равно установить обновление сервера, нажмите «Установить» у сущности обновления сервера HA-MCP."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Компонент установлен из устаревшего репозитория",
|
||||
"description": "HACS отслеживает основной репозиторий сервера ha-mcp для этого компонента, поэтому HACS показывает здесь номера версий сервера и примечания к выпуску вместо собственных (2.x) для компонента. Обновления продолжают работать, но остаются неправильно помеченными. Чтобы исправить: удалите этот репозиторий из HACS (ваши настройки интеграции и записи конфигурации сохраняются), добавьте homeassistant-ai/ha-mcp-integration как пользовательский репозиторий, переустановите компонент из него и перезапустите Home Assistant."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Перезапустите Home Assistant, чтобы применить устаревшие настройки OAuth",
|
||||
"fix_flow": {
|
||||
"step": {
|
||||
"confirm": {
|
||||
"title": "Перезапустить Home Assistant?",
|
||||
"description": "Отправка этой формы перезапустит Home Assistant и применит устаревшие настройки OAuth.\n\nНажмите <strong>Submit</strong>, чтобы перезапустить сейчас."
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Стабильный (рекомендуется)",
|
||||
"dev": "Для разработки (последняя сборка)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "Секретный URL-адрес вебхука (по умолчанию)",
|
||||
"ha_auth": "Вход через Home Assistant (OAuth)",
|
||||
"legacy": "Устаревший OAuth (эта интеграция выдаёт Client ID/Secret для вставки)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "Поиск инструментов (компактный, по умолчанию)",
|
||||
"full": "Полный каталог",
|
||||
"both": "Оба (выбор для каждого агента)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "Обновление"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Прямой доступ с компьютера Home Assistant: {url}",
|
||||
"connect_local_lan": "Локально/LAN (когда сетевой доступ — «Local network»): {url}",
|
||||
"connect_remote_url": "URL-адрес удалённого подключения: {url}",
|
||||
"connect_urls_label": "URL-адреса подключения:",
|
||||
"connect_urls_pending": "URL-адреса подключения появятся здесь (и в журнале Home Assistant) после запуска сервера.",
|
||||
"connect_webhook_disabled": "Удалённый доступ через вебхук отключён (только локальный режим).",
|
||||
"oauth_creds_pending": "Client ID и Client Secret появятся здесь после запуска сервера.",
|
||||
"oauth_not_serving": "Устаревший OAuth пока их не обслуживает — перезапустите Home Assistant, когда он об этом попросит, чтобы активировать их.",
|
||||
"oauth_select_legacy_mode": "Установите режим аутентификации выше на устаревший OAuth и сохраните, чтобы создать Client ID и Client Secret.",
|
||||
"panel_hint": "Откройте [панель настроек HA-MCP](/ha-mcp) для управления инструментами и настройками сервера.",
|
||||
"tools_module_installed": "Бета-модуль расширенных инструментов для файлов и YAML (необязательно): Установлен",
|
||||
"tools_module_not_installed": "Бета-модуль расширенных инструментов для файлов и YAML (необязательно): Не установлен — нажмите «Добавить запись» на странице этой интеграции и выберите «HA-MCP File & YAML Tools»",
|
||||
"tools_module_not_loaded": "Бета-модуль расширенных инструментов для файлов и YAML (необязательно): Установлен, но не загружен — включите или перезагрузите запись «HA-MCP File & YAML Tools» на странице этой интеграции",
|
||||
"version_line": "Компонент {component_version} - Сервер ha-mcp {server_version} (канал {channel})",
|
||||
"version_not_installed": "ещё не установлен",
|
||||
"version_unknown": "неизвестен"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,168 @@
|
||||
{
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "HA-MCP Anpassad Komponent",
|
||||
"description": "Välj vad som ska läggas till. **HA-MCP Server** kör hela ha-mcp-servern inne i Home Assistant och exponerar den via en Home Assistant-webhook – detta är installationen som de flesta vill ha. Den är en fristående server och en komplett ersättning för alla andra installationsmetoder: App (tillägg), Docker, uvx/PyPI, stdio; om du kör den, kör inte någon av dem samtidigt. **HA-MCP File & YAML Tools** har två roller. Om din ha-mcp-server körs utanför Home Assistant – app, Docker, uvx/PyPI, stdio – ger denna post även den servern de inbyggda komponentfunktioner den inte kan nå utifrån (snabb inbyggd sökning, metadata för konfigurationsposter, registerbaserade läsningar), så den är värd att lägga till för varje extern installation, och den fungerar som spärr för de privilegierade fil- och YAML-redigeringstjänsterna som används av ha-mcp:s valbara fil-/YAML-verktyg. Om du lägger till posten HA-MCP Server i stället, tillhandahåller den posten redan dessa delade funktioner, så denna andra post behövs då endast som spärr för de valbara fil-/YAML-verktygen. Den fungerar med alla servertyper och kan läggas till senare när som helst.",
|
||||
"menu_options": {
|
||||
"server": "HA-MCP Server (rekommenderas)",
|
||||
"tools": "HA-MCP Fil- & YAML-verktyg (valfritt)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "HA-MCP Fil- & YAML-verktyg",
|
||||
"description": "Konfigurerar de privilegierade fil- och YAML-konfigurationstjänsterna, som förblir spärrade bakom ha-mcp:s valbara fil-/YAML-redigeringsverktyg (funktionsflaggor, av som standard) – detta gäller för alla servertyper, inklusive den inbyggda HA-MCP Server. Om din ha-mcp-server körs utanför Home Assistant ger denna post den även de inbyggda komponentfunktioner den inte kan nå utifrån (snabb inbyggd sökning, metadata för konfigurationsposter, registerbaserade läsningar), vilka är värda att ha även när fil-/YAML-verktygen är avstängda. Du kan lägga till eller ta bort denna post när som helst."
|
||||
},
|
||||
"server": {
|
||||
"title": "HA-MCP Server",
|
||||
"description": "Detta kör hela ha-mcp-servern inne i Home Assistant och exponerar den på distans via en Home Assistant-webhook (nås via Nabu Casa eller vilken omvänd proxy som helst). Den är en fristående server och en komplett ersättning för installationsmetoderna app (tillägg), Docker, uvx/PyPI och stdio – kör den inte tillsammans med en annan ha-mcp-server. Välj **Skicka** för att starta den; du kan ändra port, bindning och autentisering i efterhand i integreringsalternativen."
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "Denna post är redan konfigurerad.",
|
||||
"unsupported_home_assistant": "Den inbyggda HA-MCP-servern kräver Home Assistant {required} eller nyare, men denna instans kör {installed}. Du kan fortfarande använda denna komponents post för HA-MCP File & YAML Tools med en extern ha-mcp-server som körs som en app (tillägg) eller Docker-behållare."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "HA-MCP Fil- & YAML-verktyg",
|
||||
"description": "Konfigurera de privilegierade fil- och YAML-redigeringstjänsterna som används av ha-mcp:s valfria fil-/YAML-verktyg. Dessa inställningar visas också i ha-mcp-serverns eget inställningsgränssnitt och tillämpas direkt, utan omstart. En icke-överskridbar spärr blockerar fortfarande känsliga sökvägar (t.ex. .storage) och nycklar för förtroendegränser (homeassistant, http, frontend, lovelace).",
|
||||
"data": {
|
||||
"allowed_dirs": "Extra filkataloger",
|
||||
"extra_yaml_keys": "Extra YAML-skrivnycklar"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "Kataloger i förhållande till konfigurationskatalogen, var och en beviljas läs- och skrivrättigheter (t.ex. pyscript). Genomgång och poster utanför konfigurationen ignoreras.",
|
||||
"extra_yaml_keys": "Toppnivånycklar som ha_config_set_yaml får skriva utöver de inbyggda, för YAML-först-integrationer på denna installation (t.ex. alert2). Nycklar för förtroendegränser ignoreras."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "HA-MCP Server",
|
||||
"description": "Konfigurera HA-MCP-servern. {panel_hint}Ändringar här tillämpas vid spara.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Utgivningskanal",
|
||||
"auto_update": "Automatiska serveruppdateringar",
|
||||
"server_port": "MCP-serverns lyssningsport",
|
||||
"bind_host": "Nätverksåtkomst",
|
||||
"webhook_auth": "Autentiseringsläge",
|
||||
"oauth_client_id_override": "Äldre OAuth: anpassat klient-ID (valfritt)",
|
||||
"oauth_client_secret_override": "Äldre OAuth: anpassad klienthemlighet (valfritt)",
|
||||
"oauth_regenerate": "Äldre OAuth: generera nytt klient-ID/hemlighet nu",
|
||||
"pip_spec": "Utvecklare: åsidosättning av ha-mcp-paket",
|
||||
"server_url": "Home Assistant URL (avancerat)",
|
||||
"external_url": "Extern URL (valfritt)",
|
||||
"webhook_id_override": "Anpassad webhook-hemlighet (valfritt)",
|
||||
"secret_path_override": "Anpassad direktåtkomstsökväg (valfritt)",
|
||||
"regenerate_secrets": "Generera nya anslutningshemligheter nu",
|
||||
"enable_webhook": "Fjärråtkomst via webhook",
|
||||
"enable_llm_api": "Konversationsagent LLM API",
|
||||
"llm_api_exposure": "Exponering av konversationsagentverktyg",
|
||||
"enable_startup_notification": "Startmeddelande",
|
||||
"enable_sidebar_panel": "Sidopanel för inställningar"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "Stabil installerar den senaste stabila utgåvan; Utveckling installerar den nyaste utvecklingsversionen. När automatiska uppdateringar är aktiverade, installeras den nyaste versionen av den valda kanalen vid en omladdning eller omstart, samt via en periodisk kontroll. En åsidosättning av utvecklarpaketet nedan har företräde och inaktiverar automatiska uppdateringar.",
|
||||
"auto_update": "När aktiverat installeras den nyaste utgåvan av den valda kanalen automatiskt – vid en omladdning eller omstart, och via en periodisk kontroll. När inaktiverat stannar servern på den version som för närvarande är installerad tills du aktiverar detta igen. Detta styr endast ha-mcp-serverpaketet; uppdateringar till själva HA-MCP Anpassade Komponent kommer fortfarande via HACS.",
|
||||
"server_port": "Porten som denna server lyssnar på. Ha-mcp-appen (tillägget) använder 9583, så standardvärdet är 9584 för att låta båda köra sida vid sida – om du inte kör appen (tillägget) fungerar vilken ledig port som helst.",
|
||||
"bind_host": "Vem som kan ansluta direkt till MCP-serverporten. Standardvärdet matchar appen (tillägget): nås på ditt lokala nätverk, med den hemliga sökvägen som autentiseringsuppgift. Välj loopback för att endast tillåta anslutningar från själva Home Assistant-maskinen – webhook-URL:en och sidofältsspanelen fungerar oavsett vilket.",
|
||||
"webhook_auth": "Hur MCP-klienter autentiserar sig vid webhook-URL:en. Med den hemliga URL:en är länken i sig den enda autentiseringsuppgiften – OAuth körs fortfarande för klienter som använder det, men varje inloggning godkänns automatiskt: ingen inloggning och inget klient-ID eller hemlighet behövs. Med Home Assistant-inloggning loggar klienter som claude.ai in med ett Home Assistant-administratörskonto (OAuth). Med äldre OAuth kör denna integration sin egen inloggningstjänst och utfärdar ett klient-ID och en hemlighet att klistra in i klienter som kräver ett – en omstart av Home Assistant kan behövas för att helt aktivera eller inaktivera det.",
|
||||
"oauth_client_id_override": "Ersätter det automatiskt genererade äldre OAuth-klient-ID:t. Lämna tomt för att behålla det nuvarande. Används endast när autentiseringsläget är inställt på äldre OAuth.",
|
||||
"oauth_client_secret_override": "Ersätter den automatiskt genererade äldre OAuth-klienthemligheten. Lämna tomt för att behålla den nuvarande. Används endast när autentiseringsläget är inställt på äldre OAuth.",
|
||||
"oauth_regenerate": "Engångsåtgärd: skapar ett nytt klient-ID och hemlighet för äldre OAuth-läge. Det träder i kraft först efter den Home Assistant-omstart som reparationsmeddelandet ber om – tills du startar om fortsätter det tidigare klient-ID:t och hemligheten att fungera och de nya gör det inte. Rensar även de två åsidosättningsfälten ovan.",
|
||||
"pip_spec": "Lämna tomt. Endast för att testa en specifik ha-mcp-version (till exempel en förhandsversion); åsidosätter utgivningskanalen och inaktiverar automatiska uppdateringar tills det rensas.",
|
||||
"server_url": "URL:en som den inbyggda servern använder för att nå din Home Assistant (vanligtvis denna instans själv). Lämna tomt för att härleda den från denna instans port- och SSL-inställningar; ange ett värde endast när servern behöver en annan rutt.",
|
||||
"external_url": "Visas som den primära anslutnings-URL:en – använd detta när Home Assistant ligger bakom din egen domän eller omvänd proxy. Ange den fullständiga basadressen inklusive schemat. Den måste peka direkt på Home Assistant – att öppna den i en webbläsare ska nå din HA-inloggningssida – och får inte innehålla en port som :8123 (eller någon annan port), annars kommer fjärranslutna MCP-klienter inte att kunna nå den. Lämna tomt för att automatiskt använda Nabu Casa / den lokala adressen.",
|
||||
"webhook_id_override": "Ersätter den slumpmässiga webhook-hemligheten i anslutnings-URL:en (/api/webhook/...). URL:en är autentiseringsuppgiften – använd ett långt, svårt att gissa värde. Lämna tomt för att behålla den nuvarande.",
|
||||
"secret_path_override": "Ersätter den slumpmässiga sökvägen som används för direktåtkomst på serverporten. Samma regel: sökvägen är autentiseringsuppgiften. Lämna tomt för att behålla den nuvarande.",
|
||||
"regenerate_secrets": "Engångsåtgärd: skapar en ny slumpmässig webhook-hemlighet och direktåtkomstsökväg, vilket omedelbart ogiltigförklarar de gamla anslutnings-URL:erna. Rensar även de två åsidosättningsfälten ovan.",
|
||||
"enable_webhook": "Stäng av för endast-lokalt-läge: Home Assistant-webhooken registreras inte alls, så ingenting – inklusive Nabu Casa – kan nå servern via Home Assistant. Den direkta serverporten och sidopanelen fortsätter att fungera.",
|
||||
"enable_llm_api": "Erbjud hela verktygsuppsättningen till Home Assistant-konversationsagenter (OpenAI, Google, Ollama, ...): när aktiverat kan agenter välja 'HA-MCP Server' under Kontrollera Home Assistant och styra verktygen från Assist-chatt och röst. Aktivering gör det bara valbart – inget exponeras förrän du väljer det på en agent. Användarhandbok: {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Form på verktygsuppsättningen som erbjuds konversationsagenter. Verktygssökning (standard) håller agentens kontext liten: ett kompakt API med fästa verktyg plus sök-/exekvera-metaverktyg. Fullständig katalog listar varje exponerat verktyg direkt – bättre för modeller med stor kontext. Båda registrerar de två sida vid sida så att varje agent väljer sin egen under Kontrollera Home Assistant. Exponering per verktyg hanteras i HA-MCP-inställningspanelen; detaljer: {llm_api_docs_url}",
|
||||
"enable_startup_notification": "Visa en avisering varje gång servern startar, som pekar på de endast-för-administratörer-inställningsytorna. Stäng av för att starta tyst – anslutnings-URL:erna visas fortfarande i Home Assistant-loggen.",
|
||||
"enable_sidebar_panel": "Visa HA-MCP-inställningspanelen i sidofältet (endast administratörer). Stäng av för att ta bort sidofältsinlägget – serveralternativen förblir tillgängliga på denna skärm."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "HA-MCP-servern i processen misslyckades att starta",
|
||||
"description": "HA-MCP-servern i processen kunde inte startas inuti Home Assistant:\n\n{detail}\n\nKontrollera Home Assistant-loggarna, ladda sedan om integrationen (eller åtgärda det underliggande problemet och ladda om) för att försöka igen."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "HA-MCP-serverpaketet i processen kunde inte installeras",
|
||||
"description": "Installationen av ha-mcp-paketet för servern i processen misslyckades:\n\n{detail}\n\nLös kompatibilitets- eller installationsproblemet som beskrivs ovan, ladda sedan om integrationen för att försöka igen."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "Uppdatera HA-MCP Custom Component via HACS",
|
||||
"description": "Den installerade ha-mcp-servern kräver HA-MCP Custom Component {required} eller nyare, men du har {installed}. Uppdatera komponenten via HACS (öppna HA-MCP Custom Component-posten och använd 'Uppdatera information' om ingen uppdatering visas ännu) och starta om Home Assistant. Servern fortsätter att köra under tiden, men vissa nyare funktioner kanske inte fungerar förrän komponenten är uppdaterad."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "HA-MCP-serveruppdatering väntar på en komponentuppdatering",
|
||||
"description": "ha-mcp-server {latest} är tillgänglig, men den versionen uppdaterade också HA-MCP Custom Component (till {shipped}; du kör {running}). För att undvika att starta en serverversion som den körande komponenten aldrig har testats med, är den automatiska serveruppdateringen pausad tills komponenten är uppdaterad.\n\nUppdatera komponenten via HACS (öppna HA-MCP Custom Component-posten och använd 'Uppdatera information' om ingen uppdatering visas ännu), starta sedan om Home Assistant – serveruppdateringen installeras automatiskt därefter. För att installera serveruppdateringen ändå, tryck på Installera på HA-MCP-serveruppdateringsentiteten."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "Komponenten installerad från det äldre arkivet",
|
||||
"description": "HACS spårar huvudförrådet för ha-mcp-servern för denna komponent, så HACS visar serverns versionsnummer och versionsanteckningar här istället för komponentens egna (2.x). Uppdateringar fortsätter att fungera, men förblir felmärkta på detta sätt. För att åtgärda: ta bort detta förråd från HACS (dina integrationsinställningar och konfigurationsposter behålls), lägg till homeassistant-ai/ha-mcp-integration som ett anpassat förråd, installera om komponenten från det, och starta om Home Assistant."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "Starta om Home Assistant för att tillämpa de äldre OAuth-inställningarna",
|
||||
"fix_flow": {
|
||||
"step": {
|
||||
"confirm": {
|
||||
"title": "Starta om Home Assistant?",
|
||||
"description": "Att skicka in detta formulär kommer att starta om Home Assistant och tillämpa de äldre OAuth-inställningarna.\n\nKlicka på **Skicka** för att starta om nu."
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Stabil (rekommenderas)",
|
||||
"dev": "Utveckling (senaste bygget)"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "Hemlig webhook-URL (standard)",
|
||||
"ha_auth": "Logga in med Home Assistant (OAuth)",
|
||||
"legacy": "Äldre OAuth (denna integration utfärdar ett klient-ID/en hemlighet att klistra in)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "Verktygssökning (kompakt, standard)",
|
||||
"full": "Fullständig katalog",
|
||||
"both": "Båda (välj per agent)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "Uppdatera"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Direktåtkomst från Home Assistant-maskinen: {url}",
|
||||
"connect_local_lan": "Lokalt/LAN (när Nätverksåtkomst är \"Local network\"): {url}",
|
||||
"connect_remote_url": "Fjärranslutnings-URL: {url}",
|
||||
"connect_urls_label": "Anslutnings-URL(er):",
|
||||
"connect_urls_pending": "Anslutnings-URL:erna visas här (och i Home Assistant-loggen) när servern har startat.",
|
||||
"connect_webhook_disabled": "Fjärråtkomst via webhook är inaktiverad (endast-lokalt-läge).",
|
||||
"oauth_creds_pending": "Klient-ID och klienthemlighet visas här när servern har startat.",
|
||||
"oauth_not_serving": "Legacy OAuth tillhandahåller dem inte ännu — starta om Home Assistant när du blir ombedd, så aktiveras de.",
|
||||
"oauth_select_legacy_mode": "Ställ in autentiseringsläge till äldre OAuth ovan och spara för att generera ett klient-ID och en klienthemlighet.",
|
||||
"panel_hint": "Öppna [HA-MCP-inställningspanelen](/ha-mcp) för verktygshantering och serverinställningar.",
|
||||
"tools_module_installed": "Beta/avancerad fil- & YAML-verktygsmodul (valfritt): Installerad",
|
||||
"tools_module_not_installed": "Beta/avancerad fil- & YAML-verktygsmodul (valfritt): Ej installerad — tryck på \"Lägg till post\" på denna integrationssida och välj \"HA-MCP File & YAML Tools\" för att lägga till den",
|
||||
"tools_module_not_loaded": "Beta/avancerad fil- & YAML-verktygsmodul (valfritt): Installerad men inte laddad — aktivera eller ladda om posten \"HA-MCP File & YAML Tools\" på denna integrationssida",
|
||||
"version_line": "Komponent {component_version} - Server ha-mcp {server_version} ({channel}-kanal)",
|
||||
"version_not_installed": "inte installerad ännu",
|
||||
"version_unknown": "okänd"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,161 @@
|
||||
{
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "HA-MCP component le'",
|
||||
"description": "Doch Dachel DaneHbogh yIwIv. Home Assistant qoDaq ha-mcp turwI' naQ QapmoH **HA-MCP Server**, 'ej Home Assistant webhook vegh latlhvaD 'ang. jomlu'meH mIwvam luwIv lo'wI'pu' HochHom. nIteb Qap turwI'vam, 'ej jomlu'meH mIw latlh Hoch (add-on, Docker, uvx/PyPI, stdio) qa'chu'; Dalo'chugh, mIwvetlh latlh yIQapmoHQo'. 'a'baqa' YAML je choHmeH patmey le' chel **HA-MCP 'a'baqa' & YAML janmey**; ha-mcp 'a'baqa'/YAML janmey wIvlu'bogh Dachu'chugh neH poQlu'. latlh DaqDaq (add-on, Docker, uvx) Qapchugh ha-mcp turwI'lIj, turwI' De' 'ay' DapoQbe' - 'a'baqa' & YAML De' 'ay'vam neH yIchel, 'ej janmeyvetlh Dalo'chugh neH yIchel. turwI' Segh HochvaD Qap, 'ej pa'QDI' vay' DaH chellaH.",
|
||||
"menu_options": {
|
||||
"server": "HA-MCP Server (chup)",
|
||||
"tools": "HA-MCP 'a'baqa' & YAML janmey (wIvlaH)"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "HA-MCP 'a'baqa' & YAML janmey",
|
||||
"description": "'a'baqa' YAML config je choHmeH patmey chaw' le' ghajbogh cher. ha-mcp 'a'baqa'/YAML choHmeH janmey wIvlu'bogh Dachu'chugh neH poQlu' (DuH SeHwI'mey; motlh chu'Ha'lu') - turwI' Segh HochvaD, HA-MCP Server QaptaHboghvaD je Qap. De' 'ay'vam chellaH pagh teqlaH vay' poH Hoch."
|
||||
},
|
||||
"server": {
|
||||
"title": "HA-MCP Server",
|
||||
"description": "Home Assistant qoDaq ha-mcp turwI' naQ QapmoH, 'ej Home Assistant webhook vegh HopDaq 'ang (Nabu Casa proxy ghap vegh naw'laH). nIteb Qap turwI'vam, 'ej add-on, Docker, uvx/PyPI, stdio jomlu'meH mIwmey qa'chu' - latlh ha-mcp turwI' retlhDaq yIQapmoHQo'. QapchoHmeH **ngeH** yIwIv; ghIq integration DuHmeyDaq port, binding, chaw' 'olmeH mIw je DachoHlaH."
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "De' 'ay'vam cherlu'pu'.",
|
||||
"unsupported_home_assistant": "Home Assistant {required} ghap Dotlh chu' law' poQ HA-MCP Server QaptaHbogh, 'ach {installed} lo' patvam. componentvam HA-MCP File & YAML Tools De' 'ay' Dalo'taHlaH; add-on Docker container ghapDaq Qapbogh ha-mcp turwI' Hur retlhDaq Qap."
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "HA-MCP 'a'baqa' & YAML janmey",
|
||||
"description": "ha-mcp 'a'baqa'/YAML janmey wIvlu'bogh lo'bogh 'a'baqa' YAML choHmeH patmey le' yIcher. ha-mcp turwI' DuHmey UI-Daq DuHmeyvam leghlu' je, 'ej SIbI' Qap; pagh Dataghqa'moHnIS. Daqmey pegh (chovnatlh .storage) 'ej Hung veH ngoqmey (homeassistant, http, frontend, lovelace) bottaH botwI' bIngHom; juSlaH pagh.",
|
||||
"data": {
|
||||
"allowed_dirs": "'a'baqa' ghajwI' Daqmey latlh",
|
||||
"extra_yaml_keys": "YAML ghItlhmeH lIwmey chelbogh"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "config ghajwI' Daq'e' bopbogh Daqmey; HochvaD laDmeH ghItlhmeH je chaw' noblu' (chovnatlh pyscript). Daq veghlu'bogh 'ej config HurDaq 'oHbogh De' 'ay'mey luteqlu'.",
|
||||
"extra_yaml_keys": "ngoqmey jen'e' ghItlhlaH ha_config_set_yaml, ngoqmey motlh chellu'bogh retlhDaq; jomlu'bogh patvamDaq YAML wa'DIch lo'bogh integrationsvaD (chovnatlh alert2). Hung veH ngoqmey luteqlu'."
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "HA-MCP Server",
|
||||
"description": "HA-MCP turwI' yIcher. {panel_hint}polDI' choHmeyvam lo'lu'.\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "Dotlh He",
|
||||
"auto_update": "nuv vangnISbe'taHvIS turwI' yIchu'moH",
|
||||
"server_port": "MCP turwI' Qum lojmIt",
|
||||
"bind_host": "rarmeH naw'",
|
||||
"webhook_auth": "chaw' 'olmeH mIw",
|
||||
"oauth_client_id_override": "OAuth ngo': Client ID le' (wIvlaH)",
|
||||
"oauth_client_secret_override": "OAuth ngo': Client Secret le' (wIvlaH)",
|
||||
"oauth_regenerate": "OAuth ngo': DaH Client ID/Secret yIchenqa'moH",
|
||||
"pip_spec": "ghunwI': ha-mcp package le' yIlo'",
|
||||
"server_url": "Home Assistant URL ('Itlh)",
|
||||
"external_url": "URL Hur (wIvlaH)",
|
||||
"webhook_id_override": "webhook pegh le' (wIvlaH)",
|
||||
"secret_path_override": "naw' He le' (wIvlaH)",
|
||||
"regenerate_secrets": "DaH rarmeH peghmey yIchenqa'moH",
|
||||
"enable_webhook": "webhook vegh Hop naw' yIQotlhHa'",
|
||||
"enable_llm_api": "Qum-agent LLM API",
|
||||
"llm_api_exposure": "Qum-agentvaD janmey 'angmeH mIw",
|
||||
"enable_startup_notification": "QapchoH QIn yIQotlhHa'",
|
||||
"enable_sidebar_panel": "Dop UI DuHmey jIH yIQotlhHa'"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "Dotlh Qapchu'bogh wIvlu'chugh, release Qapchu'bogh chu'qu' jomlu'; ghunmeH Dotlh wIvlu'chugh, development build chu'qu' jomlu'. turwI' chu'moHmeH pat chu'lu'chugh, integration pagh Home Assistant taghqa'moHlu'DI', 'ej roD nuDlu'DI', He wIvlu'bogh build chu'qu' jom pat. bIngDaq ghunwI' package le' wIvlu'chugh, wa'DIch 'oH 'ej turwI' chu'moHmeH pat chu'Ha'moH.",
|
||||
"auto_update": "chu'lu'chugh, integration pagh Home Assistant taghqa'moHlu'DI', 'ej roD nuDlu'DI', He wIvlu'bogh release chu'qu' jom turwI' chu'moHmeH pat. chu'Ha'lu'chugh, Dotlh jomlu'bogh lo'taH turwI', latlhlogh DuHvam Dachu'pa'. ha-mcp turwI' package neH SeH; HACS vegh ghoS HA-MCP Custom Component De' chu'.",
|
||||
"server_port": "Qum lojmItvamDaq 'Ij turwI'vam. 9583 lo' ha-mcp add-on, vaj 9584 motlh lo' turwI'vam, cha' turwI'pu' retlhDaq QaplaHmeH - add-on Dalo'be'chugh, Qum lojmIt tlhab Dalo'laH.",
|
||||
"bind_host": "MCP turwI' Qum lojmItvaD rarlaHbogh ghotpu' SeH. add-on rur DuH motlh: SIr'o' Sumvo' naw'laH vay', 'ej pegh He 'oH chaw'e'. Home Assistant jan neHvo' rarmeH loopback yIwIv - webhook URL Dop jIH je QaptaH.",
|
||||
"webhook_auth": "webhook URL-Daq ghoSmeH, paghDaq chaw' ghaj 'e' 'ol MCP nIqHommey. pegh URL lo'lu'chugh, chaw' 'oH URL'e'. Home Assistant sign-in lo'lu'chugh, Home Assistant loHwI' mab lo'ta' claude.ai rur nIqHom (OAuth). OAuth ngo' lo'lu'chugh, integrationvam Client ID Secret je chenmoH; Google Gemini Spark rur nIqHom poQboghDaq lanlu'. Dachu'DI' pagh Dachu'Ha'DI' Home Assistant Dataghqa'moHnIS.",
|
||||
"oauth_client_id_override": "OAuth ngo' Client ID chenmoH pat; 'oH qa' DuHvam. chIm yIpol Client ID DaH lo'lu'bogh polmeH. chaw' 'olmeH mIw 'oHtaH OAuth ngo' neH lo'lu'.",
|
||||
"oauth_client_secret_override": "OAuth ngo' Client Secret chenmoH pat; 'oH qa' DuHvam. chIm yIpol Client Secret DaH lo'lu'bogh polmeH. chaw' 'olmeH mIw 'oHtaH OAuth ngo' neH lo'lu'.",
|
||||
"oauth_regenerate": "wa'logh vang: OAuth ngo' mIwvamvaD Client ID Secret je chu' chenmoH. repair QIn poQbogh Home Assistant Dataghqa'moHpu'DI' neH QapchoH - Home Assistant Dataghqa'moHpa', Client ID Secret je ngo' QaptaH, 'ej chu' Qapbe'. bIngDaq override 'ay'mey cha' chImmoH je.",
|
||||
"pip_spec": "chIm yIpol. ha-mcp build le' neH wa'logh nIDmeH lo' (chovnatlh pre-release pin); release He qa', 'ej chImmoHlu'pa' turwI' chu'moHmeH pat chu'Ha'moH.",
|
||||
"server_url": "Home AssistantlIj naw'meH turwI' QaptaHbogh lo'bogh URL (motlh patvam'e'). chIm yIpol patvam Qum lojmIt SSL DuHmey jevo' chenmoHmeH; latlh He poQ turwI' neHchugh, De' yIlan.",
|
||||
"external_url": "rarmeH URL wa'DIch 'anglu' - domainlIj proxy ghap 'emDaq ba'chugh Home Assistant, URLvam yIlo'. scheme ngaSbogh Quv wa'DIch naQ yIlan. Home Assistant neH ghoS net poQ - web leghwI'Daq DapoSmoHDI', HA login jIH Daghaj net poQ - 'ej :8123 rur port ghajbe'nIS (latlh port je), pagh Hop MCP nIqHommey naw'laHbe'. chIm yIpol; vaj Nabu Casa Quv Sum ghap wIv pat.",
|
||||
"webhook_id_override": "rarmeH URL (/api/webhook/...)Daq webhook pegh chenmoH pat; peghvetlh qa' DuHvam. chaw' 'oH URL'e' - nI'bogh, ghItlh Qatlhbogh De' yIlo'. chIm yIpol pegh DaH lo'lu'bogh polmeH.",
|
||||
"secret_path_override": "turwI' Qum lojmItDaq naw'meH He pIQ chenmoH pat; Hevetlh pegh, 'ej Hevetlh qa' DuHvam. rap chut: chaw' 'oH He'e'. chIm yIpol He DaH lo'lu'bogh polmeH.",
|
||||
"regenerate_secrets": "wa'logh vang: webhook pegh chu' chenmoH pat, 'ej turwI' Qum lojmItDaq naw'meH He pIQ chenmoHqa' pat, vaj SIbI' QapHa' rarmeH URLmey ngo'. bIngDaq override 'ay'mey cha' chImmoH je.",
|
||||
"enable_webhook": "Sum neH mIw lo'meH yIchu'Ha': Home Assistant webhook qonta'be'lu'chu', vaj turwI'Daq Home Assistant vegh naw'laH pagh - Nabu Casa je. turwI' Qum lojmIt vegh naw'lu'meH He pIQ Dop jIH je QaptaH.",
|
||||
"enable_llm_api": "Home Assistant Qum agentsvaD janmey naQ yInob (OpenAI, Google, Ollama, ...): chu'lu'taHvIS, Control Home Assistant bIngDaq 'HA-MCP Server' wIvlaH agents, 'ej Assist chat ghogh jevo' janmey SeHlaH. chu'moHlu' neHchugh wIvlaH; agentDaq wIvbe'lu'pa' pagh 'anglu'. lo'meH paq: {llm_api_docs_url}",
|
||||
"llm_api_exposure": "Qum agentsvaD noblu'bogh jan ghom SeH. jan nej (motlh) agent context mach pol: janmey lungu'lu'bogh, nej/lo' meta-janmey je ghajbogh API mach. jan tetlh naQ 'ang mIw naQ - context tIn ghajbogh modelvaD qaq. cha' mIwmey wIvlu'chugh, cha' mIwmey retlhDaq qonta'lu', vaj Control Home Assistant bIngDaq mIwvam wIvlaH Hoch agent. HA-MCP DuHmey jIHDaq Hoch jan 'angmeH DuH SeHlu'; De' latlh: {llm_api_docs_url}",
|
||||
"enable_startup_notification": "turwI' QapchoH Hochlogh QIn yI'ang; loHwI' neHvaD DuHmey Daqmey 'ang. tamtaH QapchoHmeH yIchu'Ha' - Home Assistant QonoSDaq rarmeH URLmey leghlu'taH.",
|
||||
"enable_sidebar_panel": "DopDaq HA-MCP DuHmey jIH yI'ang (loHwI' neH). Dop De' 'ay' teqmeH yIchu'Ha' - jIHvamDaq turwI' DuHmey tu'lu'taH."
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "QapchoHlaHbe' HA-MCP turwI' QaptaHbogh",
|
||||
"description": "Home Assistant qoDaq HA-MCP turwI' QaptaHbogh QapchoHmoHlaHbe'lu':\n\n{detail}\n\nHome Assistant QonoSmey yInuD; ghIq nIDqa'meH integration yItaghqa'moH (pagh Qagh mung yItI' 'ej yItaghqa'moH)."
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "HA-MCP turwI' QaptaHbogh package jomlaHbe'lu'",
|
||||
"description": "HA-MCP turwI' QaptaHboghvaD ha-mcp package jomlu'DI' Qagh qaS:\n\n{detail}\n\nbIngDaq compatibility Qagh, jomlu'DI' Qagh ghap QIjlu'bogh yItI'; ghIq nIDqa'meH integration yItaghqa'moH."
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "HACS vegh HA-MCP Custom Component yIchu'moH",
|
||||
"description": "HA-MCP Custom Component {required} ghap chu' law' poQ ha-mcp turwI' jomlu'bogh, 'ach {installed} Daghaj. HACS vegh component yIchu'moH (HA-MCP Custom Component De' 'ay' yIpoS, 'ej De' chu' 'anglu'be'chugh 'Update information' yIlo'), ghIq Home Assistant yItaghqa'moH. qaStaHvIS QaptaH turwI', 'ach component chu'moHlu'pa' DuHmey chu' 'op Qapbe'laH."
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "component chu'moHghach loS HA-MCP turwI' chu'moHghach",
|
||||
"description": "ha-mcp turwI' {latest} tu'lu', 'ach HA-MCP Custom Component chu'moH je releasevetlh ({shipped}; {running} Dalo'taH). turwI' Dotlh'e' nIDbe'pu'bogh component QaptaHbogh QapchoHmoHlu'be'meH, component chu'moHlu'pa' turwI' chu'moHghach pat jomQo'.\n\nHACS vegh component yIchu'moH (HA-MCP Custom Component De' 'ay' yIpoS, 'ej De' chu' 'anglu'be'chugh 'Update information' yIlo'), ghIq Home Assistant yItaghqa'moH - ghIq nuv vangnISbe'taHvIS turwI' chu'moHghach jomlu'. turwI' chu'moHghach DaH jom DaneHchugh, HA-MCP turwI' chu'moHghach DolDaq jom leQ yIwIv."
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "repository ngo'vo' jomlu' component",
|
||||
"description": "componentvamvaD ha-mcp turwI' repository wa'DIch Hotlh HACS, vaj component Dotlh mI' (2.x) QInmey je 'angbe' 'ej turwI' Dotlh mI' QInmey je 'ang. chu'moHtaH HACS, 'ach pongmey muj pol. tI'meH: HACSvo' repositoryvam yIteq (integration DuHmey config De' 'ay'mey je pollu'), repository le' 'oHmeH homeassistant-ai/ha-mcp-integration yIchel, componentvo' yIjomqa', 'ej Home Assistant yItaghqa'moH."
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "OAuth ngo' choH lo'meH Home Assistant yItaghqa'moH",
|
||||
"description": "OAuth ngo' chaw' 'olmeH mIw /authorize /token web endpoints ghajbogh'e' qon; Home Assistant naQ taghqa'moHlu'DI' neH rarlaH pagh rarHa'laH - mIwvam Dachu'pu'chugh, Dachu'Ha'pu'chugh, pagh Client ID/Secret DachoHpu'chugh je, rap ghu'. choH lo'meH Home Assistant yItaghqa'moH (Settings - System - Restart); Home Assistant Dataghqa'moHpa' QaptaH mIw ngo'."
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "Dotlh Qapchu'bogh (chup)",
|
||||
"dev": "ghunmeH Dotlh (build chu'qu')"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "webhook URL pegh (motlh)",
|
||||
"ha_auth": "Home Assistant lo'taHvIS yI'el (OAuth)",
|
||||
"legacy": "OAuth ngo' (Client ID/Secret; Google Gemini SparkvaD)"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "jan nej (mach, motlh)",
|
||||
"full": "janmey naQ",
|
||||
"both": "cha' mIwmey (Hoch agentvaD yIwIv)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "chu'moH"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "Home Assistant janvo' naw' pIQ: {url}",
|
||||
"connect_local_lan": "SIr'o' Sum/LAN (rarmeH naw'Daq \"Local network\" wIvlu'chugh): {url}",
|
||||
"connect_remote_url": "Daq Hopvo' rarmeH URL: {url}",
|
||||
"connect_urls_label": "rarmeH URLmey:",
|
||||
"connect_urls_pending": "turwI' QapchoHpu'DI', naDev rarmeH URLmey 'anglu', 'ej Home Assistant QonoSDaq 'anglu' je.",
|
||||
"connect_webhook_disabled": "Daq Hopvo' webhook lo'bogh naw' Qotlhlu' (Daq Sumvo' neH naw'lu').",
|
||||
"oauth_creds_pending": "turwI' QapchoHpu'DI', naDev Client ID, Client Secret je 'anglu'.",
|
||||
"oauth_not_serving": "wej Dochmeyvam laj OAuth ngo' — Home Assistant Dataghqa'moH 'e' tlhoblu'DI', QapchoHmeH Dochmeyvam Home Assistant yItaghqa'moH.",
|
||||
"oauth_select_legacy_mode": "DungDaq chaw' 'olmeH mIwvaD OAuth ngo' yIwIv 'ej Client ID Client Secret je chenmoHlu'meH yIpol.",
|
||||
"panel_hint": "janmey Davu'meH 'ej turwI' DuHmey DachermeH [HA-MCP SeHlaw](/ha-mcp) yIpoSmoH.",
|
||||
"tools_module_installed": "'a'baqa' & YAML janmey bobcho' (Beta/'Itlh; wIvlaH): jomlu'pu'",
|
||||
"tools_module_not_installed": "'a'baqa' & YAML janmey bobcho' (Beta/'Itlh; wIvlaH): jomlu'be' — navvamDaq \"De' 'ay' chel\" yI'uy, 'ej bobcho'vam DachelmeH \"HA-MCP File & YAML Tools\" yIwIv",
|
||||
"tools_module_not_loaded": "'a'baqa' & YAML janmey bobcho' (Beta/'Itlh; wIvlaH): jomlu'pu' 'ach QaptaHbe' — navvamDaq \"HA-MCP File & YAML Tools\" De' 'ay' yIQotlhHa' pagh yItaghqa'moH",
|
||||
"version_line": "component {component_version} - ha-mcp turwI' {server_version} ({channel} Dotlh He)",
|
||||
"version_not_installed": "wej jomlu'",
|
||||
"version_unknown": "Sovbe'lu'"
|
||||
}
|
||||
}
|
||||
@@ -1,161 +1,168 @@
|
||||
{
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "HA-MCP 自定义组件",
|
||||
"description": "选择要添加的内容。**HA-MCP 服务器**在 Home Assistant 内部运行完整的 ha-mcp 服务器，并通过 Home Assistant Webhook 对外提供服务——这是大多数用户需要的安装方式。它是一个独立的服务器，可完全取代其他所有安装方式（插件、Docker、uvx/PyPI、stdio）；如果运行它，就不要再同时运行其中任何一种。**HA-MCP 文件与 YAML 工具**添加特权文件和 YAML 编辑服务，仅在您启用 ha-mcp 的可选文件/YAML 工具时才需要。如果您的 ha-mcp 服务器已在别处运行（插件、Docker、uvx），则不需要服务器条目——只添加这个文件与 YAML 条目，并且仅在您使用这些工具时才添加。它适用于所有服务器类型，随时可以后续添加。",
|
||||
"menu_options": {
|
||||
"server": "HA-MCP 服务器（推荐）",
|
||||
"tools": "HA-MCP 文件与 YAML 工具（可选）"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "HA-MCP 文件与 YAML 工具",
|
||||
"description": "设置特权文件和 YAML 配置服务。仅在您启用 ha-mcp 的可选文件/YAML 编辑工具（功能开关，默认关闭）时才需要——这适用于所有服务器类型，包括进程内的 HA-MCP 服务器。您可以随时添加或移除此条目。"
|
||||
},
|
||||
"server": {
|
||||
"title": "HA-MCP 服务器",
|
||||
"description": "这会在 Home Assistant 内部运行完整的 ha-mcp 服务器，并通过 Home Assistant Webhook 远程提供服务（可经由 Nabu Casa 或任意反向代理访问）。它是一个独立的服务器，可完全取代插件、Docker、uvx/PyPI 和 stdio 安装方式——不要与其他 ha-mcp 服务器同时运行。选择**提交**以启动它；启动后可在集成选项中更改端口、绑定方式和身份验证。"
|
||||
}
|
||||
},
|
||||
"abort": {
|
||||
"already_configured": "此条目已配置。",
|
||||
"unsupported_home_assistant": "进程内 HA-MCP 服务器需要 Home Assistant {required} 或更高版本，但此实例运行的是 {installed}。您仍可将本组件的 HA-MCP File & YAML Tools 条目与以插件或 Docker 容器方式运行的外部 ha-mcp 服务器搭配使用。"
|
||||
"config": {
|
||||
"step": {
|
||||
"user": {
|
||||
"title": "HA-MCP 自定义组件",
|
||||
"description": "选择要添加的内容。**HA-MCP Server** 在 Home Assistant 内部运行完整的 ha-mcp 服务器，并通过 Home Assistant webhook 将其暴露——这是大多数人想要的安装方式。它是一个独立的服务器，可完全替代所有其他安装方法：App (add-on)、Docker、uvx/PyPI、stdio；如果您运行了它，请勿同时运行其他安装方式。**HA-MCP File & YAML Tools** 有两个作用。如果您的 ha-mcp server 运行在 Home Assistant 外部（app、Docker、uvx/PyPI、stdio），此条目还可为该服务器提供其无法从外部访问的进程内组件功能（快速进程内搜索、配置条目元数据、注册表支持的读取），因此非常值得添加到每个外部安装中，并且它还是 ha-mcp 的可选文件/YAML 工具所使用的特权文件与 YAML 编辑服务的访问控制关卡。如果您改为添加 HA-MCP Server 条目，该条目已提供这些共享功能，因此该第二个条目此时仅用作可选文件/YAML 工具的访问控制关卡。它适用于所有服务器类型，并且可以随时在以后添加。",
|
||||
"menu_options": {
|
||||
"server": "HA-MCP 服务器（推荐）",
|
||||
"tools": "HA-MCP 文件与 YAML 工具（可选）"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"title": "HA-MCP 文件与 YAML 工具",
|
||||
"description": "设置特权文件和 YAML 配置服务，这些服务受控于 ha-mcp 的可选文件/YAML 编辑工具（功能标志，默认关闭）——这适用于所有服务器类型，包括进程内的 HA-MCP Server。如果您的 ha-mcp server 运行在 Home Assistant 外部，此条目还会为其提供无法从外部访问的进程内组件功能（快速进程内搜索、配置条目元数据、注册表支持的读取），即使关闭文件/YAML 工具，这些功能也非常值得拥有。您可以随时添加或删除此条目。"
|
||||
},
|
||||
"server": {
|
||||
"title": "HA-MCP 服务器",
|
||||
"description": "这会在 Home Assistant 内部运行完整的 ha-mcp 服务器，并通过 Home Assistant Webhook 将其远程公开（可通过 Nabu Casa 或任何反向代理访问）。这是一个独立的服务器，可完全替代 app (add-on)、Docker、uvx/PyPI 和 stdio 安装方式——请勿将其与其他 ha-mcp 服务器同时运行。选择**提交**以启动它；您随后可以在集成选项中更改端口、绑定和身份验证。"
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "HA-MCP 文件与 YAML 工具",
|
||||
"description": "配置 ha-mcp 可选文件/YAML 工具所使用的特权文件和 YAML 编辑服务。这些设置也会出现在 ha-mcp 服务器自身的设置界面中，并实时生效，无需重启。不可覆盖的拒绝底线仍会阻止敏感路径（例如 .storage）和信任边界键（homeassistant、http、frontend、lovelace）。",
|
||||
"data": {
|
||||
"allowed_dirs": "额外的文件目录",
|
||||
"extra_yaml_keys": "额外的 YAML 可写键"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "相对于配置目录的目录，每个目录都授予读写权限（例如 pyscript）。路径穿越以及配置目录之外的条目会被丢弃。",
|
||||
"extra_yaml_keys": "除内置键外，ha_config_set_yaml 还可写入的顶层键，适用于本安装中以 YAML 为主的集成（例如 alert2）。信任边界键会被丢弃。"
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "HA-MCP 服务器",
|
||||
"description": "配置 HA-MCP 服务器。{panel_hint}此处的更改在保存时应用。\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "发布通道",
|
||||
"auto_update": "服务器自动更新",
|
||||
"server_port": "MCP 服务器监听端口",
|
||||
"bind_host": "网络访问",
|
||||
"webhook_auth": "身份验证模式",
|
||||
"oauth_client_id_override": "旧版 OAuth：自定义 Client ID（可选）",
|
||||
"oauth_client_secret_override": "旧版 OAuth：自定义 Client Secret（可选）",
|
||||
"oauth_regenerate": "旧版 OAuth：立即重新生成 Client ID/Secret",
|
||||
"pip_spec": "开发者：ha-mcp 软件包覆盖",
|
||||
"server_url": "Home Assistant URL（高级）",
|
||||
"external_url": "外部 URL（可选）",
|
||||
"webhook_id_override": "自定义 Webhook 密钥（可选）",
|
||||
"secret_path_override": "自定义直连路径（可选）",
|
||||
"regenerate_secrets": "立即重新生成连接密钥",
|
||||
"enable_webhook": "通过 Webhook 远程访问",
|
||||
"enable_llm_api": "对话智能体 LLM API",
|
||||
"llm_api_exposure": "对话智能体工具暴露方式",
|
||||
"enable_startup_notification": "启动通知",
|
||||
"enable_sidebar_panel": "侧边栏设置面板"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "稳定版安装最新的稳定发行版；开发版安装最新的开发构建。启用自动更新后，重新加载或重启以及定期检查都会安装所选通道的最新构建。下方的开发者软件包覆盖优先级更高，并会禁用自动更新。",
|
||||
"auto_update": "启用时，所选通道的最新发行版会自动安装——在重新加载或重启时，以及通过定期检查。关闭时，服务器会保持当前已安装的版本，直到您重新启用此项。它仅控制 ha-mcp 服务器软件包；HA-MCP 自定义组件自身的更新仍通过 HACS 进行。",
|
||||
"server_port": "此服务器监听的端口。ha-mcp 插件使用 9583，因此这里默认为 9584，以便两者并存——如果您不运行该插件，任何空闲端口都可以。",
|
||||
"bind_host": "谁可以直接连接到 MCP 服务器端口。默认值与插件一致：可在本地网络中访问，并以密钥路径作为凭据。选择 loopback 则仅允许来自 Home Assistant 所在主机的连接——无论哪种方式，Webhook URL 和侧边栏面板都能正常工作。",
|
||||
"webhook_auth": "MCP 客户端在 Webhook URL 上如何证明自己的身份。使用密钥 URL 时，链接本身就是凭据。使用 Home Assistant 登录时，claude.ai 等客户端会以 Home Assistant 管理员账户登录（OAuth）。使用旧版 OAuth 时，此集成会签发自己的 Client ID 和 Secret，供需要它们的客户端（例如 Google Gemini Spark）粘贴使用——开启或关闭该模式需要重启 Home Assistant。",
|
||||
"oauth_client_id_override": "替换自动生成的旧版 OAuth Client ID。留空则保留当前值。仅在身份验证模式设为旧版 OAuth 时使用。",
|
||||
"oauth_client_secret_override": "替换自动生成的旧版 OAuth Client Secret。留空则保留当前值。仅在身份验证模式设为旧版 OAuth 时使用。",
|
||||
"oauth_regenerate": "一次性操作：为旧版 OAuth 模式生成新的 Client ID 和 Secret。它只有在修复提示所要求的 Home Assistant 重启之后才会生效——在您重启之前，原有的 Client ID 和 Secret 仍然有效，新的尚未启用。同时会清空上面两个覆盖字段。",
|
||||
"pip_spec": "请留空。仅用于测试特定的 ha-mcp 构建（例如固定到某个预发行版）；它会覆盖发布通道，并在清空之前禁用自动更新。",
|
||||
"server_url": "进程内服务器用于访问您的 Home Assistant 的 URL（通常就是此实例本身）。留空则根据此实例的端口和 SSL 设置推导；仅在服务器需要走其他路由时才设置。",
|
||||
"external_url": "作为主要连接 URL 显示——当 Home Assistant 位于您自己的域名或反向代理之后时使用。请输入包含协议在内的完整基础地址。它必须直接指向 Home Assistant——在浏览器中打开它应能到达您的 HA 登录页面——并且不能包含 :8123 之类的端口（任何端口都不行），否则远程 MCP 客户端将无法访问。留空则自动使用 Nabu Casa / 本地地址。",
|
||||
"webhook_id_override": "替换连接 URL（/api/webhook/...）中随机生成的 Webhook 密钥。该 URL 就是凭据——请使用足够长、难以猜测的值。留空则保留当前值。",
|
||||
"secret_path_override": "替换在服务器端口上用于直连的随机路径。规则相同：该路径就是凭据。留空则保留当前值。",
|
||||
"regenerate_secrets": "一次性操作：生成新的随机 Webhook 密钥和直连路径，并立即使旧的连接 URL 失效。同时会清空上面两个覆盖字段。",
|
||||
"enable_webhook": "关闭以进入仅本地模式：完全不注册 Home Assistant Webhook，因此任何一方——包括 Nabu Casa——都无法通过 Home Assistant 访问服务器。服务器端口直连和侧边栏面板仍可继续使用。",
|
||||
"enable_llm_api": "向 Home Assistant 对话智能体（OpenAI、Google、Ollama 等）提供完整工具集：启用后，智能体可在“控制 Home Assistant”下选择“HA-MCP Server”，并在 Assist 聊天和语音中使用这些工具。启用只是让它可供选择——在您为某个智能体选中它之前，不会暴露任何内容。使用指南：{llm_api_docs_url}",
|
||||
"llm_api_exposure": "提供给对话智能体的工具集形态。工具搜索（默认）可让智能体的上下文保持精简：一个包含固定工具以及搜索/执行元工具的紧凑 API。完整目录会直接列出每个已暴露的工具——更适合大上下文模型。两者会将二者并列注册，让每个智能体在“控制 Home Assistant”下各自选择。按工具的暴露设置在 HA-MCP 设置面板中管理；详情：{llm_api_docs_url}",
|
||||
"enable_startup_notification": "每次服务器启动时显示通知，指向仅管理员可见的设置界面。关闭则静默启动——连接 URL 仍会出现在 Home Assistant 日志中。",
|
||||
"enable_sidebar_panel": "在侧边栏中显示 HA-MCP 设置面板（仅管理员）。关闭则移除侧边栏条目——服务器选项仍可在此界面中使用。"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "HA-MCP 进程内服务器启动失败",
|
||||
"description": "无法在 Home Assistant 内部启动 HA-MCP 进程内服务器：\n\n{detail}\n\n请检查 Home Assistant 日志，然后重新加载该集成（或先修复根本问题再重新加载）以重试。"
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "无法安装 HA-MCP 进程内服务器软件包",
|
||||
"description": "为进程内服务器安装 ha-mcp 软件包失败：\n\n{detail}\n\n请解决上述兼容性或安装问题，然后重新加载该集成以重试。"
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "请通过 HACS 更新 HA-MCP 自定义组件",
|
||||
"description": "已安装的 ha-mcp 服务器需要 HA-MCP 自定义组件 {required} 或更高版本，但您的版本是 {installed}。请通过 HACS 更新组件（打开 HA-MCP 自定义组件条目；如果尚未显示更新，请使用“Update information”），然后重启 Home Assistant。在此期间服务器仍会继续运行，但在组件更新之前，某些较新的功能可能无法使用。"
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "HA-MCP 服务器更新正在等待组件更新",
|
||||
"description": "ha-mcp 服务器 {latest} 已可用，但该发行版同时更新了 HA-MCP 自定义组件（更新至 {shipped}；您正在运行 {running}）。为避免启动一个当前组件从未测试过的服务器版本，服务器自动更新将暂缓，直到组件完成更新。\n\n请通过 HACS 更新组件（打开 HA-MCP 自定义组件条目；如果尚未显示更新，请使用“Update information”），然后重启 Home Assistant——之后服务器更新会自动安装。若仍要立即安装服务器更新，请在 HA-MCP 服务器更新实体上点击“安装”。"
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "组件安装自旧版仓库",
|
||||
"description": "HACS 为此组件跟踪的是 ha-mcp 服务器主仓库，因此 HACS 在此显示的是服务器的版本号（7.x）和服务器的发行说明，而不是组件自身的（1.x）。更新仍然可用，但会一直被这样错误标注。修复方法：从 HACS 中移除此仓库（您的集成设置和配置项会保留），将 homeassistant-ai/ha-mcp-integration 添加为自定义仓库，从中重新安装组件，然后重启 Home Assistant。"
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "请重启 Home Assistant 以应用旧版 OAuth 更改",
|
||||
"description": "旧版 OAuth 身份验证模式会注册自己的 /authorize 和 /token 网页端点，而 Home Assistant 只有在完全重启时才能绑定或释放它们——无论您是刚刚开启该模式、关闭它，还是更改了它的 Client ID/Secret。请重启 Home Assistant（设置 - 系统 - 重启）以应用更改；在此之前仍保持先前的行为。"
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "稳定版（推荐）",
|
||||
"dev": "开发版（最新构建）"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "密钥 Webhook URL（默认）",
|
||||
"ha_auth": "使用 Home Assistant 登录（OAuth）",
|
||||
"legacy": "旧版 OAuth（Client ID/Secret，适用于 Google Gemini Spark）"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "工具搜索（紧凑，默认）",
|
||||
"full": "完整目录",
|
||||
"both": "两者（按智能体选择）"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "更新"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "从 Home Assistant 所在主机直接访问：{url}",
|
||||
"connect_local_lan": "本地/局域网（当网络访问为“Local network”时）：{url}",
|
||||
"connect_remote_url": "远程连接 URL：{url}",
|
||||
"connect_urls_label": "连接 URL：",
|
||||
"connect_urls_pending": "服务器启动后，连接 URL 将显示在此处（以及 Home Assistant 日志中）。",
|
||||
"connect_webhook_disabled": "通过 Webhook 远程访问已关闭（仅本地模式）。",
|
||||
"oauth_creds_pending": "服务器启动后，Client ID 和 Client Secret 将显示在此处。",
|
||||
"oauth_not_serving": "旧版 OAuth 尚未启用这些凭据——请在 Home Assistant 提示时重启以激活它们。",
|
||||
"oauth_select_legacy_mode": "将上面的身份验证模式设为旧版 OAuth 并保存，以生成 Client ID 和 Client Secret。",
|
||||
"panel_hint": "打开 [HA-MCP 设置面板](/ha-mcp) 以管理工具和服务器设置。",
|
||||
"tools_module_installed": "Beta/高级文件与 YAML 工具模块（可选）：已安装",
|
||||
"tools_module_not_installed": "Beta/高级文件与 YAML 工具模块（可选）：未安装——请在此集成页面上点击“添加条目”并选择“HA-MCP File & YAML Tools”",
|
||||
"tools_module_not_loaded": "Beta/高级文件与 YAML 工具模块（可选）：已安装但未加载——请在此集成页面上启用或重新加载“HA-MCP File & YAML Tools”条目",
|
||||
"version_line": "组件 {component_version} - 服务器 ha-mcp {server_version}（{channel} 通道）",
|
||||
"version_not_installed": "尚未安装",
|
||||
"version_unknown": "未知"
|
||||
"abort": {
|
||||
"already_configured": "此条目已配置。",
|
||||
"unsupported_home_assistant": "进程内的 HA-MCP Server 需要 Home Assistant {required} 或更高版本，但此实例运行的是 {installed}。您仍然可以将此组件的 HA-MCP File & YAML Tools 条目与作为 app (add-on) 或 Docker 容器运行的外部 ha-mcp 服务器配合使用。"
|
||||
}
|
||||
},
|
||||
"options": {
|
||||
"step": {
|
||||
"tools_info": {
|
||||
"title": "HA-MCP 文件与 YAML 工具",
|
||||
"description": "配置 ha-mcp 可选文件/YAML 工具所使用的特权文件和 YAML 编辑服务。这些设置也会出现在 ha-mcp 服务器自身的设置界面中，并实时生效，无需重启。不可覆盖的拒绝底线仍会阻止敏感路径（例如 .storage）和信任边界键（homeassistant、http、frontend、lovelace）。",
|
||||
"data": {
|
||||
"allowed_dirs": "额外的文件目录",
|
||||
"extra_yaml_keys": "额外的 YAML 可写键"
|
||||
},
|
||||
"data_description": {
|
||||
"allowed_dirs": "相对于配置目录的目录，每个目录都授予读写权限（例如 pyscript）。路径穿越以及配置目录之外的条目会被丢弃。",
|
||||
"extra_yaml_keys": "除内置键外，ha_config_set_yaml 还可写入的顶层键，适用于本安装中以 YAML 为主的集成（例如 alert2）。信任边界键会被丢弃。"
|
||||
}
|
||||
},
|
||||
"init": {
|
||||
"title": "HA-MCP 服务器",
|
||||
"description": "配置 HA-MCP 服务器。{panel_hint}此处的更改在保存时应用。\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||||
"data": {
|
||||
"channel": "发布通道",
|
||||
"auto_update": "服务器自动更新",
|
||||
"server_port": "MCP 服务器监听端口",
|
||||
"bind_host": "网络访问",
|
||||
"webhook_auth": "身份验证模式",
|
||||
"oauth_client_id_override": "旧版 OAuth：自定义 Client ID（可选）",
|
||||
"oauth_client_secret_override": "旧版 OAuth：自定义 Client Secret（可选）",
|
||||
"oauth_regenerate": "旧版 OAuth：立即重新生成 Client ID/Secret",
|
||||
"pip_spec": "开发者：ha-mcp 软件包覆盖",
|
||||
"server_url": "Home Assistant URL（高级）",
|
||||
"external_url": "外部 URL（可选）",
|
||||
"webhook_id_override": "自定义 Webhook 密钥（可选）",
|
||||
"secret_path_override": "自定义直连路径（可选）",
|
||||
"regenerate_secrets": "立即重新生成连接密钥",
|
||||
"enable_webhook": "通过 Webhook 远程访问",
|
||||
"enable_llm_api": "对话智能体 LLM API",
|
||||
"llm_api_exposure": "对话智能体工具暴露方式",
|
||||
"enable_startup_notification": "启动通知",
|
||||
"enable_sidebar_panel": "侧边栏设置面板"
|
||||
},
|
||||
"data_description": {
|
||||
"channel": "稳定版安装最新的稳定发行版；开发版安装最新的开发构建。启用自动更新后，重新加载或重启以及定期检查都会安装所选通道的最新构建。下方的开发者软件包覆盖优先级更高，并会禁用自动更新。",
|
||||
"auto_update": "启用时，所选通道的最新发行版会自动安装——在重新加载或重启时，以及通过定期检查。关闭时，服务器会保持当前已安装的版本，直到您重新启用此项。它仅控制 ha-mcp 服务器软件包；HA-MCP 自定义组件自身的更新仍通过 HACS 进行。",
|
||||
"server_port": "此服务器监听的端口。ha-mcp app (add-on) 使用 9583，因此默认设置为 9584 以允许两者并存——如果您不运行该 app (add-on)，任何空闲端口均可。",
|
||||
"bind_host": "谁可以直接连接到 MCP 服务器端口。默认值与 app (add-on) 匹配：可在本地网络上访问，以机密路径作为凭据。选择 loopback 仅允许来自 Home Assistant 本机本身的连接——无论哪种方式，Webhook URL 和侧边栏面板都可以正常工作。",
|
||||
"webhook_auth": "MCP 客户端如何在 Webhook URL 处验证身份。使用秘密 URL 时，链接本身就是唯一的凭据——OAuth 仍会为使用它的客户端运行，但每次登录都会自动批准：无需登录，也无需客户端 ID 或密钥。使用 Home Assistant 登录时，claude.ai 等客户端会使用 Home Assistant 管理员账户登录 (OAuth)。使用旧版 OAuth 时，此集成会运行自己的登录服务，并颁发客户端 ID 和密钥以粘贴到需要它们的客户端中——可能需要重启 Home Assistant 才能完全启用或禁用它。",
|
||||
"oauth_client_id_override": "替换自动生成的旧版 OAuth Client ID。留空则保留当前值。仅在身份验证模式设为旧版 OAuth 时使用。",
|
||||
"oauth_client_secret_override": "替换自动生成的旧版 OAuth Client Secret。留空则保留当前值。仅在身份验证模式设为旧版 OAuth 时使用。",
|
||||
"oauth_regenerate": "一次性操作：为旧版 OAuth 模式生成新的 Client ID 和 Secret。它只有在修复提示所要求的 Home Assistant 重启之后才会生效——在您重启之前，原有的 Client ID 和 Secret 仍然有效，新的尚未启用。同时会清空上面两个覆盖字段。",
|
||||
"pip_spec": "请留空。仅用于测试特定的 ha-mcp 构建（例如固定到某个预发行版）；它会覆盖发布通道，并在清空之前禁用自动更新。",
|
||||
"server_url": "进程内服务器用于访问您的 Home Assistant 的 URL（通常就是此实例本身）。留空则根据此实例的端口和 SSL 设置推导；仅在服务器需要走其他路由时才设置。",
|
||||
"external_url": "作为主要连接 URL 显示——当 Home Assistant 位于您自己的域名或反向代理之后时使用。请输入包含协议在内的完整基础地址。它必须直接指向 Home Assistant——在浏览器中打开它应能到达您的 HA 登录页面——并且不能包含 :8123 之类的端口（任何端口都不行），否则远程 MCP 客户端将无法访问。留空则自动使用 Nabu Casa / 本地地址。",
|
||||
"webhook_id_override": "替换连接 URL（/api/webhook/...）中随机生成的 Webhook 密钥。该 URL 就是凭据——请使用足够长、难以猜测的值。留空则保留当前值。",
|
||||
"secret_path_override": "替换在服务器端口上用于直连的随机路径。规则相同：该路径就是凭据。留空则保留当前值。",
|
||||
"regenerate_secrets": "一次性操作：生成新的随机 Webhook 密钥和直连路径，并立即使旧的连接 URL 失效。同时会清空上面两个覆盖字段。",
|
||||
"enable_webhook": "关闭以进入仅本地模式：完全不注册 Home Assistant Webhook，因此任何一方——包括 Nabu Casa——都无法通过 Home Assistant 访问服务器。服务器端口直连和侧边栏面板仍可继续使用。",
|
||||
"enable_llm_api": "向 Home Assistant 对话智能体（OpenAI、Google、Ollama 等）提供完整工具集：启用后，智能体可在“控制 Home Assistant”下选择“HA-MCP Server”，并在 Assist 聊天和语音中使用这些工具。启用只是让它可供选择——在您为某个智能体选中它之前，不会暴露任何内容。使用指南：{llm_api_docs_url}",
|
||||
"llm_api_exposure": "提供给对话智能体的工具集形态。工具搜索（默认）可让智能体的上下文保持精简：一个包含固定工具以及搜索/执行元工具的紧凑 API。完整目录会直接列出每个已暴露的工具——更适合大上下文模型。两者会将二者并列注册，让每个智能体在“控制 Home Assistant”下各自选择。按工具的暴露设置在 HA-MCP 设置面板中管理；详情：{llm_api_docs_url}",
|
||||
"enable_startup_notification": "每次服务器启动时显示通知，指向仅管理员可见的设置界面。关闭则静默启动——连接 URL 仍会出现在 Home Assistant 日志中。",
|
||||
"enable_sidebar_panel": "在侧边栏中显示 HA-MCP 设置面板（仅管理员）。关闭则移除侧边栏条目——服务器选项仍可在此界面中使用。"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"issues": {
|
||||
"server_start_failed": {
|
||||
"title": "HA-MCP 进程内服务器启动失败",
|
||||
"description": "无法在 Home Assistant 内部启动 HA-MCP 进程内服务器：\n\n{detail}\n\n请检查 Home Assistant 日志，然后重新加载该集成（或先修复根本问题再重新加载）以重试。"
|
||||
},
|
||||
"server_package_install_failed": {
|
||||
"title": "无法安装 HA-MCP 进程内服务器软件包",
|
||||
"description": "为进程内服务器安装 ha-mcp 软件包失败：\n\n{detail}\n\n请解决上述兼容性或安装问题，然后重新加载该集成以重试。"
|
||||
},
|
||||
"component_outdated": {
|
||||
"title": "请通过 HACS 更新 HA-MCP 自定义组件",
|
||||
"description": "已安装的 ha-mcp 服务器需要 HA-MCP 自定义组件 {required} 或更高版本，但您的版本是 {installed}。请通过 HACS 更新组件（打开 HA-MCP 自定义组件条目；如果尚未显示更新，请使用“Update information”），然后重启 Home Assistant。在此期间服务器仍会继续运行，但在组件更新之前，某些较新的功能可能无法使用。"
|
||||
},
|
||||
"server_update_held": {
|
||||
"title": "HA-MCP 服务器更新正在等待组件更新",
|
||||
"description": "ha-mcp 服务器 {latest} 已可用，但该发行版同时更新了 HA-MCP 自定义组件（更新至 {shipped}；您正在运行 {running}）。为避免启动一个当前组件从未测试过的服务器版本，服务器自动更新将暂缓，直到组件完成更新。\n\n请通过 HACS 更新组件（打开 HA-MCP 自定义组件条目；如果尚未显示更新，请使用“Update information”），然后重启 Home Assistant——之后服务器更新会自动安装。若仍要立即安装服务器更新，请在 HA-MCP 服务器更新实体上点击“安装”。"
|
||||
},
|
||||
"legacy_hacs_source": {
|
||||
"title": "组件安装自旧版仓库",
|
||||
"description": "HACS 正在跟踪此组件的主 ha-mcp 服务器仓库，因此 HACS 在此处显示的是服务器的版本号和发布说明，而非组件自身的 (2.x)。更新仍可正常工作，但会一直显示错误的标签。修复方法：从 HACS 中移除此仓库（您的集成设置和配置条目将保留），将 homeassistant-ai/ha-mcp-integration 添加为自定义仓库，从中重新安装组件，然后重启 Home Assistant。"
|
||||
},
|
||||
"legacy_oauth_restart": {
|
||||
"title": "重启 Home Assistant 以应用旧版 OAuth 设置",
|
||||
"fix_flow": {
|
||||
"step": {
|
||||
"confirm": {
|
||||
"title": "重启 Home Assistant？",
|
||||
"description": "提交此表单将重启 Home Assistant 并应用旧版 OAuth 设置。\n\n点击 <strong>提交</strong> 立即重启。"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"selector": {
|
||||
"server_channel": {
|
||||
"options": {
|
||||
"stable": "稳定版（推荐）",
|
||||
"dev": "开发版（最新构建）"
|
||||
}
|
||||
},
|
||||
"server_webhook_auth": {
|
||||
"options": {
|
||||
"none": "密钥 Webhook URL（默认）",
|
||||
"ha_auth": "使用 Home Assistant 登录（OAuth）",
|
||||
"legacy": "旧版 OAuth（此集成颁发客户端 ID/密钥供粘贴）"
|
||||
}
|
||||
},
|
||||
"llm_api_exposure": {
|
||||
"options": {
|
||||
"tool_search": "工具搜索（紧凑，默认）",
|
||||
"full": "完整目录",
|
||||
"both": "两者（按智能体选择）"
|
||||
}
|
||||
}
|
||||
},
|
||||
"entity": {
|
||||
"update": {
|
||||
"server_update": {
|
||||
"name": "更新"
|
||||
}
|
||||
}
|
||||
},
|
||||
"common": {
|
||||
"connect_direct_access": "从 Home Assistant 所在主机直接访问：{url}",
|
||||
"connect_local_lan": "本地/局域网（当网络访问为“Local network”时）：{url}",
|
||||
"connect_remote_url": "远程连接 URL：{url}",
|
||||
"connect_urls_label": "连接 URL：",
|
||||
"connect_urls_pending": "服务器启动后，连接 URL 将显示在此处（以及 Home Assistant 日志中）。",
|
||||
"connect_webhook_disabled": "通过 Webhook 远程访问已关闭（仅本地模式）。",
|
||||
"oauth_creds_pending": "服务器启动后，Client ID 和 Client Secret 将显示在此处。",
|
||||
"oauth_not_serving": "旧版 OAuth 尚未启用这些凭据——请在 Home Assistant 提示时重启以激活它们。",
|
||||
"oauth_select_legacy_mode": "将上面的身份验证模式设为旧版 OAuth 并保存，以生成 Client ID 和 Client Secret。",
|
||||
"panel_hint": "打开 [HA-MCP 设置面板](/ha-mcp) 以管理工具和服务器设置。",
|
||||
"tools_module_installed": "Beta/高级文件与 YAML 工具模块（可选）：已安装",
|
||||
"tools_module_not_installed": "Beta/高级文件与 YAML 工具模块（可选）：未安装——请在此集成页面上点击“添加条目”并选择“HA-MCP File & YAML Tools”",
|
||||
"tools_module_not_loaded": "Beta/高级文件与 YAML 工具模块（可选）：已安装但未加载——请在此集成页面上启用或重新加载“HA-MCP File & YAML Tools”条目",
|
||||
"version_line": "组件 {component_version} - 服务器 ha-mcp {server_version}（{channel} 通道）",
|
||||
"version_not_installed": "尚未安装",
|
||||
"version_unknown": "未知"
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user