Для чего этот сервер?

Этот MCP-сервер соединяет AI-агентов с платформой ThingsBoard, чтобы инженеры и разработчики управляли IoT-устройствами, телеметрией и сущностями через естественный язык. Вместо API-запросов или скриптов можно просто попросить ассистента найти устройства, считать показатели, обновить атрибуты или проанализировать аномалии. Сервер экономит время на рутинных операциях и упрощает работу с IoT-мониторингом, не требуя знания специфики платформы.

Каталог MCP
thingsboard/thingsboard-mcp

thingsboard/thingsboard-mcp

от thingsboard

MCP сервер для ThingsBoard: управляйте IoT-устройствами, телеметрией и тревогами через естественный язык. 120+ инструментов для автоматизации операций с сущностями и OTA-пакетами. Идеален для DevOp...

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

ThingsBoard MCP Server

Connect AI agents to your ThingsBoard IoT platform via Model Context Protocol (MCP). Query devices, manage entities, analyze telemetry, and automate operations — all through natural language.

Works with Claude Desktop, Cursor, VS Code Copilot, Claude Code, and any MCP-compatible client.

Quick Start

You need a ThingsBoard instance (Cloud, EU Cloud, self-hosted CE/PE, or Edge) and an API key (ThingsBoard 4.3+) or username/password.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "thingsboard": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "THINGSBOARD_URL", "-e", "THINGSBOARD_API_KEY", "thingsboard/mcp"],
      "env": {
        "THINGSBOARD_URL": "https://thingsboard.cloud",
        "THINGSBOARD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить thingsboard/thingsboard-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "thingsboard-thingsboard-mcp-5dzrqp8jev": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "THINGSBOARD_URL",
        "-e",
        "THINGSBOARD_API_KEY",
        "thingsboard/mcp"
      ],
      "env": {
        "THINGSBOARD_URL": "https://thingsboard.cloud",
        "THINGSBOARD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "thingsboard-thingsboard-mcp-5dzrqp8jev": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "THINGSBOARD_URL",
        "-e",
        "THINGSBOARD_API_KEY",
        "thingsboard/mcp"
      ],
      "env": {
        "THINGSBOARD_URL": "https://thingsboard.cloud",
        "THINGSBOARD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "thingsboard-thingsboard-mcp-5dzrqp8jev": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "THINGSBOARD_URL",
        "-e",
        "THINGSBOARD_API_KEY",
        "thingsboard/mcp"
      ],
      "env": {
        "THINGSBOARD_URL": "https://thingsboard.cloud",
        "THINGSBOARD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"thingsboard-thingsboard-mcp-5dzrqp8jev\",\"type\":\"stdio\",\"command\":\"docker\",\"args\":[\"run\",\"-i\",\"--rm\",\"-e\",\"THINGSBOARD_URL\",\"-e\",\"THINGSBOARD_API_KEY\",\"thingsboard/mcp\"],\"env\":{\"THINGSBOARD_URL\":\"https://thingsboard.cloud\",\"THINGSBOARD_API_KEY\":\"YOUR_API_KEY\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "thingsboard-thingsboard-mcp-5dzrqp8jev": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "THINGSBOARD_URL",
        "-e",
        "THINGSBOARD_API_KEY",
        "thingsboard/mcp"
      ],
      "env": {
        "THINGSBOARD_URL": "https://thingsboard.cloud",
        "THINGSBOARD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add thingsboard-thingsboard-mcp-5dzrqp8jev --env THINGSBOARD_URL=https://thingsboard.cloud --env THINGSBOARD_API_KEY=YOUR_API_KEY -- docker run -i --rm -e THINGSBOARD_URL -e THINGSBOARD_API_KEY thingsboard/mcp

Либо через JSON-конфиг:

claude mcp add-json thingsboard-thingsboard-mcp-5dzrqp8jev "{\"command\":\"docker\",\"args\":[\"run\",\"-i\",\"--rm\",\"-e\",\"THINGSBOARD_URL\",\"-e\",\"THINGSBOARD_API_KEY\",\"thingsboard/mcp\"],\"env\":{\"THINGSBOARD_URL\":\"https://thingsboard.cloud\",\"THINGSBOARD_API_KEY\":\"YOUR_API_KEY\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add thingsboard-thingsboard-mcp-5dzrqp8jev --env THINGSBOARD_URL=https://thingsboard.cloud --env THINGSBOARD_API_KEY=YOUR_API_KEY -- docker run -i --rm -e THINGSBOARD_URL -e THINGSBOARD_API_KEY thingsboard/mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.thingsboard-thingsboard-mcp-5dzrqp8jev]
command = "docker"
args = ["run", "-i", "--rm", "-e", "THINGSBOARD_URL", "-e", "THINGSBOARD_API_KEY", "thingsboard/mcp"]

[mcp_servers.thingsboard-thingsboard-mcp-5dzrqp8jev.env]
THINGSBOARD_URL = "https://thingsboard.cloud"
THINGSBOARD_API_KEY = "YOUR_API_KEY"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите thingsboard/thingsboard-mcp, а в поле команды запуска — строку ниже:

docker run -i --rm -e THINGSBOARD_URL -e THINGSBOARD_API_KEY thingsboard/mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "thingsboard-thingsboard-mcp-5dzrqp8jev": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "THINGSBOARD_URL",
        "-e",
        "THINGSBOARD_API_KEY",
        "thingsboard/mcp"
      ],
      "env": {
        "THINGSBOARD_URL": "https://thingsboard.cloud",
        "THINGSBOARD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "thingsboard-thingsboard-mcp-5dzrqp8jev": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "THINGSBOARD_URL",
        "-e",
        "THINGSBOARD_API_KEY",
        "thingsboard/mcp"
      ],
      "env": {
        "THINGSBOARD_URL": "https://thingsboard.cloud",
        "THINGSBOARD_API_KEY": "YOUR_API_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например thingsboard-thingsboard-mcp-5dzrqp8jev.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: thingsboard-thingsboard-mcp-5dzrqp8jev
    command: docker
    args:
      - "run"
      - "-i"
      - "--rm"
      - "-e"
      - "THINGSBOARD_URL"
      - "-e"
      - "THINGSBOARD_API_KEY"
      - "thingsboard/mcp"
    env:
      THINGSBOARD_URL: https://thingsboard.cloud
      THINGSBOARD_API_KEY: YOUR_API_KEY

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "thingsboard-thingsboard-mcp-5dzrqp8jev": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "THINGSBOARD_URL",
        "-e",
        "THINGSBOARD_API_KEY",
        "thingsboard/mcp"
      ],
      "env": {
        "THINGSBOARD_URL": "https://thingsboard.cloud",
        "THINGSBOARD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "THINGSBOARD_URL",
    "-e",
    "THINGSBOARD_API_KEY",
    "thingsboard/mcp"
  ],
  "env": {
    "THINGSBOARD_URL": "https://thingsboard.cloud",
    "THINGSBOARD_API_KEY": "YOUR_API_KEY"
  }
}