Admin includes an optional MCP (Model Context Protocol) server for coding agent integration (Cursor, Claude Code). This feature is disabled by default and requires installing additional dependencies and enabling via environment variable.
For setup instructions, see MCP README.
Below are the environment variables specific to the Admin Application. Other required variables can be found in the common README file.
| Variable | Required | Description | Available Values | Default values |
|---|---|---|---|---|
| OIDC_AUTH_ENABLED | No | If this setting is enabled, all admin endpoints require OIDC authentication. Otherwise, all endpoints can be called without any authentication, which can be useful for local development. MUST BE ENABLED IN PRODUCTION ENVIRONMENTS! | true, false |
true |
| OIDC_CONFIGURATION_ENDPOINT | Yes, if $OIDC_AUTH_ENABLED |
OIDC Configuration Endpoint | ||
| OIDC_CLIENT_ID | Yes, if $OIDC_AUTH_ENABLED |
OIDC Client ID | ||
| OIDC_ISSUER | Yes, if $OIDC_AUTH_ENABLED |
OIDC Issuer | ||
| OIDC_USERNAME_CLAIM | Yes, if $OIDC_AUTH_ENABLED |
OIDC Username Claim | ||
| OIDC_AUDIT_USER_ID_CLAIM | No | JWT claim(s) used to populate audit log performed_by (single value, comma-separated string, or JSON array) |
oid,sub |
|
| OIDC_AUDIT_PERFORMED_BY_NAME_CLAIM | No | JWT claim(s) used to populate audit log performed_by_name (single value, comma-separated string, or JSON array) |
unique_name,email |
|
| ADMIN_ROLES_CLAIM | Yes, if $OIDC_AUTH_ENABLED |
OIDC Admin Roles Claim | ||
| ADMIN_ROLES_VALUES | Yes, if $OIDC_AUTH_ENABLED |
OIDC Admin Roles Values | ||
| ADMIN_SCOPE_CLAIM_VALIDATION_ENABLED | No | If specified, the admin portal will check for scopes in the OIDC token, otherwise this check will be skipped. | true, false |
true |
| ADMIN_SCOPE_CLAIM | Yes, if $OIDC_AUTH_ENABLED and ADMIN_SCOPE_CLAIM_VALIDATION_ENABLED |
The name of the custom access token field that contains scope information. | ||
| ADMIN_SCOPE_VALUE | Yes, if $OIDC_AUTH_ENABLED and ADMIN_SCOPE_CLAIM_VALIDATION_ENABLED |
Required scope claim value to get access to admin portal if scope claim validation is enabled. | ||
| BACKGROUND_TASKS_MAX_CONCURRENT | No | Maximum number of background tasks that can be run concurrently | 5 |
|
| BACKGROUND_TASKS_TASK_TIMEOUT | No | Timeout in seconds for a single background task. Set to empty to disable. | 1800 (30 minutes) |
|
| EXIM_VECTOR_STORE_CONCURRENCY_LIMIT | No | Maximum number of concurrent export operations related to vector store | 10 |
|
| EXIM_ELASTIC_CONCURRENCY_LIMIT | No | Maximum number of concurrent export operations related to elasticsearch | 10 |
|
| OTEL_APP_SERVICE_NAME | No | OpenTelemetry service name for the admin application | statgpt-admin-backend |
|
| BETA_MCP_ENABLED | No | Enables MCP support for StatGPT(dataset config generation/test creation). Requires mcp dependencies to be installed. |
true, false |
false |