| 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) |
