O que é ThingsBoard MCP Server?
O ThingsBoard MCP Server é o servidor Spring Boot da própria plataforma de IoT que transforma chamadas de ferramentas MCP em requisições à API REST do ThingsBoard. Funciona com ThingsBoard Cloud, EU Cloud, as edições Community e Professional auto-hospedadas e ThingsBoard Edge, e cobre dispositivos, ativos, clientes, usuários, alarmes, telemetria e atributos, relações entre entidades, pacotes de firmware OTA, grupos de entidades da Professional Edition e uma linguagem de consulta filtrada de dados de entidades.
Tem licença Apache-2.0, é escrito em Java 17, é distribuído como imagem Docker thingsboard/mcp ou como JAR e roda por stdio ou SSE. O repositório tem cerca de 99 estrelas; a versão mais recente, v2.1.0, saiu em 17 de fevereiro de 2026, e o último commit é de 26 de fevereiro de 2026.
Como instalar ThingsBoard MCP Server
docker run -i --rm -e THINGSBOARD_URL -e THINGSBOARD_API_KEY thingsboard/mcpThingsBoard MCP Server vale a pena?
A amplitude vem de seguir de perto a API REST. O servidor registra mais de 120 ferramentas em 10 grupos: 11 para dispositivos, 8 para ativos, 9 para alarmes, 11 para telemetria e atributos, 11 para pacotes OTA, 8 para relações, 7 para clientes, 9 para usuários, 10 para grupos de entidades da Professional Edition e 40 para consultas de dados e contagens de entidades, incluindo três ferramentas de guia que explicam ao modelo a sintaxe das consultas. Perguntas como quais dispositivos de um tipo registraram temperatura acima de um limite no último dia viram uma única consulta filtrada em vez de uma página de chamadas REST.
A quantidade de ferramentas é também o primeiro problema. Cada grupo tem uma chave por variável de ambiente, e o README mostra como cair para cerca de 50 ferramentas em clientes com janela de contexto pequena, desligando consultas de entidades, OTA, grupos e usuários.
O acesso de escrita é a questão maior, e não há modo somente leitura. O mesmo conjunto de ferramentas exclui dispositivos, usuários e relações, grava telemetria e atributos, devolve credenciais de dispositivos e atribui firmware OTA a um dispositivo ou a um perfil de dispositivo inteiro. Atributos compartilhados e atribuições de firmware chegam ao hardware físico, então a credencial importa: uma chave de API (ThingsBoard 4.3 em diante) ou usuário e senha nas versões antigas, com todas as permissões desse usuário. Um usuário de nível cliente com permissões estreitas é um padrão mais seguro do que um administrador do tenant.
Na operação, é convencional. Docker por stdio é o caminho documentado; o modo SSE escuta por padrão em 127.0.0.1:8000, e o README não descreve autenticação no próprio endpoint SSE. O projeto anda devagar desde a versão 2.1.0 de fevereiro de 2026, com 4 issues e pull requests abertos no momento da verificação.
Onde ele se destaca
Um engenheiro de operações que monitora 400 sensores de cadeia fria
Descobrir quais unidades passaram de um limite de temperatura durante a noite e reconhecer os alarmes
Peça ao agente uma consulta de dados de entidades por tipo de dispositivo com filtro de telemetria, a lista da maior severidade de alarme por dispositivo e o reconhecimento depois da revisão. Roda em qualquer plano que comporte a frota; o Startup, a US$ 399/mês, cobre 500 dispositivos.
Uma líder de firmware num fabricante de sensores industriais
Ver quais dispositivos de um perfil ainda não têm o pacote OTA mais recente
Use countByDeviceProfileAndEmptyOtaPackage e getOtaPackagesByDeviceProfile para ver a lacuna e atribua o pacote à mão ou com aprovação explícita. Deixe as ferramentas OTA desligadas nas sessões de consulta do dia a dia.
Um engenheiro de soluções preparando uma demonstração para cliente
Preencher um tenant novo com dispositivos, ativos e telemetria de exemplo
Faça o agente criar dispositivos com createOrUpsertDevice, ligá-los a ativos por relações e gravar séries temporais geradas com saveEntityTelemetry. Os 5 dispositivos do plano Cloud gratuito bastam para uma demo pequena.
Antes de decidir
- Configuração
- docker pull thingsboard/mcp e depois adicione ao Claude Desktop, Claude Code, Cursor ou VS Code com THINGSBOARD_URL e THINGSBOARD_API_KEY. Um JAR e um build com Maven a partir do código (Java 17, Maven 3.6) são alternativas.
- Integrações
- ThingsBoard Cloud, EU Cloud, CE e PE auto-hospedados e Edge pelas suas APIs REST. Dez grupos de ferramentas com chaves THINGSBOARD_TOOLS_*; só o grupo de consultas de entidades e guias tem 40 ferramentas.
- Dados e privacidade
- Roda localmente ou no seu próprio contêiner e fala apenas com a sua instância do ThingsBoard; telemetria e dados de entidades vão para o seu provedor de modelos. As ferramentas podem excluir entidades, gravar atributos, ler credenciais de dispositivos e atribuir firmware.
- Custo em escala
- O servidor é gratuito. ThingsBoard Cloud: Prototype US$ 49/mês para 50 dispositivos, Pilot US$ 149 para 100, Startup US$ 399 para 500, Business US$ 749 para 1.000, com dispositivos extras a US$ 0,30 cada até 5.000.
- Limites
- Mais de 120 ferramentas no padrão podem estourar os limites de contexto dos clientes; o SSE escuta por padrão em 127.0.0.1:8000; o login por chave de API exige ThingsBoard 4.3 ou mais recente, e versões antigas usam usuário e senha renovados a cada 1.800 segundos.
O que é bom
- Oficial, Apache-2.0, mantido pelo ThingsBoard
- Mais de 120 ferramentas para dispositivos, telemetria, alarmes e OTA
- Chaves por grupo para reduzir a lista a cerca de 50 ferramentas
- Funciona com Cloud, auto-hospedagem e Edge
O que não é
- Sem modo somente leitura; ferramentas de exclusão e firmware sempre ativas
- Pode devolver credenciais de dispositivos ao modelo
- Autenticação do endpoint SSE não documentada
- Nenhuma versão nova desde fevereiro de 2026
Ideal para
Engenheiros de IoT e equipes de operações que já usam o ThingsBoard e querem consultar frotas, triar alarmes e inspecionar telemetria a partir de um agente com uma conta deliberadamente limitada.
Alternativas ao ThingsBoard MCP Server
ThingsBoard MCP Server: perguntas frequentes
- ThingsBoard MCP Server vale a pena?
- Uma ponte completa, feita pelo próprio fabricante, entre um agente e um tenant do ThingsBoard, cujas ferramentas de exclusão, atributos e firmware pedem uma conta com permissões limitadas antes de apontá-lo para dispositivos em produção. Damos nota 3.9 de 5.
- Quanto custa ThingsBoard MCP Server?
- Gratuito (Apache-2.0). Precisa de uma instância do ThingsBoard: os planos Cloud vão do Free (5 dispositivos) ao Business a US$ 749/mês (1.000 dispositivos), ou auto-hospedagem.
- Quais são as desvantagens de ThingsBoard MCP Server?
- Sem modo somente leitura; ferramentas de exclusão e firmware sempre ativas; pode devolver credenciais de dispositivos ao modelo; autenticação do endpoint SSE não documentada; nenhuma versão nova desde fevereiro de 2026.
- Para quem ThingsBoard MCP Server é indicado?
- Engenheiros de IoT e equipes de operações que já usam o ThingsBoard e querem consultar frotas, triar alarmes e inspecionar telemetria a partir de um agente com uma conta deliberadamente limitada.
- Quanto custa ThingsBoard MCP Server para uma equipe ou em produção?
- O servidor é gratuito. ThingsBoard Cloud: Prototype US$ 49/mês para 50 dispositivos, Pilot US$ 149 para 100, Startup US$ 399 para 500, Business US$ 749 para 1.000, com dispositivos extras a US$ 0,30 cada até 5.000.
- ThingsBoard MCP Server é seguro para dados da empresa?
- Roda localmente ou no seu próprio contêiner e fala apenas com a sua instância do ThingsBoard; telemetria e dados de entidades vão para o seu provedor de modelos. As ferramentas podem excluir entidades, gravar atributos, ler credenciais de dispositivos e atribuir firmware.
- Quais são as melhores alternativas ao ThingsBoard MCP Server?
- As alternativas mais próximas que analisamos são Home Assistant MCP Server e Grafana MCP Server.
Respostas verificadas em 6 de nov. de 2026.