Configuration
Transport modes
Section titled “Transport modes”| 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.
Environment variables reference
Section titled “Environment variables reference”| 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) |
Was this helpful?
Thank you for your feedback!