Migreer verouderde LinknLink scènes en automatiseringen naar de nieuwe app met behulp van MCP

In deze handleiding wordt uitgelegd hoe u de volgende gegevens uit de oude LinknLink App kunt migreren en herstellen:

• Scènes
• Koppelingen of automatiseringen

De gegevens worden gemigreerd naar de volgende functies in de nieuwe app:

• Wolkenscènes
• Cloud-automatiseringen

Tijdens de migratie maakt Codex verbinding met de MCP-service van LinknLink App, leest de verouderde gegevens en bouwt deze opnieuw op met behulp van de apparaten en entiteiten die beschikbaar zijn in de huidige familie.

Verouderde gegevens worden niet standaard verwijderd, dus u kunt deze indien nodig ongedaan maken.

1. Wat u nodig heeft vóór de migratie

Bereid de volgende drie verbindingsparameters voor:

Een token ziet er meestal zo uit:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Gebruik niet het voorbeeldtoken in deze handleiding. U dient de weergegeven Token in uw eigen App te kopiëren.

2. Zorg ervoor dat Codex en uw telefoon kunnen communiceren

De computer waarop Codex draait, moet het apparaat kunnen bereiken waarop de LinknLink App draait.

De eenvoudigste opstelling is:

• Uw telefoon en computer zijn verbonden met hetzelfde Wi-Fi-netwerk.
• Je telefoon is niet overgeschakeld naar mobiele data.
• Uw computer is niet verbonden met een VPN die het lokale netwerk isoleert.
• Op uw router is geen gastnetwerkisolatie of clientisolatie ingeschakeld.

Bijvoorbeeld:

Computer-IP: 192.168.58.20
App MCP-IP: 192.168.58.121

Beide adressen staan op de 192.168.58.x subnet, dus normaal gesproken zouden ze rechtstreeks moeten kunnen communiceren.

Als de app het volgende weergeeft:

10.0.0.232

maar de computer gebruikt:

192.168.58.x

de twee apparaten bevinden zich mogelijk op verschillende subnetten. Codex kan mogelijk geen verbinding maken tenzij de router is geconfigureerd om verkeer tussen deze subnetten te routeren.

Voer niet het router-IP, gateway-IP of een openbaar IP-adres in. U moet het MCP-service-IP gebruiken dat wordt weergegeven op de AI Agent-instellingenpagina.

3. Voltooi de migratieprompt voor Codex

Kopieer de volgende prompt naar Codex en vervang het IP-adres, de poort en het token door uw eigen waarden.

Gebruik de MCP-service van LinknLink App om 
migreer de scènes en koppelingen van de oude app in de huidige familie 
naar cloudscènes en cloudautomatiseringen in de nieuwe app.

MCP-verbindingsdetails:
- IP: Vervang dit door het IP-adres dat wordt weergegeven op de instellingenpagina
- Poort: 39282
- Token: vervang dit door het laatste token dat onderaan wordt weergegeven 
de AI Agent-instellingenpagina

Volg dit proces precies:

1. Configureer LinknLink als een externe Streamable HTTP MCP-server.
2. Gebruik het volgende MCP-eindpunt:
   http://IP:PORT/mcp
3. Gebruik het meegeleverde token voor Bearer Token-authenticatie.
4. Voer de MCP-initialisatie-handshake uit en lees de tools/lijst om te bevestigen 
dat de verbinding werkt.
5. Lees de actuele gezinsinformatie.
6. Lees de volledige apparaat- en entiteitslijsten voor de huidige familie.
7. Lees de mogelijkheden en huidige status van elke vereiste entiteit 
voor de migratie.
8. Lees de oudere scènegegevens.
9. Lees de verouderde koppelings- of automatiseringsgegevens.
10. Lees de bestaande Cloud Scenes en Cloud Automations om dit te voorkomen 
duplicaten.
11. Bouw toewijzingen op basis van DID's van oudere apparaten, endpointIds en oudere apparaten 
scène-ID's naar huidige Entiteits-ID's en nieuwe Cloud Scene-ID's.
12. Kopieer verouderde apparaat-ID's niet rechtstreeks. Herbouw acties en 
triggers met behulp van Entiteits-ID's die daadwerkelijk in de huidige familie bestaan.
13. Migreer eerst cloudscènes en noteer hun nieuwe cloudscène-ID's.
14. Migreer vervolgens cloudautomatiseringen die naar scènes verwijzen, met behulp van de 
nieuwe Cloud Scene-ID's. Als de server een scène uitbreidt naar Entity 
acties, kunnen ook de uitgebreide acties op basis van huidige entiteiten worden gebruikt.
15. Roep validate_scene aan voor elke nieuwe scène.
16. Roep validate_automation aan voor elke nieuwe automatisering.
17. Maak pas een item aan nadat het is gevalideerd.
18. Behoud de originele naam, tijd, weekdagen, triggervoorwaarden, 
apparaatacties, meldingstekst, temperatuur, modus, ventilatorsnelheid, 
en vertragingen.
19. Als een ouder apparaat niet meer bestaat, raad dan de toewijzing niet. 
Vermeld de informatie over het oude apparaat en mogelijke entiteitskandidaten, 
en leg uit waarom het item niet veilig kan worden gemigreerd.
20. Verwijder geen oude scènes of oude koppelingen.
21. Voer de nieuwe scènes of automatiseringen niet uit, omdat u dit wel doet 
kon echte apparaten besturen.
22. Lees na het maken de Cloud Scenes en Cloud Automations 
opnieuw en verifieer hun tellingen, namen, ingeschakelde statussen, triggers, 
en acties.
23. Neem in het eindrapport op:
    - Het aantal gevonden oudere scènes
    - Het aantal gevonden verouderde koppelingen
    - Het aantal gemaakte cloudscènes
    - Het aantal gemaakte cloudautomatiseringen
    - De huidige entiteits-ID's die door elk gemigreerd item worden gebruikt
    - Eventuele items die niet konden worden gemigreerd en de specifieke redenen
    - Of de oude gegevens bewaard zijn gebleven

Voer de migratie rechtstreeks uit. Geef niet alleen instructies. 
Herhaal niet het volledige token in het uiteindelijke antwoord.

Na het invullen van de details zou het begin er als volgt uit moeten zien:

MCP-verbindingsdetails:
-IP: 192.168.58.121
- Poort: 39282
- Token: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

4. Wat de Codex zal doen

4.1 Breng de MCP-verbinding tot stand

Codex maakt verbinding met LinknLink MCP met behulp van:

http://YOUR_IP:39282/mcp

Het token wordt gebruikt voor authenticatie.

Na een succesvolle verbinding zou Codex een server moeten identificeren die lijkt op:

linknlink-skill-mcp-server

4.2 Lees de oude gegevens

Codex zal luiden:

• De lijst met oude scènes
• Details van oude scènes
• De oude koppelingslijst
• Gegevens over oude koppelingen

Verouderde gegevens kunnen identificatiegegevens en waarden bevatten, zoals:

scèneId
regeerde
eindpuntId
deed
gatewayDeed
IR-codes
Namen van verouderde apparaateigenschappen

Deze ID's werken mogelijk niet rechtstreeks in de nieuwe app.

4.3 Lees de apparaten en entiteiten van de huidige familie

Codex leest de entiteiten in de huidige familie, bijvoorbeeld:

licht.xxxx
klimaat.xxxx
binaire_sensor.xxxxx
evenement.xxxx
weer.forecast_home

Nieuwe scènes en automatiseringen moeten waar mogelijk gebruik maken van deze momenteel beschikbare entiteiten.

De oude gegevens kunnen bijvoorbeeld alleen het volgende bevatten:

deed: 01385886d8828d16dc78ac9d74ceca8e

De overeenkomstige huidige entiteit kan zijn:

klimaat.01385886d8828d16dc78ac9d74ceca8e

Codex moet de huidige Entiteits-ID gebruiken bij het maken van de nieuwe gegevens.

4.4 Scènes vóór automatiseringen maken

Als een oude koppeling verwijst naar een oude scène, moet Codex eerst de Cloud Scene creëren.

Bijvoorbeeld:

Legacy scène-ID: 3008322404328373708
Nieuwe cloudscène-ID: 8845c067a6744467b8e073863f35cda6

De automatisering moet dan verwijzen naar de nieuwe Cloud Scene ID in plaats van naar de oude scène-ID.

4.5 Valideren vóór creatie

Elk item moet worden gevalideerd met behulp van:

valideer_scène

of:

valideer_automatisering

Codex zou een item alleen moeten opslaan als de validatie terugkeert:

geldig: waar

en er zijn geen kritische fouten.

5. Hoe u de migratie kunt verifiëren

Open de nieuwe LinknLink App en controleer de volgende secties.

Wolkenscènes

Bevestig dat:

• De scènenaam klopt.
• Er wordt gebruik gemaakt van het juiste apparaat.
• De acties zijn correct.
• Parameters zoals temperatuur, bedrijfsmodus en ventilatorsnelheid zijn compleet.
• De scène maakt gebruik van apparaten uit de huidige familie.

Cloud-automatiseringen

Bevestig dat:

• De automatiseringsnaam is correct.
• De automatisering is ingeschakeld.
• De triggertijd is correct.
• De weekdaginstellingen zijn correct.
• De triggervoorwaarden voor het apparaat zijn correct.
• Meldingsberichten zijn correct.
• Scènes waarnaar wordt verwezen, zijn nieuwe cloudscènes.
• Apparaatacties gebruiken huidige entiteits-ID's.

Verwijder de verouderde gegevens niet onmiddellijk. Observeer de nieuwe automatiseringen een aantal dagen en bevestig dat ze correct worden geactiveerd voordat u besluit of u de verouderde records wilt verwijderen.

6. Problemen oplossen

6.1 Het IP-adres reageert op ping, maar de poort is time-out

Typische fouten zijn onder meer:

Kan geen verbinding maken
Er is een time-out voor de verbinding opgetreden

Controleer het volgende:

• Is de AI Agent MCP-service actief?
• Staat de poort ingesteld op 39282?
• Is de app nog actief?
• Staat de systeemfirewall lokale netwerktoegang toe?
• Luistert de MCP-service op een lokaal netwerkadres in plaats van alleen 127.0.0.1?

6.2 Het IP-adres reageert niet op ping

Veel voorkomende oorzaken zijn:

• Het IP-adres is onjuist.
• Het IP-adres van de router is ingevoerd in plaats van het IP-adres van de telefoon.
• Het IP-adres van de telefoon is gewijzigd.
• De telefoon en computer zijn verbonden met verschillende Wi-Fi-netwerken.
• Eén apparaat is verbonden met een gastnetwerk.
• Een VPN heeft de routering van de computer gewijzigd.

Open de AI Agent-instellingenpagina opnieuw en kopieer het momenteel weergegeven IP-adres.

6.3 MCP maakt verbinding, maar het token is ongeldig

Open de AI Agent-instellingenpagina opnieuw:

1. Scroll naar de onderkant van de pagina.
2. Zoek het laatste token.
3. Tik nogmaals op de kopieerknop.
4. Zorg ervoor dat de gekopieerde waarde geen spaties of regeleinden bevat.
5. Geef het nieuwe token aan Codex.

6.4 Codex meldt dat een apparaat niet bestaat

De DID of eindpuntId gebruikt door de oude app, heeft mogelijk geen directe controle meer over het apparaat.

Vraag Codex om:

• Lees de huidige apparaat- en entiteitslijsten.
• Match apparaten met behulp van de DID, naam, kamer en apparaattype.
• Bevraag de mogelijkheden van kandidaat-entiteiten.
• Bouw het item opnieuw op met behulp van de huidige entiteits-ID.
• Stop met het migreren van dat item als er geen unieke match kan worden gevonden.

Codex mag nooit een onzekere apparaattoewijzing raden.

6.5 Dubbele gegevens verschijnen na migratie

Dit kan gebeuren als er al een bijpassende Cloud Scene of Cloud Automation bestaat.

Voordat Codex iets maakt, moet het:

• Lees de bestaande cloudgegevens.
• Vergelijk namen, triggers en acties.
• Sla records over die al identiek zijn.
• Rapporteer items met overeenkomende namen maar met verschillende inhoud in plaats van ze automatisch te overschrijven.

6.6 Weerautomatiseringen kunnen niet worden gemigreerd

De oude app kan numerieke weercodes gebruiken, terwijl de nieuwe app weerentiteitsstatussen kan gebruiken, zoals:

besneeuwd
regenachtig
bewolkt
zonnig

Vraag Codex om de trigger opnieuw op te bouwen met behulp van de stroom weer Entiteit in plaats van de oude numerieke weercode rechtstreeks te kopiëren.

7. Beveiligingsaanbevelingen

• Behandel het token als een MCP-toegangsreferentie. Publiceer het niet in groepschats, forums of openbare documenten.
• Neem niet de volledige token op in het migratierapport.
• Als een token openbaar is gedeeld, genereer deze dan na de migratie opnieuw in de app.
• Verwijder geen verouderde gegevens tijdens de eerste migratie.
• Sta niet toe dat Codex scènes uitvoert tijdens de initiële migratie. Anders kunnen apparaten zoals airconditioners, sloten of verlichting onverwachts worden bediend.
• Controleer handmatig automatiseringen waarbij beveiligingsgevoelige apparaten betrokken zijn, zoals sloten, alarmsystemen en kleppen, voordat u deze inschakelt.

Door dit proces te volgen, kan Codex de verbinding, het lezen van gegevens, het in kaart brengen van apparaten, de validatie, het aanmaken en de uiteindelijke verificatie in één enkele workflow voltooien, terwijl de onveilige praktijk van het rechtstreeks kopiëren van oudere apparaat-ID's naar de nieuwe gegevens wordt vermeden.