Environment variables
Environment variable reference for the Dataedo MCP server. For setup instructions, see Set up MCP.
Environment variable reference
Common (both modes)
| Variable | Required | Default | Description |
|---|---|---|---|
BACKEND_API_URL | Yes | None | Root URL of your Dataedo instance. Must not include /api or a trailing slash; the server appends API paths itself |
MCP_MODE | No | (auto-detected) | Set to stdio to force Local Mode. Leave unset in hosted deployments |
Local Mode (stdio)
| Variable | Required | Example | Description |
|---|---|---|---|
DATAEDO_PAT | Yes | dataedo_pat_abc123... | Personal Access Token for all backend API calls |
Hosted Mode (HTTP)
| Variable | Required | Default | Description |
|---|---|---|---|
PUBLIC_URL | Yes | None | Publicly accessible base URL of this server. Used to construct the /mcp endpoint and the OAuth protected resource metadata advertised to AI clients |
AUTH_SERVER_URL | No | BACKEND_API_URL | Browser-facing HTTPS origin of your Dataedo Portal, which acts as the OAuth authorization server. Set it when BACKEND_API_URL points at an internal address: the OAuth metadata and signing keys must be served over HTTPS, so an internal plaintext URL makes OAuth sign-ins fail with 502 while Personal Access Tokens keep working |
OAUTH_METADATA_TTL_MS | No | 3600000 | How long the Portal's OAuth metadata (issuer, signing key location) is cached, in milliseconds |
PORT | No | 3000 | Local port the server listens on |
TRUST_PROXY | No | (disabled) | Number of reverse proxies in front of this server. Required for correct per-IP rate limiting behind a load balancer |
