Skip to content
© 2026 The ThingsBoard Authors
Try for free

ThingsBoard Cloud

Choose your data region

Your data stays in the region you choose, for residency and compliance. No credit card required.

Rather run it yourself? Install on your own servers

Configuration

Mode When to use Key environment variables
STDIO (default) Clients that launch the server as a subprocess (Claude Desktop, Cursor, Claude Code) SPRING_AI_MCP_SERVER_STDIO=true (default)
SSE HTTP-based clients or running the server as a standalone service SPRING_AI_MCP_SERVER_STDIO=false, SPRING_WEB_APPLICATION_TYPE=servlet

In SSE mode, the server listens on http://<HTTP_BIND_ADDRESS>:<HTTP_BIND_PORT>/sse — default: http://127.0.0.1:8000/sse.

Variable Description Default
THINGSBOARD_URL Edge node base URL —
THINGSBOARD_USERNAME Username for authentication —
THINGSBOARD_PASSWORD Password for authentication —
THINGSBOARD_LOGIN_INTERVAL_SECONDS Session refresh interval (username/password mode) 1800
SPRING_AI_MCP_SERVER_STDIO Enable STDIO transport true
SPRING_WEB_APPLICATION_TYPE none for STDIO, servlet for SSE none
SPRING_AI_MCP_SERVER_SSE_ENDPOINT SSE endpoint path /sse
SPRING_AI_MCP_SERVER_SSE_MESSAGE_ENDPOINT SSE message endpoint path /mcp/message
SERVER_PORT HTTP server port (SSE mode) 8080
LOGGING_PATTERN_CONSOLE Console log pattern — set to empty string to suppress logs in STDIO mode (empty)