Skip to content

Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure

TypeScript

docs(oauth): describe the per-server remote callback in CRD and minikube comments

Diego Zacarias5c8453613b70
diff --git a/charts/clerum-crds/crds/mcpserver.yaml b/charts/clerum-crds/crds/mcpserver.yaml
index ad11483a0..d0e952f40 100644
--- a/charts/clerum-crds/crds/mcpserver.yaml
+++ b/charts/clerum-crds/crds/mcpserver.yaml
@@ -667,8 +667,9 @@ spec:
# baked (source absent) AND generic get the slug narrow, since a
# generic client_id IS spec.oauth.id and must be a callback-path-safe slug.
# 'remote' is reserved: baked/generic callbacks route by /oauth-callback/<id>,
- # and /oauth-callback/remote is the single stable redirect every remote
- # client registers, so a baked/generic server with that id would share it.
+ # and /oauth-callback/remote is the shared redirect of remote clients whose
+ # AS advertises RFC 9207 (the others register /oauth-callback/remote/<name>[/<installId>]),
+ # so a baked/generic server with that id would share it.
- rule: "!has(self.oauth) || (has(self.oauth.source) && self.oauth.source == 'remote') || !has(self.oauth.id) || (self.oauth.id.matches('^[a-z0-9-]{1,63}$') && self.oauth.id != 'remote')"
message: "baked/generic spec.oauth.id must match ^[a-z0-9-]{1,63}$ and must not be 'remote' (reserved for the remote OAuth callback)"
# BAKED-REQ: baked (no source) requires the classic adapter quartet.
diff --git a/deploy/overlays/minikube/configmaps/control-api-config.yaml b/deploy/overlays/minikube/configmaps/control-api-config.yaml
index 91c9fa842..3bf2fdead 100644
--- a/deploy/overlays/minikube/configmaps/control-api-config.yaml
+++ b/deploy/overlays/minikube/configmaps/control-api-config.yaml
@@ -41,7 +41,10 @@ data:
# Locally the user consents in their own browser, so the callback must land on
# the port-forwarded loopback. Register this EXACT literal as the redirect URI
# in each provider's OAuth app: the CONTROL_API_OAUTH_CALLBACK_BASE_URL value
- # below, suffixed with /api/v1/oauth-callback/<oauth.id>.
+ # below, suffixed with /api/v1/oauth-callback/<oauth.id> (baked/generic). Remote
+ # servers use /api/v1/oauth-callback/remote when their AS advertises RFC 9207,
+ # otherwise /api/v1/oauth-callback/remote/<serverName> (pre-registered; DCR adds
+ # /<installId> and registers it automatically). The wizard shows the exact URI.
# (Distinct from RPC_PROXY_OAUTH_CALLBACK_BASE_URL, which is the legacy
# recipe/embed flow and uses `localhost` — do not conflate them.)
CONTROL_API_OAUTH_CALLBACK_BASE_URL: 'http://127.0.0.1:8090'