Migre escenas y automatizaciones heredadas LinknLink a la nueva aplicación mediante MCP

Esta guía explica cómo migrar y restaurar los siguientes datos del LinknLink App heredado:

• Escenas
• Enlaces o automatizaciones

Los datos se migrarán a las siguientes funciones en la nueva aplicación:

• Escenas de nubes
• Automatizaciones en la nube

Durante la migración, Codex se conecta al servicio MCP proporcionado por LinknLink App, lee los datos heredados y los reconstruye utilizando los dispositivos y entidades disponibles en la familia actual.

Los datos heredados no se eliminan de forma predeterminada, por lo que puedes revertirlos si es necesario.

1. Qué necesitas antes de migrar

Prepare los siguientes tres parámetros de conexión:

Un token suele tener este aspecto:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

No utilice el token de ejemplo en esta guía. Debes copiar el Token que se muestra en tu propia App.

2.Asegúrese de que Codex y su teléfono puedan comunicarse

La computadora que ejecuta Codex debe poder alcanzar el dispositivo que ejecuta LinknLink App.

La configuración más sencilla es:

• Su teléfono y computadora están conectados a la misma red Wi-Fi.
• Su teléfono no ha cambiado a datos móviles.
• Su computadora no está conectada a una VPN que aísle la red local.
• Su enrutador no tiene habilitado el aislamiento de red de invitados ni el aislamiento de cliente.

Por ejemplo:

IP de la computadora: 192.168.58.20
IP de MCP de la aplicación: 192.168.58.121

Ambas direcciones están en el 192.168.58.x subred, por lo que normalmente deberían poder comunicarse directamente.

Si la aplicación muestra:

10.0.0.232

pero la computadora está usando:

192.168.58.x

Los dos dispositivos pueden estar en subredes diferentes. Es posible que Codex no pueda conectarse a menos que el enrutador se haya configurado para enrutar el tráfico entre esas subredes.

No ingrese la IP del enrutador, la IP de la puerta de enlace ni una dirección IP pública. Debe utilizar la IP del servicio MCP que se muestra en la página de configuración del Agente AI.

3. Solicitud de migración completa para Codex

Copie el siguiente mensaje en Codex y reemplace la dirección IP, el puerto y el token con sus propios valores.

Utilice el servicio MCP proporcionado por LinknLink App para 
migrar las escenas y vínculos de la aplicación heredada en la familia actual 
a Cloud Scenes y Cloud Automations en la nueva aplicación.

Detalles de conexión MCP:
- IP: Reemplace esto con la IP que se muestra en la página de configuración
- Puerto: 39282
- Token: reemplácelo con el último Token que se muestra en la parte inferior de 
la página de configuración del Agente AI

Siga este proceso exactamente:

1. Configure LinknLink como un servidor HTTP MCP Streamable remoto.
2. Utilice el siguiente punto final MCP:
   http://IP:PORT/mcp
3. Utilice el token proporcionado para la autenticación del token de portador.
4. Ejecute el protocolo de enlace de inicialización de MCP y lea las herramientas/lista para confirmar 
que la conexión funcione.
5. Lea la información familiar actual.
6. Lea las listas completas de dispositivos y entidades de la familia actual.
7. Lea las capacidades y el estado actual de cada Entidad requerida. 
para la migración.
8. Lea los datos de la escena heredada.
9. Lea los datos de automatización o vinculación heredados.
10. Lea las escenas de nube y las automatizaciones de nube existentes para evitar 
duplicados.
11. Cree asignaciones a partir de DID de dispositivos heredados, endpointIds y heredados. 
ID de escena a ID de entidad actuales y nuevos ID de escena en la nube.
12. No copie directamente los ID de dispositivos antiguos. acciones de reconstrucción y 
desencadenadores que utilizan ID de entidad que realmente existen en la familia actual.
13. Primero migre las escenas de nube y registre sus nuevos ID de escena de nube.
14. Luego, migre las automatizaciones en la nube que hacen referencia a escenas, utilizando el 
nuevos ID de escena de nube. Si el servidor expande una escena a Entidad 
acciones, también se pueden utilizar las acciones ampliadas basadas en Entidades actuales.
15. Llame a validar_scene para cada escena nueva.
16. Llame a validar_automatización para cada nueva automatización.
17. Cree un artículo solo después de que pase la validación.
18. Conservar el nombre original, la hora, los días de la semana, las condiciones de activación, 
acciones del dispositivo, texto de notificación, temperatura, modo, velocidad del ventilador, 
y retrasos.
19. Si un dispositivo heredado ya no existe, no adivine el mapeo. 
Enumere la información del dispositivo heredado y los posibles candidatos a entidad. 
y explique por qué el elemento no se puede migrar de forma segura.
20. No elimine escenas heredadas ni vínculos heredados.
21. No ejecutar las nuevas escenas o automatizaciones, porque al hacerlo 
Podría controlar dispositivos reales.
22. Después de la creación, lea Escenas de nube y Automatizaciones de nube. 
nuevamente y verificar sus recuentos, nombres, estados habilitados, activadores, 
y acciones.
23. En el informe final, incluya:
    - El número de escenas heredadas encontradas.
    - El número de vínculos heredados encontrados.
    - El número de escenas de nubes creadas.
    - El número de automatizaciones en la nube creadas.
    - Los ID de entidad actuales utilizados por cada elemento migrado.
    - Cualquier elemento que no se haya podido migrar y los motivos específicos.
    - Si se conservaron los datos heredados

Realice la migración directamente. No proporcione sólo instrucciones. 
No repita el Token completo en la respuesta final.

Después de completar los detalles, el comienzo debería verse así:

Detalles de conexión MCP:
- IP: 192.168.58.121
- Puerto: 39282
- Ficha: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

4. ¿Qué hará el Codex?

4.1 Establecer la conexión MCP

Codex se conectará a LinknLink MCP usando:

http://YOUR_IP:39282/mcp

El token se utilizará para la autenticación.

Después de una conexión exitosa, Codex debería identificar un servidor similar a:

linknlink-skill-mcp-servidor

4.2 Leer los datos heredados

El códice dirá:

• La lista de escenas heredadas
• Detalles de la escena heredada
• La lista de enlaces heredados
• Detalles de vinculación heredada

Los datos heredados pueden contener identificadores y valores como:

ID de escena
reglado
ID de punto final
hizo
puerta de enlace
Códigos IR
Nombres de propiedades de dispositivos heredados

Es posible que estos identificadores no funcionen directamente en la nueva aplicación.

4.3 Leer los dispositivos y entidades de la familia actual

Codex leerá las Entidades de la familia actual, por ejemplo:

luz.xxxxxx
clima.xxxxxx
sensor_binario.xxxxx
evento.xxxxx
tiempo.forecast_home

Las nuevas escenas y automatizaciones deben utilizar estas Entidades actualmente disponibles siempre que sea posible.

Por ejemplo, los datos heredados pueden contener únicamente:

hizo: 01385886d8828d16dc78ac9d74ceca8e

La Entidad actual correspondiente podría ser:

clima.01385886d8828d16dc78ac9d74ceca8e

Codex debe utilizar el ID de entidad actual al crear los nuevos datos.

4.4 Crear escenas antes de las automatizaciones

Si un vínculo heredado hace referencia a una escena heredada, Codex debe crear primero la escena de la nube.

Por ejemplo:

ID de escena heredada: 3008322404328373708
ID de nueva escena de nube: 8845c067a6744467b8e073863f35cda6

Luego, la automatización debería hacer referencia al nuevo ID de escena de nube en lugar del ID de escena heredado.

4.5 Validar antes de la creación

Cada elemento debe validarse utilizando:

validar_escena

o:

validar_automatización

Codex debe guardar un elemento solo cuando regresa la validación:

válido: verdadero

y no hay errores críticos.

5. Cómo verificar la migración

Abra el nuevo LinknLink App y verifique las siguientes secciones.

Escenas de nubes

Confirma que:

• El nombre de la escena es correcto.
• Se utiliza el dispositivo correcto.
• Las acciones son correctas.
• Parámetros como temperatura, modo de funcionamiento y velocidad del ventilador están completos.
• La escena utiliza dispositivos de la familia actual.

Automatizaciones en la nube

Confirma que:

• El nombre de la automatización es correcto.
• La automatización está habilitada.
• El tiempo de activación es correcto.
• La configuración de los días laborables es correcta.
• Las condiciones de activación del dispositivo son correctas.
• Los mensajes de notificación son correctos.
• Las escenas a las que se hace referencia son nuevas escenas de nubes.
• Las acciones del dispositivo utilizan ID de entidad actuales.

No elimine los datos heredados inmediatamente. Observe las nuevas automatizaciones durante varios días y confirme que se activen correctamente antes de decidir si eliminar los registros heredados.

6. Solución de problemas

6.1 La IP responde al ping, pero el tiempo de espera del puerto se agota

Los errores típicos incluyen:

No se pudo conectar
Se agotó el tiempo de conexión

Verifique lo siguiente:

• ¿Se está ejecutando el servicio MCP del Agente AI?
• ¿Está el puerto configurado en 39282?
• ¿La aplicación sigue ejecutándose?
• ¿El firewall del sistema permite el acceso a la red local?
• ¿El servicio MCP está escuchando en una dirección de red local en lugar de solo 127.0.0.1?

6.2 La IP no responde al ping

Las causas comunes incluyen:

• La dirección IP es incorrecta.
• Se ingresó la IP del enrutador en lugar de la IP del teléfono.
• La dirección IP del teléfono ha cambiado.
• El teléfono y la computadora están conectados a diferentes redes Wi-Fi.
• Un dispositivo está conectado a una red de invitados.
• Una VPN ha cambiado la ruta de la computadora.

Abra la página de configuración del AI Agent nuevamente y copie la dirección IP que se muestra actualmente.

6.3 MCP se conecta, pero el token no es válido

Abra la página de configuración del Agente AI nuevamente:

1. Desplácese hasta el final de la página.
2. Encuentra la última ficha.
3. Toque el botón copiar nuevamente.
4. Asegúrese de que el valor copiado no contenga espacios ni saltos de línea.
5. Proporcione el nuevo token al Codex.

6.4 El Codex informa que un dispositivo no existe

El DID o ID de punto final Es posible que la aplicación utilizada por la aplicación heredada ya no controle directamente el dispositivo.

Solicite al Codex que:

• Lea las listas actuales de dispositivos y entidades.
• Haga coincidir dispositivos usando el DID, nombre, habitación y tipo de dispositivo.
• Consultar las capacidades de las Entidades candidatas.
• Reconstruya el elemento utilizando el ID de entidad actual.
• Detenga la migración de ese elemento si no se encuentra ninguna coincidencia única.

El Codex nunca debe adivinar una asignación de dispositivo incierta.

6.5 Aparecen datos duplicados después de la migración

Esto puede suceder cuando ya existe una escena de nube o una automatización de nube coincidente.

Antes de crear algo, Codex debería:

• Lea los datos de la nube existentes.
• Compare nombres, desencadenantes y acciones.
• Saltar registros que ya sean idénticos.
• Informe elementos con nombres coincidentes pero contenido diferente en lugar de sobrescribirlos automáticamente.

6.6 Las automatizaciones meteorológicas no se pueden migrar

La aplicación heredada puede usar códigos meteorológicos numéricos, mientras que la nueva aplicación puede utilizar estados meteorológicos de la entidad, como:

nevado
lluvioso
nublado
soleado

Pídale a Codex que reconstruya el activador utilizando la versión actual. clima Entidad en lugar de copiar el código meteorológico numérico heredado directamente.

7. Recomendaciones de seguridad

• Trate el token como una credencial de acceso MCP. No lo publiques en chats grupales, foros o documentos públicos.
• No incluya el Token completo en el informe de migración.
• Si un token se ha compartido públicamente, regenerelo en la aplicación después de la migración.
• No elimine datos heredados durante la migración inicial.
• No permita que Codex ejecute escenas durante la migración inicial. De lo contrario, dispositivos como aires acondicionados, cerraduras o luces podrían controlarse inesperadamente.
• Revise manualmente las automatizaciones que involucran dispositivos sensibles a la seguridad, como cerraduras, sistemas de alarma y válvulas, antes de habilitarlas.

Siguiendo este proceso, Codex puede completar la conexión, la lectura de datos, el mapeo de dispositivos, la validación, la creación y la verificación final en un único flujo de trabajo y, al mismo tiempo, evita la práctica insegura de copiar las ID de dispositivos heredados directamente en los nuevos datos.