Ihre Geräte melden rund um die Uhr Daten an TagoIO. Sie haben Dashboards, die diese Daten anzeigen, und eine API, die sie ausliefert. Und jetzt gibt es KI-Assistenten wie Claude, die wirklich gut darin sind, Daten zu interpretieren, Skripte zu schreiben und Fragen in natürlicher Sprache zu beantworten. Der naheliegende Schritt ist, einen davon auf Ihre IoT-Plattform zu richten und ihm Fragen zu stellen.
Doch es gibt eine Lücke. Dashboards und APIs setzen weiterhin voraus, dass Sie wissen, wo Sie suchen und wie Sie abfragen müssen. Ein Dashboard zeigt das, was jemand entschieden hat, darauf zu platzieren. Die API beantwortet Fragen, die Sie bereits zu formulieren wissen. Ein KI-Assistent hilft nur dann, wenn er tatsächlich auf Ihre Live-Daten zugreifen, Ihre Gerätestruktur verstehen und in Ihrem Auftrag Abfragen ausführen kann. Ohne Verbindung zu Ihren echten Daten rät er nur.
Sie brauchen also eine Leitung zwischen dem Assistenten und Ihren IoT-Daten. Diese Leitung ist das Model Context Protocol (MCP), und der TagoIO MCP Server ist die Implementierung, die einen KI-Client mit Ihrem Konto verbindet. Diese Anleitung führt Sie Schritt für Schritt durch die Einrichtung, mit Claude Desktop als Beispiel-Client.
Was MCP leistet, kurz gefasst
Das Model Context Protocol ist ein offener Standard, der KI-Assistenten über eine einheitliche Schnittstelle mit externen Tools und Datenquellen kommunizieren lässt. Statt dass jede App ihr eigenes Plugin-Format erfindet, gibt MCP dem Assistenten einen einheitlichen Weg, um zu erkennen, was ein Server kann, und ihn aufzurufen. Wenn Sie den vollständigen Hintergrund möchten, lesen Sie unseren begleitenden Beitrag, Was ist das Model Context Protocol (MCP) für IoT.
Für TagoIO macht der MCP Server Ihre Geräte und Daten zugänglich, sodass ein Assistent sie lesen, Fragen in natürlicher Sprache beantworten und sogar Analysis-Skripte sowie Dashboards aus einer Beschreibung heraus erzeugen kann. Der Assistent übernimmt das Denken. Der MCP Server übernimmt den Zugriff.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie diese vier Dinge haben:
- Ein TagoIO-Konto. Der kostenlose Plan deckt 5 Geräte und 5 Dashboards ab, was zum Ausprobieren völlig ausreicht. Registrieren Sie sich unter tago.io, falls Sie noch kein Konto haben.
- Einen TagoIO-Token. Der MCP Server authentifiziert sich mit einem Token bei Ihrem Konto. Erstellen Sie einen Token, der genau auf das beschränkt ist, was Sie wirklich benötigen (mehr zur Beschränkung weiter unten).
- Den TagoIO MCP Server. Er ist Open Source, mit einem öffentlichen GitHub-Repository und einem Artikel im Help Center.
- Einen MCP-kompatiblen Client. Diese Anleitung verwendet Claude Desktop, aber derselbe Server funktioniert mit den Claude-Apps, ChatGPT, Cursor, Windsurf und KI-Erweiterungen für VS Code.
TagoIO MCP Server installieren und konfigurieren
Der TagoIO MCP Server unterstützt zwei Transportmodi, und welchen Sie wählen, hängt davon ab, wo er laufen soll.
Lokaler Modus (stdio)
Im lokalen Modus läuft der MCP Server als Prozess auf Ihrem eigenen Rechner und kommuniziert mit dem Client über Standardein- und -ausgabe (stdio). Der Client startet den Server, der Server spricht mit TagoIO über Ihren Token, und alles bleibt lokal, abgesehen von den Aufrufen an die TagoIO API. Das ist die einfachste Einrichtung und eine gute Standardwahl für eine einzelne Entwicklerin oder einen einzelnen Entwickler, die auf einem Rechner arbeiten.
Sie konfigurieren den lokalen Modus, indem Sie Ihrem Client mitteilen, wie der Server zu starten ist, und ihm Ihren TagoIO-Token übergeben. Der genaue Befehl und die Art, wie Sie den Token bereitstellen, sind im TagoIO MCP Help-Center-Artikel dokumentiert. Folgen Sie also den dortigen aktuellen Anweisungen, statt eine Option zu kopieren, die sich zwischen den Versionen geändert haben könnte.
Remote-Modus (HTTP)
Version 3.0.0 des TagoIO MCP Servers hat zusätzlich zum lokalen stdio die Unterstützung für Remote-HTTP hinzugefügt. In diesem Modus ist der Server über HTTP erreichbar, sodass Sie den Client auf einen Endpunkt richten, statt einen lokalen Prozess zu starten. Das ist nützlich, wenn Sie eine gemeinsame Einrichtung wünschen, wenn Client und Server auf verschiedenen Rechnern liegen oder wenn Sie überhaupt keinen lokalen Prozess ausführen möchten.
Der Remote-Modus verändert, wo Ihr Token gespeichert ist und wie Verbindungen abgesichert werden. Sehen Sie sich daher die Dokumentation zur HTTP-Konfiguration an und behandeln Sie Endpunkt und Token mit derselben Sorgfalt wie jede produktive Zugangsberechtigung.
Wenn Sie nur programmatischen Zugriff aus Ihrem eigenen Code benötigen, brauchen Sie MCP überhaupt nicht. Die schlichte TagoIO REST API ist dafür weiterhin das richtige Werkzeug. MCP verdient seinen Platz, wenn Sie auf Ihren Daten Abläufe mit natürlicher Sprache und KI-Unterstützung aufbauen möchten.
Claude Desktop verbinden
Claude Desktop liest seine MCP Server aus einer Konfigurationsdatei. Um den TagoIO Server hinzuzufügen, bearbeiten Sie diese Konfigurationsdatei und fügen einen Eintrag hinzu, der den Server benennt und Claude mitteilt, wie er ihn erreicht: im lokalen Modus den Befehl zum Starten des Servers und Ihren Token, im Remote-Modus den HTTP-Endpunkt.
Die Struktur ist ein JSON-Objekt mit einem Eintrag pro MCP Server. Sie geben dem TagoIO Server einen Namen, legen den Transport fest und stellen die Zugangsdaten bereit. Der TagoIO Help-Center-Artikel zeigt den aktuellen Konfigurationsblock zum Einfügen, einschließlich der genauen Feldnamen. Verwenden Sie diesen als Ihre verlässliche Quelle, speichern Sie dann die Datei und starten Sie Claude Desktop neu, damit der neue Server erkannt wird.
Dasselbe Prinzip gilt für die anderen Clients. ChatGPT, Cursor, Windsurf und KI-Erweiterungen für VS Code haben jeweils ihren eigenen Ort, um einen MCP Server zu registrieren, aber die Angaben, die Sie machen, sind dieselben: ein Name, ein Transportmodus und Ihr Token oder Endpunkt.
Funktion überprüfen
Bestätigen Sie nach dem Neustart Ihres Clients die Verbindung, bevor Sie sich darauf verlassen.
- Prüfen Sie, ob der Client den TagoIO Server als verbunden auflistet. Die meisten Clients zeigen verfügbare MCP-Tools oder -Server irgendwo in ihrer Oberfläche an.
- Stellen Sie eine einfache Frage, die einen Zugriff auf Ihr Konto erfordert, etwa das Auflisten Ihrer Geräte. Wenn der Assistent mit Ihren tatsächlichen Gerätenamen antwortet, steht die Leitung.
- Wenn etwas nicht stimmt, ist der Live Inspector von TagoIO hilfreich, um zu bestätigen, dass auf der Geräteseite Daten fließen. So erkennen Sie, ob das Problem beim Gerät, bei den Daten oder bei der MCP-Verbindung liegt.
Beispiel-Prompts zum Ausprobieren
Einmal verbunden, zeigt sich der Mehrwert in dem, was Sie fragen können. Ein paar Prompts zum Ausprobieren:
- “Liste meine Geräte auf und sage mir, welche in den letzten 24 Stunden keine Daten gemeldet haben.”
- “Zeige mir die neuesten Temperaturmesswerte für Gerät X und fasse den Trend der letzten Woche zusammen.”
- “Schreibe ein TagoIO Analysis-Skript, das eine Warnung sendet, wenn ein Sensorwert einen Schwellenwert überschreitet.”
- “Erstelle ein Dashboard-Layout, das den Status aller meiner Geräte auf einen Blick zeigt.”
Bei den ersten beiden nutzt der Assistent den MCP Server, um Ihre Daten zu lesen, und für das Erzeugen von Skript und Dashboard sein eigenes Denken zusammen mit dem TagoIO-Kontext. Sie prüfen weiterhin, was er produziert. Erzeugte Analysis-Skripte und Dashboards sind ein Ausgangspunkt, nichts, das man ungelesen ausliefert.
Token-Beschränkung und Sicherheit
Der MCP Server handelt mit den Berechtigungen des Tokens, den Sie ihm geben, daher kommt es auf die Beschränkung an.
- Geben Sie dem Token nur die geringstmöglichen Rechte. Wenn der Assistent nur Daten lesen muss, geben Sie ihm keinen Token, der Geräte löschen kann.
- Behandeln Sie den Token als Geheimnis. Fügen Sie ihn nicht in geteilte Chats ein, committen Sie ihn nicht in ein Repository und packen Sie ihn nicht in einen Screenshot. Achten Sie im Remote-Modus besonders darauf, wo der Token gespeichert ist und wer den Endpunkt erreichen kann.
- Rotieren Sie Tokens, wenn Sie eine Offenlegung vermuten, und entfernen Sie Tokens, die Sie nicht mehr verwenden.
Der Komfort, einen Assistenten alles fragen zu können, ist real, aber er arbeitet mit genau dem Zugriff, den Sie ihm gewähren. Gewähren Sie ihn bewusst.
Häufige Probleme beheben
- Der Client zeigt den TagoIO Server nicht an. Prüfen Sie die Konfigurationsdatei erneut auf gültiges JSON (ein fehlendes Komma oder eine fehlende Klammer ist meist die Ursache) und stellen Sie sicher, dass Sie den Client nach dem Bearbeiten neu gestartet haben.
- Der Server verbindet sich, kann aber keine Daten lesen. Das liegt fast immer am Token: Er ist entweder falsch, abgelaufen oder zu eng für das beschränkt, was Sie angefragt haben. Überprüfen Sie den Token in Ihrem TagoIO-Konto.
- Der lokale Modus startet nicht. Vergewissern Sie sich, dass der Befehl und jede benötigte Laufzeitumgebung installiert und in Ihrem Pfad sind, und prüfen Sie dann den Help-Center-Artikel auf den aktuellen Startbefehl.
- Der Remote-Modus läuft in eine Zeitüberschreitung. Vergewissern Sie sich, dass der Endpunkt von Ihrem Rechner aus erreichbar ist und dass nichts dazwischen die Verbindung blockiert.
- Daten wirken veraltet oder leer. Nutzen Sie den Live Inspector, um zu bestätigen, dass das Gerät tatsächlich sendet, damit Sie nicht die Verbindung debuggen, während das eigentliche Problem beim Gerät liegt.
Dieselben Schritte gelten auch anderswo
Alles oben verwendete Claude Desktop, aber nichts davon ist auf Claude beschränkt. ChatGPT, Cursor, Windsurf und KI-Erweiterungen für VS Code sind alle MCP-kompatibel und verbinden sich auf dieselbe Weise mit dem TagoIO MCP Server. Wählen Sie den Client, den Sie ohnehin schon nutzen. Der Server, der Token und die Daten sind auf der anderen Seite dieselben.
Zusammenfassung
Dashboards und APIs sind weiterhin die richtigen Werkzeuge, wenn Sie genau wissen, was Sie wollen und wie Sie danach fragen. MCP füllt die Lücke, wenn Sie lieber in natürlicher Sprache fragen und einen KI-Assistenten den Zugriff und das Denken übernehmen lassen möchten. So richten Sie es ein: Besorgen Sie sich ein TagoIO-Konto und einen beschränkten Token, installieren Sie den TagoIO MCP Server im lokalen oder Remote-Modus, registrieren Sie ihn in der Konfiguration Ihres Clients, überprüfen Sie die Verbindung mit einem einfachen Prompt und halten Sie Ihren Token gut abgesichert. Fragen Sie dann Ihren Assistenten nach Ihren Geräten und lassen Sie ihn mit Ihren echten Daten arbeiten.
Ressourcen
- Dokumentation zum TagoIO MCP Server
- Was ist das Model Context Protocol (MCP) für IoT, der begleitende Beitrag
- TagoIO Preise und Pläne
