Migrieren Sie ältere LinknLink-Szenen und Automatisierungen mithilfe von MCP in die neue App

In dieser Anleitung wird erläutert, wie Sie die folgenden Daten aus dem alten LinknLink App migrieren und wiederherstellen:

• Szenen
• Verknüpfungen oder Automatisierungen

Die Daten werden in die folgenden Funktionen der neuen App migriert:

• Wolkenszenen
• Cloud-Automatisierungen

Während der Migration stellt Codex eine Verbindung zum MCP-Dienst her, der von LinknLink App bereitgestellt wird, liest die Altdaten und erstellt sie mithilfe der in der aktuellen Familie verfügbaren Geräte und Entitäten neu.

Ältere Daten werden standardmäßig nicht gelöscht, sodass Sie bei Bedarf ein Rollback durchführen können.

1. Was Sie vor der Migration benötigen

Bereiten Sie die folgenden drei Verbindungsparameter vor:

Ein Token sieht normalerweise so aus:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Verwenden Sie nicht das Beispiel-Token in diesem Handbuch. Sie müssen den in Ihrer eigenen App angezeigten Token kopieren.

2. Stellen Sie sicher, dass Codex und Ihr Telefon kommunizieren können

Der Computer, auf dem Codex ausgeführt wird, muss in der Lage sein, das Gerät zu erreichen, auf dem LinknLink App ausgeführt wird.

Die einfachste Einrichtung ist:

• Ihr Telefon und Ihr Computer sind mit demselben Wi-Fi-Netzwerk verbunden.
• Ihr Telefon hat nicht auf mobile Daten umgestellt.
• Ihr Computer ist nicht mit einem VPN verbunden, das das lokale Netzwerk isoliert.
• Für Ihren Router ist die Gastnetzwerk-Isolation oder Client-Isolation nicht aktiviert.

Zum Beispiel:

Computer-IP: 192.168.58.20
App-MCP-IP: 192.168.58.121

Beide Adressen befinden sich auf der 192.168.58.x Subnetz, daher sollten sie normalerweise in der Lage sein, direkt zu kommunizieren.

Wenn die App Folgendes anzeigt:

10.0.0.232

aber der Computer verwendet:

192.168.58.x

Die beiden Geräte befinden sich möglicherweise in unterschiedlichen Subnetzen. Codex kann möglicherweise keine Verbindung herstellen, es sei denn, der Router wurde für die Weiterleitung des Datenverkehrs zwischen diesen Subnetzen konfiguriert.

Geben Sie nicht die Router-IP, Gateway-IP oder eine öffentliche IP-Adresse ein. Sie müssen die MCP-Dienst-IP verwenden, die auf der Seite mit den AI Agent-Einstellungen angezeigt wird.

3. Schließen Sie die Migrationsaufforderung für Codex ab

Kopieren Sie die folgende Eingabeaufforderung in Codex und ersetzen Sie die IP-Adresse, den Port und das Token durch Ihre eigenen Werte.

Bitte nutzen Sie den MCP-Dienst, der von LinknLink App bereitgestellt wird 
Migrieren Sie die Szenen und Verknüpfungen der alten App in die aktuelle Familie 
zu Cloud-Szenen und Cloud-Automatisierungen in der neuen App.

MCP-Verbindungsdetails:
- IP: Ersetzen Sie diese durch die auf der Einstellungsseite angezeigte IP
- Hafen: 39282
- Token: Ersetzen Sie diesen durch den letzten Token, der unten angezeigt wird 
die AI Agent-Einstellungsseite

Befolgen Sie diesen Vorgang genau:

1. Konfigurieren Sie LinknLink als Remote-Streamable-HTTP-MCP-Server.
2. Verwenden Sie den folgenden MCP-Endpunkt:
   http://IP:PORT/mcp
3. Verwenden Sie das bereitgestellte Token für die Bearer-Token-Authentifizierung.
4. Führen Sie den MCP-Initialisierungs-Handshake aus und lesen Sie zur Bestätigung die Tools/Liste 
dass die Verbindung funktioniert.
5. Lesen Sie die aktuellen Familieninformationen.
6. Lesen Sie die vollständigen Geräte- und Entitätslisten für die aktuelle Familie.
7. Lesen Sie die Fähigkeiten und den aktuellen Status jeder erforderlichen Entität 
für die Migration.
8. Lesen Sie die alten Szenendaten.
9. Lesen Sie die alten Verknüpfungs- oder Automatisierungsdaten.
10. Lesen Sie die vorhandenen Cloud-Szenen und Cloud-Automatisierungen, um dies zu verhindern 
Duplikate.
11. Erstellen Sie Zuordnungen aus älteren Geräte-DIDs, Endpunkt-IDs und älteren Geräten 
Szenen-IDs in aktuelle Entitäts-IDs und neue Cloud-Szenen-IDs umwandeln.
12. Kopieren Sie ältere Geräte-IDs nicht direkt. Aktionen neu erstellen und 
löst mithilfe von Entitäts-IDs aus, die tatsächlich in der aktuellen Familie vorhanden sind.
13. Migrieren Sie zuerst Cloud-Szenen und notieren Sie ihre neuen Cloud-Szenen-IDs.
14. Migrieren Sie dann Cloud-Automatisierungen, die Szenen referenzieren, mithilfe von 
neue Cloud-Szenen-IDs. Wenn der Server eine Szene in Entity erweitert 
Aktionen können auch die erweiterten Aktionen basierend auf aktuellen Entitäten verwendet werden.
15. Rufen Sie „validate_scene“ für jede neue Szene auf.
16. Rufen Sie „validate_automation“ für jede neue Automatisierung auf.
17. Erstellen Sie ein Element erst, nachdem es die Validierung bestanden hat.
18. Behalten Sie den ursprünglichen Namen, die ursprüngliche Uhrzeit, die Wochentage und die Auslösebedingungen bei. 
Geräteaktionen, Benachrichtigungstext, Temperatur, Modus, Lüftergeschwindigkeit, 
und Verzögerungen.
19. Wenn ein älteres Gerät nicht mehr vorhanden ist, raten Sie nicht über die Zuordnung. 
Listen Sie die Informationen zu Altgeräten und möglichen Entitätskandidaten auf. 
und erklären Sie, warum das Element nicht sicher migriert werden kann.
20. Löschen Sie keine alten Szenen oder alten Verknüpfungen.
21. Führen Sie die neuen Szenen oder Automatisierungen nicht aus, da dies der Fall ist 
könnte echte Geräte steuern.
22. Lesen Sie nach der Erstellung die Cloud-Szenen und Cloud-Automatisierungen 
erneut und überprüfen Sie deren Anzahl, Namen, aktivierten Zustände, Auslöser usw. 
und Aktionen.
23. Im Abschlussbericht sind Folgendes aufzunehmen:
    – Die Anzahl der gefundenen Legacy-Szenen
    – Die Anzahl der gefundenen Legacy-Verknüpfungen
    – Die Anzahl der erstellten Cloud-Szenen
    – Die Anzahl der erstellten Cloud-Automatisierungen
    – Die aktuellen Entitäts-IDs, die von jedem migrierten Element verwendet werden
    - Alle Elemente, die nicht migriert werden konnten, und die spezifischen Gründe
    - Ob die Altdaten erhalten blieben

Führen Sie die Migration direkt durch. Geben Sie nicht nur Anweisungen. 
Wiederholen Sie nicht das vollständige Token in der endgültigen Antwort.

Nachdem Sie die Details eingegeben haben, sollte der Anfang so aussehen:

MCP-Verbindungsdetails:
- IP: 192.168.58.121
- Hafen: 39282
- Token: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

4. Was Codex tun wird

4.1 Stellen Sie die MCP-Verbindung her

Codex stellt über Folgendes eine Verbindung zum MCP LinknLink her:

http://YOUR_IP:39282/mcp

Der Token wird zur Authentifizierung verwendet.

Nach einer erfolgreichen Verbindung sollte Codex einen Server identifizieren, der dem folgenden ähnelt:

linknlink-skill-mcp-server

4.2 Lesen Sie die Altdaten

Der Codex lautet:

• Die Legacy-Szenenliste
• Details zur alten Szene
• Die Legacy-Verknüpfungsliste
• Details zur Legacy-Verknüpfung

Legacy-Daten können Bezeichner und Werte enthalten wie:

Szenen-ID
Regel
Endpunkt-ID
tat
GatewayDid
IR-Codes
Namen älterer Geräteeigenschaften

Diese Kennungen funktionieren möglicherweise nicht direkt in der neuen App.

4.3 Lesen Sie die Geräte und Entitäten der aktuellen Familie

Codex liest die Entitäten in der aktuellen Familie, zum Beispiel:

licht.xxxxx
klima.xxxxx
binärer_sensor.xxxxx
event.xxxxx
Weather.forecast_home

Neue Szenen und Automatisierungen sollten nach Möglichkeit diese derzeit verfügbaren Entitäten verwenden.

Beispielsweise könnten die Altdaten nur Folgendes enthalten:

tat: 01385886d8828d16dc78ac9d74ceca8e

Die entsprechende aktuelle Entität könnte sein:

Klima.01385886d8828d16dc78ac9d74ceca8e

Codex sollte beim Erstellen der neuen Daten die aktuelle Entitäts-ID verwenden.

4.4 Szenen vor Automatisierungen erstellen

Wenn eine Legacy-Verknüpfung auf eine Legacy-Szene verweist, muss Codex zuerst die Cloud-Szene erstellen.

Zum Beispiel:

Legacy-Szenen-ID: 3008322404328373708
Neue Cloud-Szenen-ID: 8845c067a6744467b8e073863f35cda6

Die Automatisierung sollte dann auf die neue Cloud-Szenen-ID statt auf die alte Szenen-ID verweisen.

4.5 Vor der Erstellung validieren

Jedes Element sollte validiert werden mit:

validieren_szene

oder:

validieren_automation

Codex sollte ein Element nur speichern, wenn die Validierung zurückkehrt:

gültig: wahr

und es liegen keine kritischen Fehler vor.

5. So überprüfen Sie die Migration

Öffnen Sie das neue LinknLink App und überprüfen Sie die folgenden Abschnitte.

Wolkenszenen

Bestätigen Sie Folgendes:

• Der Szenenname ist korrekt.
• Es wird das richtige Gerät verwendet.
• Die Aktionen sind korrekt.
• Parameter wie Temperatur, Betriebsart und Lüftergeschwindigkeit sind vollständig.
• Die Szene verwendet Geräte der aktuellen Familie.

Cloud-Automatisierungen

Bestätigen Sie Folgendes:

• Der Automatisierungsname ist korrekt.
• Die Automatisierung ist aktiviert.
• Der Auslösezeitpunkt ist korrekt.
• Die Wochentagseinstellungen sind korrekt.
• Die Triggerbedingungen des Geräts sind korrekt.
• Benachrichtigungsmeldungen sind korrekt.
• Referenzierte Szenen sind neue Cloud-Szenen.
• Geräteaktionen verwenden aktuelle Entitäts-IDs.

Löschen Sie die Altdaten nicht sofort. Beobachten Sie die neuen Automatisierungen mehrere Tage lang und vergewissern Sie sich, dass sie korrekt ausgelöst werden, bevor Sie entscheiden, ob die alten Datensätze entfernt werden sollen.

6. Fehlerbehebung

6.1 Die IP antwortet auf Ping, aber der Port läuft ab

Typische Fehler sind:

Verbindung konnte nicht hergestellt werden
Zeitüberschreitung bei der Verbindung

Überprüfen Sie Folgendes:

• Läuft der AI Agent MCP-Dienst?
• Ist der Port auf eingestellt? 39282?
• Läuft die App noch?
• Ermöglicht die System-Firewall den lokalen Netzwerkzugriff?
• Hört der MCP-Dienst eine lokale Netzwerkadresse statt nur 127.0.0.1?

6.2 Die IP reagiert nicht auf Ping

Häufige Ursachen sind:

• Die IP-Adresse ist falsch.
• Anstelle der IP des Telefons wurde die Router-IP eingegeben.
• Die IP-Adresse des Telefons hat sich geändert.
• Das Telefon und der Computer sind mit unterschiedlichen Wi-Fi-Netzwerken verbunden.
• Ein Gerät ist mit einem Gastnetzwerk verbunden.
• Ein VPN hat das Routing des Computers geändert.

Öffnen Sie erneut die AI Agent-Einstellungsseite und kopieren Sie die aktuell angezeigte IP-Adresse.

6.3 MCP stellt eine Verbindung her, aber das Token ist ungültig

Öffnen Sie die Seite mit den AI Agent-Einstellungen erneut:

1. Scrollen Sie zum Ende der Seite.
2. Finde den letzten Token.
3. Tippen Sie erneut auf die Schaltfläche „Kopieren“.
4. Stellen Sie sicher, dass der kopierte Wert keine Leerzeichen oder Zeilenumbrüche enthält.
5. Stellen Sie Codex das neue Token zur Verfügung.

6.4 Codex meldet, dass ein Gerät nicht existiert

Die DID bzw Endpunkt-ID Die von der alten App verwendete App steuert das Gerät möglicherweise nicht mehr direkt.

Bitten Sie Codex:

• Lesen Sie die aktuellen Geräte- und Entitätslisten.
• Ordnen Sie Geräte anhand von DID, Name, Raum und Gerätetyp zu.
• Fragen Sie die Fähigkeiten der Kandidatenentitäten ab.
• Erstellen Sie das Element mit der aktuellen Entitäts-ID neu.
• Beenden Sie die Migration dieses Elements, wenn keine eindeutige Übereinstimmung gefunden werden kann.

Codex sollte niemals eine unsichere Gerätezuordnung erraten.

6.5 Nach der Migration treten doppelte Daten auf

Dies kann passieren, wenn bereits eine passende Cloud-Szene oder Cloud-Automatisierung vorhanden ist.

Bevor Codex etwas erstellt, sollte er:

• Lesen Sie die vorhandenen Cloud-Daten.
• Vergleichen Sie Namen, Auslöser und Aktionen.
• Überspringen Sie Datensätze, die bereits identisch sind.
• Melden Sie Elemente mit übereinstimmenden Namen, aber unterschiedlichem Inhalt, anstatt sie automatisch zu überschreiben.

6.6 Wetterautomatisierungen können nicht migriert werden

Die alte App kann numerische Wettercodes verwenden, während die neue App möglicherweise Wetterentitätszustände verwendet, wie zum Beispiel:

verschneit
regnerisch
bewölkt
sonnig

Bitten Sie Codex, den Auslöser mit dem aktuellen neu zu erstellen Wetter Entität anstelle des direkten Kopierens des alten numerischen Wettercodes.

7. Sicherheitsempfehlungen

• Behandeln Sie das Token als MCP-Zugangsberechtigungsnachweis. Veröffentlichen Sie es nicht in Gruppenchats, Foren oder öffentlichen Dokumenten.
• Fügen Sie nicht den vollständigen Token in den Migrationsbericht ein.
• Wenn ein Token öffentlich geteilt wurde, generieren Sie es nach der Migration in der App neu.
• Löschen Sie bei der ersten Migration keine Altdaten.
• Erlauben Sie Codex nicht, während der ersten Migration Szenen auszuführen. Andernfalls könnten Geräte wie Klimaanlagen, Schlösser oder Lichter unerwartet gesteuert werden.
• Überprüfen Sie Automatisierungen mit sicherheitsrelevanten Geräten wie Schlössern, Alarmsystemen und Ventilen manuell, bevor Sie sie aktivieren.

Durch die Befolgung dieses Prozesses kann Codex die Verbindung, das Datenlesen, die Gerätezuordnung, die Validierung, die Erstellung und die abschließende Verifizierung in einem einzigen Arbeitsablauf abschließen und gleichzeitig die unsichere Praxis vermeiden, ältere Geräte-IDs direkt in die neuen Daten zu kopieren.