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.

Authorization; X-Events-API-Key for Analytics Events tools.

Multi-controller HTTP

MCP_TRANSPORT=streamable-http, APPD_AUTH_MODE=request_bearer (default), APPD_MULTI_CONTROLLER_ENABLED=true; leave APPD_ENVIRONMENT, APPD_ANALYTICS_EVENTS_URL and APPD_ANALYTICS_EVENTS_GLOBAL_ACCOUNT_NAME unset.

Authorization, X-AppD-Controller-Host; for live Events also X-AppD-Analytics-Events-URL, X-Events-API-AccountName, X-Events-API-Key for Analytics Events tools.

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.
These environment settings apply to fixed HTTP and stdio. Multi-controller HTTP supplies Events targets through request headers.

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.

SSL_CERT_FILE selects a CA bundle instead of the default CA file; include required roots. SSL_CERT_DIR requires an OpenSSL-hashed directory.

APPD_TIMEOUT_READ 30 Controller response-body read timeout in seconds.
APPD_TOOL_WALLCLOCK_S 90

Total per-tool deadline. 0 turns off the cap; this value is not recommended for shared deployments.

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
Call overrides can only lower ceilings; dashboard-export and active-run limits are operator-only. Visible dashboard count drives APM CAT budget needs.