Migrar cenas e automações LinknLink herdadas para o novo aplicativo usando MCP

Este guia explica como migrar e restaurar os seguintes dados do legado LinknLink App:

• Cenas
• Ligações ou automações

Os dados serão migrados para os seguintes recursos do novo App:

• Cenas de nuvem
• Automações em nuvem

Durante a migração, o Codex se conecta ao serviço MCP fornecido pelo LinknLink App, lê os dados legados e os reconstrói usando os dispositivos e entidades disponíveis na família atual.

Os dados legados não são excluídos por padrão, então você pode reverter se necessário.

1. O que você precisa antes da migração

Prepare os três parâmetros de conexão a seguir:

Um token geralmente se parece com isto:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Não use o token de exemplo neste guia. Você deve copiar o Token exibido em seu próprio App.

2. Certifique-se de que o Codex e seu telefone possam se comunicar

O computador que executa o Codex deve ser capaz de acessar o dispositivo que executa o LinknLink App.

A configuração mais simples é:

• Seu telefone e computador estão conectados à mesma rede Wi-Fi.
• Seu telefone não mudou para dados móveis.
• Seu computador não está conectado a uma VPN que isole a rede local.
• Seu roteador não possui isolamento de rede de convidados ou isolamento de cliente habilitado.

Por exemplo:

IP do computador: 192.168.58.20
IP do aplicativo MCP: 192.168.58.121

Ambos os endereços estão no 192.168.58.x sub-rede, então eles geralmente devem ser capazes de se comunicar diretamente.

Se o aplicativo exibir:

10.0.0.232

mas o computador está usando:

192.168.58.x

os dois dispositivos podem estar em sub-redes diferentes. O Codex pode não conseguir se conectar, a menos que o roteador tenha sido configurado para rotear o tráfego entre essas sub-redes.

Não insira o IP do roteador, o IP do gateway ou um endereço IP público. Você deve usar o IP do serviço MCP mostrado na página de configurações do AI Agent.

3. Solicitação de migração completa para Codex

Copie o seguinte prompt no Codex e substitua o endereço IP, porta e token pelos seus próprios valores.

Utilize o serviço MCP fornecido pelo LinknLink App para 
migrar as cenas e ligações do aplicativo legado na família atual 
para Cloud Scenes e Cloud Automations no novo aplicativo.

Detalhes da conexão MCP:
- IP: Substitua pelo IP mostrado na página de configurações
- Porto: 39282
- Token: Substitua este pelo último Token mostrado na parte inferior do 
a página de configurações do Agente AI

Siga exatamente este processo:

1. Configure LinknLink como um servidor HTTP MCP streamable remoto.
2. Use o seguinte terminal MCP:
   http://IP:PORT/mcp
3. Use o Token fornecido para autenticação do Bearer Token.
4. Execute o handshake de inicialização do MCP e leia as ferramentas/lista para confirmar 
que a conexão funcione.
5. Leia as informações atuais da família.
6. Leia as listas completas de dispositivos e entidades da família atual.
7. Leia as capacidades e o estado atual de cada entidade necessária 
para a migração.
8. Leia os dados da cena legada.
9. Leia os dados legados de ligação ou automação.
10. Leia as cenas de nuvem e automações de nuvem existentes para evitar 
duplicatas.
11. Crie mapeamentos de DIDs de dispositivos legados, endpointIds e legados 
IDs de cena para IDs de entidade atuais e novos IDs de cena em nuvem.
12. Não copie diretamente os IDs de dispositivos legados. Reconstruir ações e 
acionadores usando IDs de entidade que realmente existem na família atual.
13. Migre primeiro as cenas da nuvem e registre seus novos IDs de cena da nuvem.
14. Em seguida, migre Cloud Automations que fazem referência a cenas, usando o 
novos IDs de cena na nuvem. Se o servidor expandir uma cena para Entidade 
ações, as ações expandidas baseadas nas Entidades atuais também poderão ser utilizadas.
15. Chame valid_scene para cada nova cena.
16. Chame valid_automation para cada nova automação.
17. Crie um item somente depois de passar na validação.
18. Preserve o nome original, horário, dias da semana, condições de acionamento, 
ações do dispositivo, texto de notificação, temperatura, modo, velocidade do ventilador, 
e atrasos.
19. Se um dispositivo legado não existir mais, não adivinhe o mapeamento. 
Liste as informações do dispositivo legado e possíveis candidatos a entidades, 
e explique por que o item não pode ser migrado com segurança.
20. Não exclua cenas legadas ou ligações legadas.
21. Não execute as novas cenas ou automações, pois ao fazê-lo 
poderia controlar dispositivos reais.
22. Após a criação, leia Cloud Scenes e Cloud Automations 
novamente e verifique suas contagens, nomes, estados habilitados, gatilhos, 
e ações.
23. No relatório final incluir:
    - O número de cenas legadas encontradas
    - O número de ligações herdadas encontradas
    - O número de cenas de nuvem criadas
    - O número de Cloud Automations criadas
    - Os IDs de entidade atuais usados por cada item migrado
    - Quaisquer itens que não puderam ser migrados e os motivos específicos
    - Se os dados legados foram preservados

Execute a migração diretamente. Não forneça apenas instruções. 
Não repita o Token completo na resposta final.

Após preencher os dados, o início deverá ficar assim:

Detalhes da conexão MCP:
- IP: 192.168.58.121
- Porto: 39282
- Token: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

4. O que o Codex fará

4.1 Estabelecer a conexão MCP

O Codex se conectará ao LinknLink MCP usando:

http://YOUR_IP:39282/mcp

O Token será usado para autenticação.

Após uma conexão bem-sucedida, o Codex deverá identificar um servidor semelhante a:

linknlink-skill-mcp-servidor

4.2 Leia os dados legados

O Codex lerá:

• A lista de cenas legadas
• Detalhes da cena legada
• A lista de ligação herdada
• Detalhes da vinculação herdada

Os dados legados podem conter identificadores e valores como:

cenaId
regra
endpointId
fez
gatewayDid
Códigos IR
Nomes de propriedades de dispositivos legados

Esses identificadores podem não funcionar diretamente no novo aplicativo.

4.3 Leia os dispositivos e entidades da família atual

O Codex irá ler as Entidades da família atual, por exemplo:

luz.xxxxx
clima.xxxxx
sensor_binário.xxxxx
evento.xxxx
clima.forecast_home

Novas cenas e automações devem usar essas Entidades atualmente disponíveis sempre que possível.

Por exemplo, os dados legados podem conter apenas:

fez: 01385886d8828d16dc78ac9d74ceca8e

A Entidade atual correspondente poderá ser:

clima.01385886d8828d16dc78ac9d74ceca8e

O Codex deve usar o ID da entidade atual ao criar os novos dados.

4.4 Criar cenas antes das automações

Se uma ligação legada fizer referência a uma cena legada, o Codex deverá criar primeiro a cena da nuvem.

Por exemplo:

ID da cena legada: 3008322404328373708
ID da nova cena de nuvem: 8845c067a6744467b8e073863f35cda6

A automação deve então fazer referência ao novo ID da cena da nuvem em vez do ID da cena herdada.

4.5 Validar antes da criação

Cada item deve ser validado usando:

validar_scene

ou:

validar_automação

O Codex deve salvar um item somente quando a validação retornar:

válido: verdadeiro

e não há erros críticos.

5. Como verificar a migração

Abra o novo LinknLink App e verifique as seções a seguir.

Cenas de nuvem

Confirme isso:

• O nome da cena está correto.
• O dispositivo correto é usado.
• As ações estão corretas.
• Parâmetros como temperatura, modo de operação e velocidade do ventilador estão completos.
• A cena utiliza dispositivos da família atual.

Automações em nuvem

Confirme isso:

• O nome da automação está correto.
• A automação está habilitada.
• O tempo de disparo está correto.
• As configurações dos dias da semana estão corretas.
• As condições de disparo do dispositivo estão corretas.
• As mensagens de notificação estão corretas.
• As cenas referenciadas são novas cenas de nuvem.
• As ações do dispositivo usam IDs de entidade atuais.

Não exclua os dados legados imediatamente. Observe as novas automações por vários dias e confirme se elas são acionadas corretamente antes de decidir se deseja remover os registros legados.

6. Solução de problemas

6.1 O IP responde ao ping, mas a porta atinge o tempo limite

Erros típicos incluem:

Falha ao conectar
A conexão expirou

Verifique o seguinte:

• O serviço AI Agent MCP está em execução?
• A porta está configurada para 39282?
• O aplicativo ainda está em execução?
• O firewall do sistema permite acesso à rede local?
• O serviço MCP está escutando em um endereço de rede local em vez de apenas 127.0.0.1?

6.2 O IP não responde ao Ping

As causas comuns incluem:

• O endereço IP está incorreto.
• O IP do roteador foi inserido em vez do IP do telefone.
• O endereço IP do telefone mudou.
• O telefone e o computador estão conectados a diferentes redes Wi-Fi.
• Um dispositivo está conectado a uma rede de convidados.
• Uma VPN mudou o roteamento do computador.

Abra a página de configurações do AI Agent novamente e copie o endereço IP exibido atualmente.

6.3 O MCP se conecta, mas o token é inválido

Abra a página de configurações do AI Agent novamente:

1. Role até o final da página.
2. Encontre o último token.
3. Toque no botão copiar novamente.
4. Certifique-se de que o valor copiado não contenha espaços ou quebras de linha.
5. Forneça o novo token ao Codex.

6.4 Codex informa que um dispositivo não existe

O DID ou endpointId usado pelo aplicativo legado não poderá mais controlar diretamente o dispositivo.

Peça ao Codex para:

• Leia as listas atuais de dispositivos e entidades.
• Combine dispositivos usando DID, nome, sala e tipo de dispositivo.
• Consultar as capacidades das Entidades candidatas.
• Recrie o item usando o ID da entidade atual.
• Pare de migrar esse item se nenhuma correspondência exclusiva for encontrada.

O Codex nunca deve adivinhar um mapeamento de dispositivo incerto.

6.5 Dados duplicados aparecem após a migração

Isso pode acontecer quando já existe uma cena de nuvem ou automação de nuvem correspondente.

Antes de criar qualquer coisa, o Codex deve:

• Leia os dados da nuvem existentes.
• Compare nomes, gatilhos e ações.
• Ignore registros que já sejam idênticos.
• Relate itens com nomes correspondentes, mas com conteúdo diferente, em vez de substituí-los automaticamente.

6.6 Automações meteorológicas não podem ser migradas

O aplicativo legado pode usar códigos meteorológicos numéricos, enquanto o novo aplicativo pode usar estados de entidades meteorológicas, como:

nevado
chuvoso
nublado
ensolarado

Peça ao Codex para reconstruir o gatilho usando o atual clima Entidade em vez de copiar diretamente o código meteorológico numérico herdado.

7. Recomendações de segurança

• Trate o Token como uma credencial de acesso MCP. Não publique em bate-papos em grupo, fóruns ou documentos públicos.
• Não inclua o Token completo no relatório de migração.
• Se um token tiver sido compartilhado publicamente, gere-o novamente no aplicativo após a migração.
• Não exclua dados legados durante a migração inicial.
• Não permita que o Codex execute cenas durante a migração inicial. Caso contrário, dispositivos como ar condicionado, fechaduras ou luzes poderão ser controlados inesperadamente.
• Revise manualmente as automações que envolvem dispositivos sensíveis à segurança, como fechaduras, sistemas de alarme e válvulas, antes de ativá-las.

Seguindo esse processo, o Codex pode concluir a conexão, leitura de dados, mapeamento de dispositivos, validação, criação e verificação final em um único fluxo de trabalho, evitando a prática insegura de copiar IDs de dispositivos legados diretamente nos novos dados.