Migrera äldre LinknLink scener och automatiseringar till den nya appen med MCP

Den här guiden förklarar hur du migrerar och återställer följande data från den äldre LinknLink App:

• Scener
• Länkar eller automatiseringar

Data kommer att migreras till följande funktioner i den nya appen:

• Molnscener
• Molnautomatiseringar

Under migreringen ansluter Codex till MCP-tjänsten som tillhandahålls av LinknLink App, läser äldre data och bygger om den med hjälp av de enheter och enheter som finns tillgängliga i den aktuella familjen.

Äldre data raderas inte som standard, så du kan återställa om det behövs.

1. Vad du behöver före migration

Förbered följande tre anslutningsparametrar:

En token ser vanligtvis ut så här:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Använd inte exemplet Token i den här guiden. Du måste kopiera token som visas i din egen app.

2. Se till att Codex och din telefon kan kommunicera

Datorn som kör Codex måste kunna nå enheten som kör LinknLink App.

Den enklaste inställningen är:

• Din telefon och dator är anslutna till samma Wi-Fi-nätverk.
• Din telefon har inte bytt till mobildata.
• Din dator är inte ansluten till ett VPN som isolerar det lokala nätverket.
• Din router har inte gästnätverksisolering eller klientisolering aktiverad.

Till exempel:

Dator IP: 192.168.58.20
App MCP IP: 192.168.58.121

Båda adresserna finns på 192.168.58.x subnät, så de bör vanligtvis kunna kommunicera direkt.

Om appen visar:

10.0.0.232

men datorn använder:

192.168.58.x

de två enheterna kan finnas på olika undernät. Codex kanske inte kan ansluta om inte routern har konfigurerats för att dirigera trafik mellan dessa undernät.

Ange inte routerns IP, gateway-IP eller en offentlig IP-adress. Du måste använda MCP-tjänstens IP som visas på sidan för AI Agent-inställningar.

3. Slutför migreringsfrågan för Codex

Kopiera följande prompt till Codex och ersätt IP-adressen, porten och Token med dina egna värden.

Använd MCP-tjänsten som tillhandahålls av LinknLink App för att 
migrera den äldre appens scener och länkar i den nuvarande familjen 
till Cloud Scenes och Cloud Automations i den nya appen.

MCP-anslutningsdetaljer:
- IP: Ersätt detta med IP som visas på inställningssidan
- Hamn: 39282
- Token: Ersätt detta med den sista Token som visas längst ner på 
sidan för AI Agent-inställningar

Följ denna process exakt:

1. Konfigurera LinknLink som en fjärrströmbar HTTP MCP-server.
2. Använd följande MCP-slutpunkt:
   http://IP:PORT/mcp
3. Använd den medföljande Token för Bearer Token-autentisering.
4. Kör MCP-initieringshandskakning och läs verktyg/lista för att bekräfta 
att anslutningen fungerar.
5. Läs den aktuella familjeinformationen.
6. Läs hela enhets- och enhetslistorna för den aktuella familjen.
7. Läs kapaciteten och det aktuella tillståndet för varje enhet som krävs 
för migrationen.
8. Läs den äldre scendatan.
9. Läs äldre länknings- eller automationsdata.
10. Läs de befintliga Cloud Scenes och Cloud Automations för att förhindra 
dubbletter.
11. Bygg mappningar från äldre enhets-DID, slutpunkts-ID och äldre 
scen-ID:n till aktuella enhets-ID:n och nya Cloud Scene-ID:n.
12. Kopiera inte äldre enhets-ID:n direkt. Återskapa åtgärder och 
triggers med hjälp av enhets-ID:n som faktiskt finns i den aktuella familjen.
13. Migrera Cloud Scenes först och spela in deras nya Cloud Scene ID.
14. Migrera sedan Cloud Automations som refererar till scener med hjälp av 
nya Cloud Scene ID:n. Om servern expanderar en scen till Entity 
åtgärder kan de utökade åtgärderna baserade på nuvarande Entiteter också användas.
15. Ring validate_scene för varje ny scen.
16. Ring validate_automation för varje ny automation.
17. Skapa ett objekt först efter att det har godkänts.
18. Bevara det ursprungliga namnet, tiden, veckodagarna, triggervillkoren, 
enhetsåtgärder, meddelandetext, temperatur, läge, fläkthastighet, 
och förseningar.
19. Om en äldre enhet inte längre finns, gissa inte mappningen. 
Lista äldre enhetsinformation och möjliga enhetskandidater, 
och förklara varför objektet inte kan migreras på ett säkert sätt.
20. Ta inte bort äldre scener eller äldre länkar.
21. Utför inte de nya scenerna eller automatiseringarna, eftersom du gör det 
kunde styra riktiga enheter.
22. Läs molnscenerna och molnautomatiseringarna efter skapandet 
igen och verifiera deras antal, namn, aktiverade tillstånd, utlösare, 
och handlingar.
23. Inkludera i slutrapporten:
    - Antalet gamla scener som hittats
    - Antalet äldre länkar som hittades
    - Antalet molnscener som skapats
    - Antalet molnautomatiseringar som skapats
    - De aktuella enhets-id:n som används av varje migrerad artikel
    - Alla föremål som inte kunde migreras och de specifika skälen
    – Huruvida den äldre data bevarades

Utför migreringen direkt. Ge inte endast instruktioner. 
Upprepa inte hela token i det slutliga svaret.

Efter att ha fyllt i detaljerna bör början se ut så här:

MCP-anslutningsdetaljer:
- IP: 192.168.58.121
- Hamn: 39282
- Token: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

4. Vad Codex kommer att göra

4.1 Upprätta MCP-anslutningen

Codex kommer att ansluta till LinknLink MCP med:

http://YOUR_IP:39282/mcp

Token kommer att användas för autentisering.

Efter en lyckad anslutning bör Codex identifiera en server som liknar:

linknlink-skill-mcp-server

4.2 Läs äldre data

Codex kommer att läsa:

• Den äldre scenlistan
• Äldre scendetaljer
• Den äldre länklistan
• Äldre länkningsdetaljer

Äldre data kan innehålla identifierare och värden som:

sceneId
regelid
endpointId
gjorde
gatewayGjorde
IR-koder
Äldre enhetsegenskapsnamn

Dessa identifierare kanske inte fungerar direkt i den nya appen.

4.3 Läs den nuvarande familjens enheter och enheter

Codex kommer att läsa Entiteterna i den nuvarande familjen, till exempel:

ljus.xxxxx
klimat.xxxx
binär_sensor.xxxxx
event.xxxxxx
weather.forecast_home

Nya scener och automatiseringar bör använda dessa för närvarande tillgängliga Entiteter när det är möjligt.

Till exempel kan äldre data endast innehålla:

gjorde: 01385886d8828d16dc78ac9d74ceca8e

Motsvarande nuvarande Entitet kan vara:

klimat.01385886d8828d16dc78ac9d74ceca8e

Codex ska använda det aktuella enhets-ID:t när de nya data skapas.

4.4 Skapa scener före automatiseringar

Om en äldre länk refererar till en äldre scen måste Codex skapa molnscenen först.

Till exempel:

Äldre scen-ID: 3008322404328373708
Nytt Cloud Scene ID: 8845c067a6744467b8e073863f35cda6

Automatiseringen bör då referera till det nya Cloud Scene ID istället för det äldre scen ID.

4.5 Validera före skapandet

Varje artikel ska valideras med:

validera_scen

eller:

validera_automation

Codex bör spara en vara endast när validering returnerar:

giltigt: sant

och det finns inga kritiska fel.

5. Hur man verifierar migreringen

Öppna den nya LinknLink App och kontrollera följande avsnitt.

Molnscener

Bekräfta att:

• Scennamnet är korrekt.
• Rätt enhet används.
• Åtgärderna är korrekta.
• Parametrar som temperatur, driftläge och fläkthastighet är klara.
• Scenen använder enheter från den nuvarande familjen.

Molnautomatiseringar

Bekräfta att:

• Automatiseringsnamnet är korrekt.
• Automatiseringen är aktiverad.
• Utlösningstiden är korrekt.
• Veckodagsinställningarna är korrekta.
• Enhetens utlösningsförhållanden är korrekta.
• Aviseringsmeddelanden är korrekta.
• Refererade scener är nya molnscener.
• Enhetsåtgärder använder aktuella enhets-ID:n.

Radera inte äldre data omedelbart. Observera de nya automatiseringarna i flera dagar och bekräfta att de utlöses korrekt innan du bestämmer dig för att ta bort de äldre posterna.

6. Felsökning

6.1 IP:n svarar på ping, men porten tar slut

Typiska fel inkluderar:

Det gick inte att ansluta
Anslutningen tog timeout

Kontrollera följande:

• Körs AI Agent MCP-tjänsten?
• Är porten inställd på 39282?
• Körs appen fortfarande?
• Tillåter systembrandväggen lokal nätverksåtkomst?
• Lyssnar MCP-tjänsten på en lokal nätverksadress istället för bara 127.0.0.1?

6.2 IP:n svarar inte på ping

Vanliga orsaker inkluderar:

• IP-adressen är felaktig.
• Routerns IP angavs istället för telefonens IP.
• Telefonens IP-adress har ändrats.
• Telefonen och datorn är anslutna till olika Wi-Fi-nätverk.
• En enhet är ansluten till ett gästnätverk.
• En VPN har ändrat datorns routing.

Öppna sidan för AI Agent-inställningar igen och kopiera den IP-adress som visas för närvarande.

6.3 MCP ansluter, men token är ogiltig

Öppna sidan för AI Agent-inställningar igen:

1. Bläddra till botten av sidan.
2. Hitta den sista token.
3. Tryck på kopieringsknappen igen.
4. Se till att det kopierade värdet inte innehåller mellanslag eller radbrytningar.
5. Tillhandahåll den nya token till Codex.

6.4 Codex rapporterar att en enhet inte finns

DID eller endpointId som används av den äldre appen kanske inte längre direkt styr enheten.

Be Codex att:

• Läs den aktuella enhets- och enhetslistorna.
• Matcha enheter med hjälp av DID, namn, rum och enhetstyp.
• Fråga kapaciteten hos kandidatenheter.
• Bygg om objektet med det aktuella enhets-ID:t.
• Sluta migrera objektet om ingen unik matchning kan hittas.

Codex ska aldrig gissa en osäker enhetskartläggning.

6.5 Dubblettdata visas efter migrering

Detta kan hända när en matchande Cloud Scene eller Cloud Automation redan finns.

Innan du skapar något bör Codex:

• Läs befintlig molndata.
• Jämför namn, utlösare och åtgärder.
• Hoppa över poster som redan är identiska.
• Rapportera objekt med matchande namn men annat innehåll istället för att skriva över dem automatiskt.

6.6 Väderautomatiseringar kan inte migreras

Den äldre appen kan använda numeriska väderkoder, medan den nya appen kan använda väderentitetstillstånd som:

snöig
regnigt
molnigt
soligt

Be Codex att bygga om triggern med strömmen väder Entitet istället för att kopiera den äldre numeriska väderkoden direkt.

7. Säkerhetsrekommendationer

• Behandla token som en MCP-åtkomstuppgifter. Publicera det inte i gruppchattar, forum eller offentliga dokument.
• Inkludera inte hela token i migreringsrapporten.
• Om en token har delats offentligt, återskapa den i appen efter migreringen.
• Ta inte bort äldre data under den första migreringen.
• Tillåt inte Codex att köra scener under den första migreringen. Annars kan enheter som luftkonditionering, lås eller lampor kontrolleras oväntat.
• Granska manuellt automatiseringar som involverar säkerhetskänsliga enheter som lås, larmsystem och ventiler innan du aktiverar dem.

Genom att följa denna process kan Codex slutföra anslutningen, dataavläsningen, enhetsmapping, validering, skapande och slutlig verifiering i ett enda arbetsflöde samtidigt som man undviker den osäkra metoden att kopiera äldre enhets-ID:n direkt till den nya datan.