ThingsBoard MCP Server의 개요
ThingsBoard MCP Server는 IoT 플랫폼이 직접 만든 Spring Boot 서버로, MCP 도구 호출을 ThingsBoard REST API 요청으로 바꿉니다. ThingsBoard Cloud, EU Cloud, 자체 호스팅 Community 및 Professional Edition, ThingsBoard Edge에서 동작하며 기기, 자산, 고객, 사용자, 알람, 텔레메트리와 속성, 엔티티 관계, OTA 펌웨어 패키지, Professional Edition 엔티티 그룹, 엔티티 데이터를 걸러 내는 쿼리 언어를 다룹니다.
Apache-2.0 라이선스에 Java 17로 작성되었고, Docker 이미지 thingsboard/mcp나 JAR로 배포되며 stdio 또는 SSE로 실행됩니다. 저장소의 별은 약 99개이고, 최신 릴리스 v2.1.0은 2026년 2월 17일, 마지막 커밋은 2026년 2월 26일입니다.
ThingsBoard MCP Server 설치 방법
docker run -i --rm -e THINGSBOARD_URL -e THINGSBOARD_API_KEY thingsboard/mcpThingsBoard MCP Server, 쓸 만한 가치가 있습니까?
폭넓음은 REST API를 충실히 옮긴 데서 나옵니다. 서버는 10개 그룹에 120개 이상의 도구를 등록합니다. 기기 11개, 자산 8개, 알람 9개, 텔레메트리와 속성 11개, OTA 패키지 11개, 관계 8개, 고객 7개, 사용자 9개, Professional Edition 엔티티 그룹 10개, 그리고 엔티티 데이터·개수 조회 40개이며, 이 40개에는 모델에 쿼리 문법을 설명하는 가이드 도구 3개가 포함됩니다. 특정 유형의 기기 중 지난 하루 동안 임계값을 넘는 온도를 보고한 것은 무 엇인가 같은 질문이 REST 호출 한 페이지가 아니라 필터링된 쿼리 하나로 끝납니다.
도구 수는 첫 번째 문제이기도 합니다. 그룹마다 환경 변수 스위치가 있고, README는 엔티티 조회, OTA, 그룹, 사용자를 꺼서 컨텍스트 창이 작은 클라이언트용으로 약 50개까지 줄이는 방법을 보여 줍니다.
더 큰 문제는 쓰기 권한이며, 읽기 전용 스위치가 없습니다. 같은 도구 모음이 기기, 사용자, 관계를 삭제하고 텔레메트리와 속성을 저장하며 기기 자격 증명을 돌려주고 OTA 펌웨어를 기기 하나나 기기 프로필 전체에 할당합니다. 공유 속성과 펌웨어 할당은 실제 하드웨어에 닿으므로 자격 증명이 중요합니다. API 키(ThingsBoard 4.3 이상)나 이전 버전의 사용자 이름과 비밀번호를 쓰며, 그 사용자가 가진 권한이 그대로 적용됩니다. 테넌트 관리자보다 권한을 좁힌 고객 수준 사용자가 더 안전한 기본값입니다.
운영 면에서는 평범합니다. stdio로 실행하는 Docker가 문서화된 방법이고, SSE 모드는 기본적으로 127.0.0.1:8000에 바인딩되며, README는 SSE 엔드포인트 자체의 인증을 설명하지 않습니다. 2026년 2월 2.1.0 이후 프로젝트 진행은 느리며, 확인 시점에 열린 이슈와 풀 리퀘스트는 4개였습니다.
제 역할을 하는 곳
콜드체인 센서 400대를 감시하는 운영 엔지니어
밤사이 온도 한도를 넘은 장치를 찾고 알람을 확인 처리
에이전트에게 텔레메트리 필터가 걸린 기기 유형별 엔티티 데이터 조회를 실행하게 하고, 기기별 최고 알람 심각도를 나열한 뒤 검토 후 확인 처리합니다. 기기 군을 담을 수 있는 어떤 플랜에서도 동작하며, 월 $399 Startup은 기기 500대를 지원합니다.
산업용 센서 제조사의 펌웨어 책임자
프로필 안에서 아직 최신 OTA 패키지가 없는 기기 확인
countByDeviceProfileAndEmptyOtaPackage와 getOtaPackagesByDeviceProfile로 차이를 확인하고, 패키지 할당은 직접 하거나 명시적 승인 후에 합니다. 일상적인 조회 세션에서는 OTA 도구를 꺼 둡니다.
고객 데모를 준비하는 솔루션 엔지니어
새 테넌트에 예시 기기, 자산, 텔레메트리 채우기
에이전트가 createOrUpsertDevice로 기기를 만들고 관계로 자산에 연결하며 saveEntityTelemetry로 생성한 시계열을 기록하게 합니다. 작은 데모라면 무료 Cloud 플랜의 기기 5대로 충분합니다.
도입 전 확인할 점
- 설정
- docker pull thingsboard/mcp를 실행한 뒤 THINGSBOARD_URL과 THINGSBOARD_API_KEY를 지정해 Claude Desktop, Claude Code, Cursor, VS Code에 추가합니다. JAR나 소스에서의 Maven 빌드(Java 17, Maven 3.6)도 가능합니다.
- 연동
- ThingsBoard Cloud, EU Cloud, 자체 호스팅 CE와 PE, Edge에 각각의 REST API로 연결합니다. THINGSBOARD_TOOLS_* 스위치가 있는 도구 그룹 10개가 있으며, 엔티티 조회와 가이드 그룹만 40개입니다.
- 데이터와 개인정보
- 로컬이나 자체 컨테이너에서 실행되고 자신의 ThingsBoard 인스턴스와만 통신하지만, 텔레메트리와 엔티티 데이터는 모델 제공자에게 전달됩니다. 도구는 엔티티 삭제, 속성 쓰기, 기기 자격 증명 읽기, 펌웨어 할당을 할 수 있습니다.
- 대규모 사용 시 비용
- 서버는 무료입니다. ThingsBoard Cloud는 Prototype 월 $49에 기기 50대, Pilot $149에 100대, Startup $399에 500대, Business $749에 1,000대이며, 추가 기기는 대당 $0.30으로 5,000대까지입니다.
- 제한
- 기본 120개 이상의 도구는 클라이언트 컨텍스트 한도를 넘을 수 있습니다. SSE 기본값은 127.0.0.1:8000입니다. API 키 로그인에는 ThingsBoard 4.3 이상이 필요하며, 이전 버전은 사용자 이름과 비밀번호를 1,800초마다 갱신합니다.
좋은 점
- ThingsBoard가 관리하는 공식 Apache-2.0 서버
- 기기, 텔레메트리, 알람, OTA를 아우르는 120개 이상의 도구
- 그룹별 스위치로 약 50개까지 축소 가능
- Cloud, 자체 호스팅, Edge에서 동작
아쉬운 점
- 읽기 전용 모드가 없고 삭제·펌웨어 도구가 항상 켜져 있음
- 기기 자격 증명을 모델에 돌려줄 수 있음
- SSE 엔드포인트 인증이 문서화되지 않음
- 2026년 2월 이후 새 릴리스 없음
추천 대상
이미 ThingsBoard를 쓰면서 일부러 권한을 제한한 계정으로 에이전트에서 기기 군을 조회하고 알람을 분류하며 텔레메트리를 살펴보려는 IoT 엔지니어와 운영팀.
ThingsBoard MCP Server 대안
ThingsBoard MCP Server: 자주 묻는 질문
- ThingsBoard MCP Server, 쓸 만한 가치가 있습니까?
- 에이전트와 ThingsBoard 테넌트를 잇는 제조사의 꼼꼼한 다리이지만, 삭제·속성·펌웨어 도구가 있어 운영 중인 기기에 연결하기 전에 권한을 좁힌 계정이 필요합니다. 평점은 5점 만점에 3.9점입니다.
- ThingsBoard MCP Server의 가격은 얼마입니까?
- 무료(Apache-2.0). ThingsBoard 인스턴스가 필요하며, Cloud 플랜은 Free(기기 5대)부터 월 $749인 Business(기기 1,000대)까지 있고 자체 호스팅도 가능합니다.
- ThingsBoard MCP Server의 단점은 무엇입니까?
- 읽기 전용 모드가 없고 삭제·펌웨어 도구가 항상 켜져 있음; 기기 자격 증명을 모델에 돌려줄 수 있음; SSE 엔드포인트 인증이 문서화되지 않음; 2026년 2월 이후 새 릴리스 없음.
- ThingsBoard MCP Server에 적합한 사람은 누구입니까?
- 이미 ThingsBoard를 쓰면서 일부러 권한을 제한한 계정으로 에이전트에서 기기 군을 조회하고 알람을 분류하며 텔레메트리를 살펴보려는 IoT 엔지니어와 운영팀.
- 팀이나 프로덕션 환경에서 ThingsBoard MCP Server의 비용은 얼마입니까?
- 서버는 무료입니다. ThingsBoard Cloud는 Prototype 월 $49에 기기 50대, Pilot $149에 100대, Startup $399에 500대, Business $749에 1,000대이며, 추가 기기는 대당 $0.30으로 5,000대까지입니다.
- ThingsBoard MCP Server에 회사 데이터를 맡겨도 안전합니까?
- 로컬이나 자체 컨테이너에서 실행되고 자신의 ThingsBoard 인스턴스와만 통신하지만, 텔레메트리와 엔티티 데이터는 모델 제공자에게 전달됩니다. 도구는 엔티티 삭제, 속성 쓰기, 기기 자격 증명 읽기, 펌웨어 할당을 할 수 있습니다.
- ThingsBoard MCP Server의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Home Assistant MCP Server 및 Grafana MCP Server입니다.
답변 확인일: 2026년 11월 6일.