| MCP_ALLOW_INSECURE_FILE_URL | No | Set to "true" to allow plain http:// fileUrl downloads in evidence_create (default https-only). Private/internal addresses are rejected regardless (resolution-time check; see the documented DNS TOCTOU limitation in the hosted-deployment runbook). |
| MCP_ALLOW_UNVERIFIED_BEARER | No | Escape hatch for MCP_HTTP_PUBLIC=true WITHOUT inbound-token introspection: set to "true" ONLY when an upstream gateway already verifies Bearer tokens. The server logs a prominent warning and forwards tokens upstream unverified. |
| MCP_ALLOWED_HOSTS | No | Comma-separated allowed Host headers. Empty = Host validation disabled (default). When set, requests with a Host outside the list are rejected. |
| MCP_ALLOWED_ORIGINS | No | Comma-separated allowed browser Origins (DNS-rebinding defense). Empty = reject any request carrying an Origin header; non-browser clients (CLI/SDK) send no Origin and are always allowed. Use '*' to allow all. |
| MCP_API_BASE_URL | No | Gateway ROOT URL (e.g. https://api.int.gcloudfactory.com) — each manager's path prefix is appended automatically; do NOT include a manager path here |
| MCP_API_BASE_URL_CHAT | No | Full base URL override for the chat manager, used as-is (default: https://api.gcloudfactory.com/chat-bot-manager) |
| MCP_API_BASE_URL_EVIDENCE | No | Full base URL override for the evidence manager, used as-is (default: https://api.gcloudfactory.com/digital-trust) |
| MCP_API_BASE_URL_NOTIFICATION | No | Full base URL override for the notification manager, used as-is (default: https://api.gcloudfactory.com/notifications) |
| MCP_API_BASE_URL_SIGNATURE | No | Full base URL override for the signature manager, used as-is (default: https://api.gcloudfactory.com/signature-manager) |
| MCP_HTTP_HOST | No | Interface the HTTP transport binds to. Default 127.0.0.1 (localhost only). Set 0.0.0.0 to expose on all interfaces (containers do this automatically). |
| MCP_HTTP_MAX_BODY_BYTES | No | Maximum accepted POST /mcp request-body size in bytes (default 16777216 = 16 MiB — sized so base64 file uploads within the documented tool limits fit). Oversized requests get a 413 JSON-RPC error before/while reading — closes a memory-exhaustion DoS vector in public deployments. Note: base64 file sources are capped by this limit BEFORE MCP_FILE_MAX_BYTES applies. |
| MCP_HTTP_PUBLIC | No | Set to "true" for public/multi-tenant deployments. Activates Host validation and refuses to start unless (1) MCP_ALLOWED_ORIGINS or MCP_ALLOWED_HOSTS is set AND (2) inbound Bearer introspection is configured (MCP_SVC_INTROSPECT_URL + MCP_SVC_CLIENT_ID/SECRET) or MCP_ALLOW_UNVERIFIED_BEARER=true is set explicitly (fail-closed). |
| MCP_SVC_CLIENT_ID | Yes | OAuth2 client_credentials client ID. |
| MCP_SVC_CLIENT_SECRET | Yes | OAuth2 client_credentials client secret. (See https://digitaltrust.gcloudfactory.com for credential acquisition.) Secret. |
| MCP_SVC_INTROSPECT_URL | No | RFC 7662 token introspection URL for inbound Bearer verification in HTTP mode. Opt-in, and required when MCP_HTTP_PUBLIC=true. Leave empty for stdio (local) use. |
| MCP_SVC_SCOPE | No | Optional OAuth2 scope for the service-account token request. |
| MCP_SVC_TOKEN_URL | Yes | Token endpoint URL for the OAuth2 client_credentials flow. |
| PORT | No | HTTP port when running in hosted (HTTP) mode; ignored in stdio mode |