{ "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. Нажмите **Отправить**, чтобы запустить его; в дальнейшем вы сможете изменить порт, привязку и аутентификацию в настройках интеграции." } }, "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": "Пути относительно каталога конфигурации, включая точные имена файлов, такие как sensor.yaml, или пути в каталогах /share, /media, /ssl и /backup. Для каждого элемента предоставляются права на чтение и запись для указанного пути и всего, что находится внутри него; каждый путь указывается как отдельный элемент списка. Элементы сопоставляются точным совпадением; подстановочные знаки, такие как *, не поддерживаются. Обход каталогов и другие запрещенные пути отклоняются.", "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Нажмите Submit, чтобы перезапустить сейчас." } } } } }, "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": "неизвестен" } }