From 4f79d8fb182189fcc8469178126e78555d343a30 Mon Sep 17 00:00:00 2001 From: Gilad Resisi Date: Fri, 13 Nov 2026 18:04:33 +0700 Subject: [PATCH] docs(self-host): MCP_URL also turns on OAuth issuer identification MCP_URL is now read by the backend too: when set to a valid URL it turns on RFC 9207 issuer identification for the MCP OAuth server, which Codex CLI needs when the frontend and backend differ in domain or port. The row explains what value to use, that a second hostname proxying to the same backend breaks issuer validation, that an invalid value is ignored and reported at startup, and that leaving it unset keeps it off. Co-Authored-By: Claude Opus 5.5 --- self-host/configuration/reference.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/self-host/configuration/reference.mdx b/self-host/configuration/reference.mdx index f721c237..054b339d 100644 --- a/self-host/configuration/reference.mdx +++ b/self-host/configuration/reference.mdx @@ -206,7 +206,7 @@ ships with one). See the [Temporal migration guide](/self-host/installation/migr | Variable | Purpose | |---|---| -| `MCP_URL` | URL the frontend uses to advertise the MCP endpoint to clients. | +| `MCP_URL` | Public URL your MCP server is reached at, including `https://`. The frontend shows it as the MCP endpoint. Set on the backend too, it turns on OAuth issuer identification (RFC 9207), which Codex CLI needs to sign in to the MCP server when `FRONTEND_URL` and `NEXT_PUBLIC_BACKEND_URL` differ in domain or port. In a standard install use your backend URL; do not set it to a different hostname that proxies to the same backend, or MCP clients that validate the issuer will reject the sign-in. An invalid value is ignored and reported at startup. Leave it unset to keep issuer identification off. | | `AGENT_API_KEY` | Shared secret used by the agent runtime to call privileged endpoints. | | `AGENT_MEDIA_SSO_KEY` | Signing key for short-lived agent-media SSO tokens. | | `BACKEND_URL` | Legacy alias for `NEXT_PUBLIC_BACKEND_URL` in a few server contexts. |