Configuration reference
Review the required and optional environment variables for each MCP server transport and authentication mode.
Required settings
| Mode | Required server settings | Controller credential |
|---|---|---|
| Fixed HTTP | MCP_TRANSPORT=streamable-http, APPD_AUTH_MODE=request_bearer (default), APPD_MULTI_CONTROLLER_ENABLED=false (default), APPD_ENVIRONMENT; optional APPD_ANALYTICS_EVENTS_URL and APPD_ANALYTICS_EVENTS_GLOBAL_ACCOUNT_NAME. |
|
| Multi-controller HTTP |
|
|
| Stdio bearer | MCP_TRANSPORT=stdio, APPD_AUTH_MODE=env_bearer, APPD_MULTI_CONTROLLER_ENABLED=false, APPD_ENVIRONMENT, APPD_API_TOKEN. |
Launches the process and supplies these settings through its child environment; no HTTP headers. |
Stdio Oauth |
MCP_TRANSPORT=stdio, APPD_AUTH_MODE=oauth, APPD_MULTI_CONTROLLER_ENABLED=false, APPD_ENVIRONMENT, APPD_CLIENT_ID, APPD_CLIENT_SECRET, APPD_CUSTOMER. |
Launches the process with these settings; the server obtains/renews the Controller token. No HTTP headers. |
For HTTP, APPD_AUTH_MODE defaults to request_bearer, which requires the MCP client to send the token. For stdio, use env_bearer or oauth.
To enable Analytics Events tools for stdio mode, add the Events URL/account and EVENTS_API_KEY to the same child environment. Clients supply process values through environment variables. For more information, see Overview.
For multi-controller upgrades, move Events URL/GAN from server settings into each client's headers; leaving server targets configured now rejects startup. Fixed HTTP rejects target-selection headers.
Optional Analytics Events settings
| Setting | Purpose |
|---|---|
APPD_ANALYTICS_EVENTS_URL |
Events Service base origin. Required by live Events tools. Do not append /events or /events/query. |
APPD_ANALYTICS_EVENTS_GLOBAL_ACCOUNT_NAME |
Controller Global account name |
X-Events-API-Key |
HTTP request header containing the caller's Events API key.(Http mode) |
EVENTS_API_KEY |
Stdio process variable containing the Events key. Ignored in HTTP mode. |
Missing Analytics configuration does not prevent startup. The local get_analytics_event_type_catalog remains available; live field discovery and query tools return a typed configuration error.
Optional server and operational settings
| Setting | Default | Notes |
|---|---|---|
MCP_HOST |
127.0.0.1 |
Direct/source/wheel HTTP(S) bind address. Set an IP or host name for remote listening; the container image uses0.0.0.0. |
APPD_LOG_MAX_BYTES,APPD_LOG_BACKUP_COUNT |
10485760(10 MiB),5 |
Positive integers that control rotating file size and history when file logging is enabled. |
MCP_SSL_CERTFILE/MCP_SSL_KEYFILE |
unset | Configure both to enable in-process HTTPS; configuring only one rejects HTTP/HTTPS startup. |
MCP_PORT |
6350 |
HTTP/HTTPS listener port. |
SSL_CERT_FILE / SSL_CERT_DIR |
platform defaults |
Optional CA bundle/directory overrides; paths must exist inside the runtime.
|
APPD_TIMEOUT_READ |
30 |
Controller response-body read timeout in seconds. |
APPD_TOOL_WALLCLOCK_S |
90 |
Total per-tool deadline. This setting applies to ordinary tools. |
APPD_CONTROLLER_MAX_RESPONSE_BYTES |
4194304 (4 MiB) |
Positive ceiling for each Controller response; metric discovery inherits it. |
APPD_LOGFILE |
unset | When unset, logs go to stdout for HTTP and stderr for stdio. |
APPD_LOGLEVEL |
INFO |
Application log level. |
APPD_HTTPX_LOGLEVEL |
INFO |
Set WARNING in production to reduce outbound request logging. |
APPD_UVICORN_LOGLEVEL |
INFO |
Uvicorn and access-log level. |
MCP_AUDIT_LOGLEVEL |
INFO |
One-line-per-tool-call audit logger. |
Optional CAT settings
| Setting | Default |
|---|---|
APPD_CAT_ENABLED |
false |
APPD_CAT_CONCURRENCY |
2 parallel reads |
APPD_CAT_MAX_ELAPSED_SECONDS |
300 seconds/run |
APPD_CAT_REQUEST_TIMEOUT_SECONDS |
30 seconds/request |
APPD_CAT_MAX_RESPONSE_BYTES |
2097152 bytes/response |
APPD_CAT_MAX_API_REQUESTS |
2000 requests/run |
APPD_CAT_MAX_DASHBOARD_EXPORTS |
1000 exports/run |
APPD_CAT_MAX_OUTPUT_BYTES |
1048576 bytes/run |
APPD_CAT_MAX_CONCURRENT_RUNS |
1 active assessment/process |