¿Qué es ThingsBoard MCP Server?
ThingsBoard MCP Server es el servidor Spring Boot de la propia plataforma IoT que convierte las llamadas a herramientas MCP en peticiones a la API REST de ThingsBoard. Funciona con ThingsBoard Cloud, EU Cloud, las ediciones Community y Professional autoalojadas y ThingsBoard Edge, y cubre dispositivos, activos, clientes, usuarios, alarmas, telemetría y atributos, relaciones entre entidades, paquetes de firmware OTA, grupos de entidades de la Professional Edition y un lenguaje de consulta filtrada de datos de entidades.
Tiene licencia Apache-2.0, está escrito en Java 17, se distribuye como imagen de Docker thingsboard/mcp o como JAR y funciona por stdio o SSE. El repositorio tiene unas 99 estrellas; la última versión, v2.1.0, salió el 17 de febrero de 2026, y el último commit es del 26 de febrero de 2026.
Cómo instalar ThingsBoard MCP Server
docker run -i --rm -e THINGSBOARD_URL -e THINGSBOARD_API_KEY thingsboard/mcp¿Merece la pena ThingsBoard MCP Server?
La amplitud viene de seguir de cerca la API REST. El servidor registra más de 120 herramientas en 10 grupos: 11 para dispositivos, 8 para activos, 9 para alarmas, 11 para telemetría y atributos, 11 para paquetes OTA, 8 para relaciones, 7 para clientes, 9 para usuarios, 10 para grupos de entidades de la Professional Edition y 40 para consultas de datos y recuentos de entidades, incluidas tres herramientas de guía que explican al modelo la sintaxis de las consultas. Preguntas como qué dispositivos de un tipo registraron una temperatura por encima de un umbral en el último día se convierten en una sola consulta filtrada en lugar de una página de llamadas REST.
El número de herramientas es también el primer problema. Cada grupo tiene un interruptor por variable de entorno, y el README muestra cómo bajar a unas 50 herramientas para clientes con ventanas de contexto pequeñas desactivando las consultas de entidades, OTA, grupos y usuarios.
El acceso de escritura es el problema mayor, y no hay modo de solo lectura. El mismo conjunto de herramientas borra dispositivos, usuarios y relaciones, guarda telemetría y atributos, devuelve credenciales de dispositivos y asigna firmware OTA a un dispositivo o a un perfil de dispositivo entero. Los atributos compartidos y las asignaciones de firmware llegan al hardware físico, así que la credencial importa: una clave de API (ThingsBoard 4.3 y posteriores) o usuario y contraseña en versiones anteriores, con los permisos que tenga ese usuario. Un usuario de nivel cliente con permisos estrechos es una opción por defecto más segura que un administrador del tenant.
En lo operativo es convencional. Docker por stdio es la vía documentada; el modo SSE escucha por defecto en 127.0.0.1:8000, y el README no describe autenticación en el propio endpoint SSE. El proyecto avanza despacio desde la versión 2.1.0 de febrero de 2026, con 4 incidencias y pull requests abiertos en el momento de la comprobación.
Dónde se gana su sitio
Un ingeniero de operaciones que vigila 400 sensores de cadena de frío
Saber qué unidades superaron un límite de temperatura durante la noche y reconocer las alarmas
Pide al agente una consulta de datos de entidades por tipo de dispositivo con filtro de telemetría, que liste la mayor severidad de alarma por dispositivo y reconozca las alarmas tras revisarlas. Funciona en cualquier plan que admita la flota; Startup, a 399 $/mes, cubre 500 dispositivos.
Una responsable de firmware en un fabricante de sensores industriales
Ver qué dispositivos de un perfil aún no tienen el último paquete OTA
Usa countByDeviceProfileAndEmptyOtaPackage y getOtaPackagesByDeviceProfile para ver la diferencia y asigna el paquete a mano o con aprobación explícita. Mantén desactivadas las herramientas OTA en las sesiones de consulta del día a día.
Un ingeniero de soluciones que prepara una demo para un cliente
Poblar un tenant nuevo con dispositivos, activos y telemetría de ejemplo
Haz que el agente cree dispositivos con createOrUpsertDevice, los vincule a activos con relaciones y escriba series temporales generadas con saveEntityTelemetry. Los 5 dispositivos del plan Cloud gratuito bastan para una demo pequeña.
Antes de decidirte
- Puesta en marcha
- docker pull thingsboard/mcp y luego añádelo a Claude Desktop, Claude Code, Cursor o VS Code con THINGSBOARD_URL y THINGSBOARD_API_KEY. Un JAR y una compilación con Maven desde el código (Java 17, Maven 3.6) son alternativas.
- Integraciones
- ThingsBoard Cloud, EU Cloud, CE y PE autoalojados y Edge a través de sus API REST. Diez grupos de herramientas con interruptores THINGSBOARD_TOOLS_*; solo el grupo de consultas de entidades y guías tiene 40 herramientas.
- Datos y privacidad
- Se ejecuta en local o en tu propio contenedor y habla solo con tu instancia de ThingsBoard; la telemetría y los datos de entidades van a tu proveedor de modelos. Las herramientas pueden borrar entidades, escribir atributos, leer credenciales de dispositivos y asignar firmware.
- Coste a escala
- El servidor es gratuito. ThingsBoard Cloud: Prototype 49 $/mes para 50 dispositivos, Pilot 149 $ para 100, Startup 399 $ para 500, Business 749 $ para 1.000, con dispositivos extra a 0,30 $ cada uno hasta 5.000.
- Límites
- Más de 120 herramientas por defecto pueden superar los límites de contexto del cliente; SSE escucha por defecto en 127.0.0.1:8000; el acceso con clave de API necesita ThingsBoard 4.3 o posterior, y las versiones antiguas usan usuario y contraseña renovados cada 1.800 segundos.
Lo bueno
- Oficial, Apache-2.0, mantenido por ThingsBoard
- Más de 120 herramientas para dispositivos, telemetría, alarmas y OTA
- Interruptores por grupo para bajar a unas 50 herramientas
- Funciona con Cloud, autoalojado y Edge
Lo malo
- Sin modo de solo lectura; las herramientas de borrado y firmware siempre activas
- Puede devolver credenciales de dispositivos al modelo
- Autenticación del endpoint SSE no documentada
- Sin versiones nuevas desde febrero de 2026
Ideal para
Ingenieros de IoT y equipos de operaciones que ya usan ThingsBoard y quieren consultar flotas, clasificar alarmas e inspeccionar telemetría desde un agente con una cuenta deliberadamente limitada.
Alternativas a ThingsBoard MCP Server
ThingsBoard MCP Server: preguntas frecuentes
- ¿Merece la pena ThingsBoard MCP Server?
- Un puente completo, hecho por el propio fabricante, entre un agente y un tenant de ThingsBoard, cuyas herramientas de borrado, atributos y firmware piden una cuenta con permisos limitados antes de apuntarlo a dispositivos en producción. Le damos un 3.9 sobre 5.
- ¿Cuánto cuesta ThingsBoard MCP Server?
- Gratuito (Apache-2.0). Necesita una instancia de ThingsBoard: los planes Cloud van desde Free (5 dispositivos) hasta Business a 749 $/mes (1.000 dispositivos), o autoalojamiento.
- ¿Qué inconvenientes tiene ThingsBoard MCP Server?
- Sin modo de solo lectura; las herramientas de borrado y firmware siempre activas; puede devolver credenciales de dispositivos al modelo; autenticación del endpoint SSE no documentada; sin versiones nuevas desde febrero de 2026.
- ¿Para quién es ThingsBoard MCP Server?
- Ingenieros de IoT y equipos de operaciones que ya usan ThingsBoard y quieren consultar flotas, clasificar alarmas e inspeccionar telemetría desde un agente con una cuenta deliberadamente limitada.
- ¿Cuánto cuesta ThingsBoard MCP Server para un equipo o en producción?
- El servidor es gratuito. ThingsBoard Cloud: Prototype 49 $/mes para 50 dispositivos, Pilot 149 $ para 100, Startup 399 $ para 500, Business 749 $ para 1.000, con dispositivos extra a 0,30 $ cada uno hasta 5.000.
- ¿Es ThingsBoard MCP Server seguro para los datos de la empresa?
- Se ejecuta en local o en tu propio contenedor y habla solo con tu instancia de ThingsBoard; la telemetría y los datos de entidades van a tu proveedor de modelos. Las herramientas pueden borrar entidades, escribir atributos, leer credenciales de dispositivos y asignar firmware.
- ¿Cuáles son las mejores alternativas a ThingsBoard MCP Server?
- Las alternativas más cercanas que hemos analizado son Home Assistant MCP Server y Grafana MCP Server.
Respuestas comprobadas el 6 nov 2026.