Перенос устаревших сцен и средств автоматизации LinknLink в новое приложение с помощью MCP

22 июль 2026 г.

В этом руководстве объясняется, как перенести и восстановить следующие данные из устаревшей версии LinknLink App:

Сцены
Связи или автоматизация

Данные будут перенесены в следующие функции нового приложения:

Облачные сцены
Облачная автоматизация

Во время миграции Codex подключается к сервису MCP, предоставляемому LinknLink App, считывает устаревшие данные и восстанавливает их, используя устройства и объекты, доступные в текущем семействе.

Устаревшие данные не удаляются по умолчанию, поэтому при необходимости можно выполнить откат.

1. Что вам нужно перед миграцией

Подготовьте следующие три параметра подключения:

Параметр	Пример	Где это найти
IP-адрес	`192.168.58.121`	Проверьте страницу настроек телефона на предмет IP-адреса локальной сети службы MCP.
Порт	`39282`	Сервисный порт MCP; текущее значение по умолчанию `39282`
Токен	Строка UUID	LinknLink App → Настройки AI Agent → скопируйте последний токен, показанный внизу страницы.

Токен обычно выглядит так:

хххххххх-хххх-хххх-хххх-хххххххххх

Не используйте пример токена в этом руководстве. Вы должны скопировать токен, отображаемый в вашем собственном приложении.

2. Убедитесь, что Codex и ваш телефон могут обмениваться данными

Компьютер, на котором работает Кодекс, должен иметь доступ к устройству, на котором работает LinknLink App.

Самая простая настройка:

Ваш телефон и компьютер подключены к одной сети Wi-Fi.
Ваш телефон не переключился на мобильные данные.
Ваш компьютер не подключен к VPN, изолирующей локальную сеть.
На вашем маршрутизаторе не включена изоляция гостевой сети или изоляция клиента.

Например:

IP компьютера: 192.168.58.20
IP-адрес MCP приложения: 192.168.58.121

Оба адреса находятся на 192.168.58.х подсети, поэтому они обычно могут общаться напрямую.

Если приложение отображает:

10.0.0.232

но компьютер использует:

192.168.58.х

два устройства могут находиться в разных подсетях. Codex, возможно, не сможет подключиться, если маршрутизатор не настроен на маршрутизацию трафика между этими подсетями.

Не вводите IP-адрес маршрутизатора, IP-шлюза или общедоступный IP-адрес. Вы должны использовать IP-адрес службы MCP, указанный на странице настроек AI Agent.

3. Заполните запрос на миграцию Кодекса.

Скопируйте следующую подсказку в Кодекс и замените IP-адрес, порт и токен своими собственными значениями.

Пожалуйста, используйте услугу MCP, предоставляемую LinknLink App, чтобы 
перенести сцены и связи устаревшего приложения в текущую семью 
к облачным сценам и облачной автоматизации в новом приложении.

Детали подключения MCP:
- IP: замените его IP-адресом, указанным на странице настроек.
- Порт: 39282
- Токен: замените его последним жетоном, показанным внизу 
страница настроек AI-агента

Точно следуйте этому процессу:

1. Настройте LinknLink в качестве удаленного Streamable HTTP MCP-сервера.
2. Используйте следующую конечную точку MCP:
   http://IP:PORT/mcp
3. Используйте предоставленный токен для аутентификации токена носителя.
4. Запустите инициализацию MCP и прочитайте инструменты/список для подтверждения. 
что соединение работает.
5. Прочтите текущую информацию о семье.
6. Прочтите полные списки устройств и объектов для текущего семейства.
7. Прочтите возможности и текущее состояние каждого требуемого объекта. 
для миграции.
8. Считайте устаревшие данные сцены.
9. Прочтите устаревшие данные связи или автоматизации.
10. Прочтите существующие облачные сцены и облачную автоматизацию, чтобы предотвратить 
дубликаты.
11. Создавайте сопоставления на основе устаревших DID-устройств, идентификаторов конечных точек и устаревших 
идентификаторы сцен на текущие идентификаторы объектов и новые идентификаторы облачных сцен.
12. Не копируйте идентификаторы устаревших устройств напрямую. Перестроить действия и 
триггеры с использованием идентификаторов объектов, которые фактически существуют в текущем семействе.
13. Сначала перенесите облачные сцены и запишите их новые идентификаторы облачных сцен.
14. Затем перенесите Cloud Automations, ссылающиеся на сцены, с помощью 
новые идентификаторы облачных сцен. Если сервер расширяет сцену до Entity 
действия, также можно использовать расширенные действия, основанные на текущих объектах.
15. Вызывайте validate_scene для каждой новой сцены.
16. Вызывайте validate_automation для каждой новой автоматизации.
17. Создавайте элемент только после того, как он пройдет проверку.
18. Сохраните исходное имя, время, дни недели, условия срабатывания, 
действия устройства, текст уведомления, температура, режим, скорость вентилятора, 
и задержки.
19. Если устаревшего устройства больше не существует, не угадывайте его сопоставление. 
Перечислите информацию об устаревших устройствах и возможных кандидатах на сущности. 
и объясните, почему элемент не может быть безопасно перенесен.
20. Не удаляйте устаревшие сцены или устаревшие связи.
21. Не выполняйте новые сцены или автоматизацию, потому что это 
мог управлять реальными устройствами.
22. После создания прочтите разделы «Облачные сцены» и «Облачная автоматизация». 
еще раз и проверьте их количество, имена, включенные состояния, триггеры, 
и действия.
23. В окончательный отчет включить:
    - Количество найденных устаревших сцен.
    - Количество найденных устаревших связей.
    - Количество созданных облачных сцен.
    - Количество созданных облачных автоматизаций.
    – Текущие идентификаторы объектов, используемые каждым перенесенным элементом.
    - Любые элементы, которые не удалось перенести, и конкретные причины.
    - Сохранились ли устаревшие данные

Выполните миграцию напрямую. Не давайте только инструкции. 
Не повторяйте весь токен в окончательном ответе.

После заполнения деталей начало должно выглядеть так:

Детали подключения MCP:
- IP: 192.168.58.121
- Порт: 39282
- Токен: хххххххх-хххх-хххх-хххх-ххххххххххх.

4. Что будет делать Кодекс

4.1 Установите соединение MCP

Codex подключится к LinknLink MCP, используя:

http://YOUR_IP:39282/mcp

Токен будет использоваться для аутентификации.

После успешного подключения Codex должен идентифицировать сервер, аналогичный:

linknlink-skill-mcp-сервер

4.2 Чтение устаревших данных

Кодекс будет читать:

Список устаревших сцен
Подробности устаревшей сцены
Список устаревших связей
Подробности устаревшей связи

Устаревшие данные могут содержать идентификаторы и значения, такие как:

идентификатор сцены
рулид
идентификатор конечной точки
сделал
шлюзDid
Коды IR
Названия свойств устаревших устройств

Эти идентификаторы могут не работать напрямую в новом приложении.

4.3 Чтение устройств и объектов текущего семейства

Кодекс прочитает сущности текущего семейства, например:

свет.ххххх
климат.xxxxxx
двоичный_сенсор.xxxxx
событие.xxxxxx
погода.forecast_home

Новые сцены и средства автоматизации должны использовать эти доступные на данный момент сущности, когда это возможно.

Например, устаревшие данные могут содержать только:

сделал: 01385886d8828d16dc78ac9d74ceca8e

Соответствующая текущая сущность может быть:

климат.01385886d8828d16dc78ac9d74ceca8e

Кодекс должен использовать текущий идентификатор объекта при создании новых данных.

4.4. Создание сцен перед автоматизацией

Если устаревшая связь ссылается на устаревшую сцену, Кодекс должен сначала создать облачную сцену.

Например:

ID старой сцены: 3008322404328373708
ID новой облачной сцены: 8845c067a6744467b8e073863f35cda6

Затем автоматизация должна ссылаться на новый идентификатор облачной сцены вместо устаревшего идентификатора сцены.

4.5 Проверка перед созданием

Каждый элемент должен быть проверен с использованием:

validate_scene

или:

validate_automation

Кодекс должен сохранять элемент только после завершения проверки:

действительный: правда

и критических ошибок нет.

5. Как проверить миграцию

Откройте новый LinknLink App и проверьте следующие разделы.

Облачные сцены

Подтвердите это:

Название сцены правильное.
Используется правильное устройство.
Действия правильные.
Такие параметры, как температура, режим работы и скорость вентилятора, указаны в полном объеме.
В сцене используются устройства текущего семейства.

Облачная автоматизация

Подтвердите это:

Имя автоматизации правильное.
Автоматизация включена.
Время срабатывания правильное.
Настройки дня недели верны.
Условия срабатывания устройства правильные.
Сообщения уведомлений верны.
Ссылочные сцены — это новые сцены с облаками.
Действия устройства используют текущие идентификаторы объектов.

Не удаляйте устаревшие данные сразу. Понаблюдайте за новыми средствами автоматизации в течение нескольких дней и убедитесь, что они срабатывают правильно, прежде чем принимать решение об удалении устаревших записей.

6. Устранение неполадок

6.1 IP-адрес отвечает на пинг, но время ожидания порта истекает

Типичные ошибки включают в себя:

Не удалось подключиться
Время подключения истекло

Проверьте следующее:

Работает ли служба AI Agent MCP?
Установлен ли порт 39282?
Приложение все еще работает?
Разрешает ли системный брандмауэр доступ к локальной сети?
Служба MCP прослушивает адрес локальной сети, а не только 127.0.0.1?

6.2 IP не отвечает на пинг

Общие причины включают в себя:

IP-адрес неверен.
Вместо IP телефона был введен IP роутера.
IP-адрес телефона изменился.
Телефон и компьютер подключены к разным сетям Wi-Fi.
Одно устройство подключено к гостевой сети.
VPN изменила маршрутизацию компьютера.

Снова откройте страницу настроек AI Agent и скопируйте отображаемый в данный момент IP-адрес.

6.3 MCP подключается, но токен недействителен

Снова откройте страницу настроек AI Agent:

Прокрутите страницу вниз.
Найдите последний жетон.
Нажмите кнопку копирования еще раз.
Убедитесь, что скопированное значение не содержит пробелов и разрывов строк.
Предоставьте новый токен Кодексу.

6.4 Кодекс сообщает, что устройство не существует

DID или идентификатор конечной точки используемое устаревшим приложением, больше не может напрямую управлять устройством.

Попросите Кодекс:

Прочтите текущие списки устройств и объектов.
Сопоставьте устройства по DID, имени, комнате и типу устройства.
Запросите возможности объектов-кандидатов.
Перестройте элемент, используя текущий идентификатор объекта.
Остановите перенос этого элемента, если уникальное совпадение не найдено.

Кодекс никогда не должен угадывать неопределенное сопоставление устройств.

6.5. После миграции появляются повторяющиеся данные

Это может произойти, если соответствующая облачная сцена или облачная автоматизация уже существует.

Прежде чем что-либо создавать, Кодекс должен:

Прочтите существующие облачные данные.
Сравните имена, триггеры и действия.
Пропускать записи, которые уже идентичны.
Сообщайте об элементах с совпадающими именами, но разным содержимым, вместо того, чтобы перезаписывать их автоматически.

6.6 Автоматизацию погоды невозможно перенести

Устаревшее приложение может использовать числовые коды погоды, а новое приложение может использовать состояния объектов погоды, такие как:

снежный
дождливый
пасмурно
солнечный

Попросите Кодекс перестроить триггер, используя текущую погода Entity вместо прямого копирования устаревшего числового кода погоды.

7. Рекомендации по безопасности

Рассматривайте токен как учетные данные доступа MCP. Не публикуйте его в групповых чатах, форумах или общедоступных документах.
Не включайте полный токен в отчет о миграции.
Если токен был опубликован публично, восстановите его в приложении после миграции.
Не удаляйте устаревшие данные во время первоначальной миграции.
Не разрешайте Codex выполнять сцены во время первоначальной миграции. В противном случае управление такими устройствами, как кондиционеры, замки или освещение, может произойти неожиданно.
Вручную проверяйте автоматизацию, включающую устройства, чувствительные к безопасности, такие как замки, системы сигнализации и клапаны, прежде чем включать их.

Следуя этому процессу, Codex может выполнить подключение, чтение данных, сопоставление устройств, проверку, создание и окончательную проверку в одном рабочем процессе, избегая при этом небезопасной практики копирования устаревших идентификаторов устройств непосредственно в новые данные.