169 lines
19 KiB
JSON
169 lines
19 KiB
JSON
{
|
|
"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."
|
|
}
|
|
},
|
|
"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": "Rutas de archivos adicionales",
|
|
"extra_yaml_keys": "Claves YAML de escritura adicionales"
|
|
},
|
|
"data_description": {
|
|
"allowed_dirs": "Rutas relativas al directorio de configuración, incluidos nombres de archivo exactos como sensor.yaml, o rutas bajo /share, /media, /ssl y /backup. A cada entrada se le concede lectura y escritura para esa ruta y todo lo que esté debajo de ella; introduce cada entrada como un elemento de lista separado. Las entradas se comparan literalmente; no se admiten comodines como *. Se omiten las rutas con recorrido de directorios y otras no permitidas.",
|
|
"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"
|
|
}
|
|
}
|