diff --git a/README.md b/README.md
index 1ef9574..f3e4a77 100644
--- a/README.md
+++ b/README.md
@@ -74,7 +74,11 @@ After the script runs:
    - `modular-sso`
    - `modular-scim`
    - `full-stack-auth`
-5. Try one of the sample prompts from the installed plugin README
+5. Run `codex mcp login scalekit` if the Scalekit MCP tools do not appear
+6. Restart Codex so the session reloads the authenticated MCP tool list
+7. Try one of the sample prompts from the installed plugin README
+
+If `/mcp` shows `Auth: Unsupported` but also lists Scalekit tools, the server is usable. If it shows `Tools: (none)`, authenticate with `codex mcp login scalekit` and restart Codex.
 
 ---
 
diff --git a/plugins/agent-auth/.mcp.json b/plugins/agent-auth/.mcp.json
index 36dbbf4..97dc405 100644
--- a/plugins/agent-auth/.mcp.json
+++ b/plugins/agent-auth/.mcp.json
@@ -1,8 +1,8 @@
 {
   "mcpServers": {
     "scalekit": {
-      "command": "npx",
-      "args": ["-y", "mcp-remote", "https://mcp.scalekit.com"]
+      "type": "http",
+      "url": "https://mcp.scalekit.com/"
     }
   }
 }
diff --git a/plugins/full-stack-auth/.mcp.json b/plugins/full-stack-auth/.mcp.json
index 36dbbf4..97dc405 100644
--- a/plugins/full-stack-auth/.mcp.json
+++ b/plugins/full-stack-auth/.mcp.json
@@ -1,8 +1,8 @@
 {
   "mcpServers": {
     "scalekit": {
-      "command": "npx",
-      "args": ["-y", "mcp-remote", "https://mcp.scalekit.com"]
+      "type": "http",
+      "url": "https://mcp.scalekit.com/"
     }
   }
 }
diff --git a/plugins/mcp-auth/.mcp.json b/plugins/mcp-auth/.mcp.json
index ffaff7a..97dc405 100644
--- a/plugins/mcp-auth/.mcp.json
+++ b/plugins/mcp-auth/.mcp.json
@@ -1,12 +1,8 @@
 {
   "mcpServers": {
     "scalekit": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "mcp-remote",
-        "https://mcp.scalekit.com"
-      ]
+      "type": "http",
+      "url": "https://mcp.scalekit.com/"
     }
   }
 }
diff --git a/plugins/mcp-auth/README.md b/plugins/mcp-auth/README.md
index 494fde3..92f8f77 100644
--- a/plugins/mcp-auth/README.md
+++ b/plugins/mcp-auth/README.md
@@ -44,5 +44,7 @@ The plugin also ships [`./.mcp.json`](/Users/saif/Projects/ai-first/codex-auth-s
 ## Troubleshooting
 
 - OAuth-capable MCP auth requires HTTP transport, not stdio transport.
+- For Codex, run `codex mcp login scalekit` after installing the plugin, then restart Codex so the current session reloads MCP tools.
+- Codex may display `Auth: Unsupported` for OAuth-backed HTTP MCP servers; treat `Tools: (none)` as the failure signal.
 - Missing or invalid bearer tokens should return `401` plus a `WWW-Authenticate` header that points hosts at your protected-resource metadata.
 - Keep dashboard resource settings and your metadata endpoint aligned before debugging token validation.
diff --git a/plugins/mcp-auth/references/scalekit-mcp-server.md b/plugins/mcp-auth/references/scalekit-mcp-server.md
index e950b57..05ab528 100644
--- a/plugins/mcp-auth/references/scalekit-mcp-server.md
+++ b/plugins/mcp-auth/references/scalekit-mcp-server.md
@@ -441,13 +441,15 @@ The Scalekit MCP server is already hosted and ready to use:
 {
   "mcpServers": {
     "scalekit": {
-      "command": "npx",
-      "args": ["-y", "mcp-remote", "https://mcp.scalekit.com/"]
+      "type": "http",
+      "url": "https://mcp.scalekit.com/"
     }
   }
 }
 ```
 
+For Codex, authenticate once with `codex mcp login scalekit` and restart Codex so the session reloads the authenticated tool catalog.
+
 ### Running Your Own Instance
 
 ```bash
diff --git a/plugins/modular-scim/.mcp.json b/plugins/modular-scim/.mcp.json
index 36dbbf4..97dc405 100644
--- a/plugins/modular-scim/.mcp.json
+++ b/plugins/modular-scim/.mcp.json
@@ -1,8 +1,8 @@
 {
   "mcpServers": {
     "scalekit": {
-      "command": "npx",
-      "args": ["-y", "mcp-remote", "https://mcp.scalekit.com"]
+      "type": "http",
+      "url": "https://mcp.scalekit.com/"
     }
   }
 }
diff --git a/plugins/modular-sso/.mcp.json b/plugins/modular-sso/.mcp.json
index 36dbbf4..97dc405 100644
--- a/plugins/modular-sso/.mcp.json
+++ b/plugins/modular-sso/.mcp.json
@@ -1,8 +1,8 @@
 {
   "mcpServers": {
     "scalekit": {
-      "command": "npx",
-      "args": ["-y", "mcp-remote", "https://mcp.scalekit.com"]
+      "type": "http",
+      "url": "https://mcp.scalekit.com/"
     }
   }
 }