Was ist ThingsBoard MCP Server?
ThingsBoard MCP Server ist der Spring-Boot-Server der IoT-Plattform selbst, der MCP-Toolaufrufe in Anfragen an die REST-API von ThingsBoard übersetzt. Er arbeitet mit ThingsBoard Cloud, EU Cloud, selbst gehosteten Community- und Professional-Editionen sowie ThingsBoard Edge und deckt Geräte, Assets, Kunden, Benutzer, Alarme, Telemetrie und Attribute, Entitätsbeziehungen, OTA-Firmwarepakete, Entitätsgruppen der Professional Edition und eine gefilterte Abfragesprache für Entitätsdaten ab.
Er steht unter Apache-2.0, ist in Java 17 geschrieben, wird als Docker-Image thingsboard/mcp oder als JAR ausgeliefert und läuft über stdio oder SSE. Das Repository hat rund 99 Sterne; die letzte Version, v2.1.0, erschien am 17. Februar 2026, der letzte Commit am 26. Februar 2026.
ThingsBoard MCP Server installieren
docker run -i --rm -e THINGSBOARD_URL -e THINGSBOARD_API_KEY thingsboard/mcpLohnt sich ThingsBoard MCP Server?
Die Breite entsteht durch eine enge Abbildung der REST-API. Der Server registriert mehr als 120 Tools in 10 Gruppen: 11 für Geräte, 8 für Assets, 9 für Alarme, 11 für Telemetrie und Attribute, 11 für OTA-Pakete, 8 für Beziehungen, 7 für Kunden, 9 für Benutzer, 10 für Entitätsgruppen der Professional Edition und 40 für Entitätsdaten- und Zählabfragen, darunter drei Leitfaden-Tools, die dem Modell die Abfragesyntax erklären. Fragen wie die, welche Geräte eines Typs am letzten Tag eine Temperatur über einem Schwellenwert gemeldet haben, werden zu einer einzigen gefilterten Abfrage statt einer Seite voller REST-Aufrufe.
Die Zahl der Tools ist zugleich das erste Problem. Jede Gruppe hat einen Schalter per Umgebungsvariable, und das README zeigt, wie man für Clients mit kleinem Kontextfenster auf etwa 50 Tools kommt, indem man Entitätsabfragen, OTA, Gruppen und Benutzer abschaltet.
Schreibzugriff ist das größere Thema, und einen Nur-Lese-Schalter gibt es nicht. Dieselben Tools löschen Geräte, Benutzer und Beziehungen, speichern Telemetrie und Attribute, geben Gerätezugangsdaten zurück und weisen OTA-Firmware einem Gerät oder einem ganzen Geräteprofil zu. Gemeinsame Attribute und Firmwarezuweisungen erreichen echte Hardware, deshalb zählt die Anmeldung: ein API-Schlüssel (ab ThingsBoard 4.3) oder Benutzername und Passwort bei älteren Versionen, mit allen Rechten dieses Benutzers. Ein Benutzer auf Kundenebene mit engen Rechten ist der sicherere Standard als ein Tenant-Administrator.
Im Betrieb ist er konventionell. Docker über stdio ist der dokumentierte Weg; der SSE-Modus bindet standardmäßig an 127.0.0.1:8000, und das README beschreibt keine Authentifizierung am SSE-Endpunkt selbst. Seit Version 2.1.0 im Februar 2026 bewegt sich das Projekt langsam, mit 4 offenen Issues und Pull Requests zum Zeitpunkt der Prüfung.
Wo es sich lohnt
Ein Betriebsingenieur, der 400 Kühlketten-Sensoren überwacht
Herausfinden, welche Einheiten über Nacht ein Temperaturlimit überschritten haben, und die Alarme quittieren
Lass den Agenten eine Entitätsdatenabfrage nach Gerätetyp mit Telemetriefilter ausführen, die höchste Alarmstufe pro Gerät auflisten und nach Prüfung quittieren. Läuft in jedem Plan, der die Flotte fasst; Startup für 399 $/Monat deckt 500 Geräte ab.
Eine Firmware-Leiterin bei einem Hersteller von Industriesensoren
Prüfen, welche Geräte eines Profils das neueste OTA-Paket noch nicht haben
Mit countByDeviceProfileAndEmptyOtaPackage und getOtaPackagesByDeviceProfile die Lücke ermitteln und das Paket von Hand oder nach ausdrücklicher Freigabe zuweisen. OTA-Tools für normale Abfragesitzungen abgeschaltet lassen.
Ein Solutions Engineer, der eine Kundendemo vorbereitet
Einen frischen Tenant mit Beispielgeräten, Assets und Telemetrie füllen
Den Agenten Geräte mit createOrUpsertDevice anlegen, über Beziehungen mit Assets verknüpfen und erzeugte Zeitreihen mit saveEntityTelemetry schreiben lassen. Die 5 Geräte des kostenlosen Cloud-Plans reichen für eine kleine Demo.
Bevor du dich festlegst
- Einrichtung
- docker pull thingsboard/mcp, dann in Claude Desktop, Claude Code, Cursor oder VS Code mit THINGSBOARD_URL und THINGSBOARD_API_KEY eintragen. Ein JAR und ein Maven-Build aus dem Quellcode (Java 17, Maven 3.6) sind Alternativen.
- Integrationen
- ThingsBoard Cloud, EU Cloud, selbst gehostete CE und PE sowie Edge über ihre REST-APIs. Zehn Tool-Gruppen mit THINGSBOARD_TOOLS_*-Schaltern; allein die Gruppe für Entitätsabfragen und Leitfäden hat 40 Tools.
- Daten und Datenschutz
- Läuft lokal oder im eigenen Container und spricht nur mit deiner ThingsBoard-Instanz; Telemetrie und Entitätsdaten gehen an deinen Modellanbieter. Die Tools können Entitäten löschen, Attribute schreiben, Gerätezugangsdaten lesen und Firmware zuweisen.
- Kosten im großen Maßstab
- Der Server ist kostenlos. ThingsBoard Cloud: Prototype 49 $/Monat für 50 Geräte, Pilot 149 $ für 100, Startup 399 $ für 500, Business 749 $ für 1.000, zusätzliche Geräte je 0,30 $ bis 5.000.
- Grenzen
- Über 120 Tools in der Standardeinstellung können Kontextgrenzen von Clients sprengen; SSE bindet standardmäßig an 127.0.0.1:8000; die Anmeldung per API-Schlüssel braucht ThingsBoard 4.3 oder neuer, ältere Versionen nutzen Benutzername und Passwort, alle 1.800 Sekunden erneuert.
Was gut ist
- Offiziell, Apache-2.0, von ThingsBoard gepflegt
- Über 120 Tools für Geräte, Telemetrie, Alarme und OTA
- Gruppenschalter verkleinern die Liste auf etwa 50 Tools
- Läuft mit Cloud, Selbsthosting und Edge
Was nicht
- Kein Nur-Lese-Modus; Lösch- und Firmware-Tools immer aktiv
- Kann Gerätezugangsdaten an das Modell zurückgeben
- Authentifizierung des SSE-Endpunkts nicht dokumentiert
- Keine neue Version seit Februar 2026
Am besten für
IoT-Ingenieure und Betriebsteams, die bereits ThingsBoard nutzen und Flotten abfragen, Alarme sichten und Telemetrie prüfen wollen, aus einem Agenten mit bewusst eingeschränktem Konto.
Alternativen zu ThingsBoard MCP Server
ThingsBoard MCP Server: häufige Fragen
- Lohnt sich ThingsBoard MCP Server?
- Eine gründliche, vom Hersteller gebaute Brücke zwischen Agent und ThingsBoard-Tenant, deren Lösch-, Attribut- und Firmware-Tools ein eingeschränktes Konto verlangen, bevor sie auf produktive Geräte losgelassen werden. Wir bewerten es mit 3.9 von 5.
- Was kostet ThingsBoard MCP Server?
- Kostenlos (Apache-2.0). Braucht eine ThingsBoard-Instanz: Cloud-Pläne reichen von Free (5 Geräte) bis Business für 749 $/Monat (1.000 Geräte), alternativ Selbsthosting.
- Welche Nachteile hat ThingsBoard MCP Server?
- Kein Nur-Lese-Modus; Lösch- und Firmware-Tools immer aktiv; Kann Gerätezugangsdaten an das Modell zurückgeben; Authentifizierung des SSE-Endpunkts nicht dokumentiert; Keine neue Version seit Februar 2026.
- Für wen eignet sich ThingsBoard MCP Server?
- IoT-Ingenieure und Betriebsteams, die bereits ThingsBoard nutzen und Flotten abfragen, Alarme sichten und Telemetrie prüfen wollen, aus einem Agenten mit bewusst eingeschränktem Konto.
- Was kostet ThingsBoard MCP Server für ein Team oder im Produktivbetrieb?
- Der Server ist kostenlos. ThingsBoard Cloud: Prototype 49 $/Monat für 50 Geräte, Pilot 149 $ für 100, Startup 399 $ für 500, Business 749 $ für 1.000, zusätzliche Geräte je 0,30 $ bis 5.000.
- Ist ThingsBoard MCP Server sicher für Firmendaten?
- Läuft lokal oder im eigenen Container und spricht nur mit deiner ThingsBoard-Instanz; Telemetrie und Entitätsdaten gehen an deinen Modellanbieter. Die Tools können Entitäten löschen, Attribute schreiben, Gerätezugangsdaten lesen und Firmware zuweisen.
- Was sind die besten Alternativen zu ThingsBoard MCP Server?
- Die nächsten Alternativen, die wir getestet haben, sind Home Assistant MCP Server und Grafana MCP Server.
Antworten geprüft am 6. Nov. 2026.