169 lines
19 KiB
JSON
169 lines
19 KiB
JSON
{
|
|
"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."
|
|
}
|
|
},
|
|
"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": "Percorsi file extra",
|
|
"extra_yaml_keys": "Chiavi YAML scrivibili aggiuntive"
|
|
},
|
|
"data_description": {
|
|
"allowed_dirs": "Percorsi relativi alla directory di configurazione, inclusi nomi file esatti come sensor.yaml, o percorsi sotto /share, /media, /ssl e /backup. A ogni voce vengono concessi i permessi di lettura e scrittura per quel percorso e per tutto ciò che si trova al di sotto di esso; inserisci ogni percorso come elemento di elenco separato. Le voci vengono confrontate letteralmente; i caratteri jolly come * non sono supportati. I percorsi di attraversamento e altri percorsi non consentiti 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"
|
|
}
|
|
}
|