From 2fc2ebab46bd4c4413bcb3da7a048bad60a8331a Mon Sep 17 00:00:00 2001 From: Saif Shines Date: Thu, 30 Apr 2026 10:14:53 +0530 Subject: [PATCH 1/2] chore: use native Cursor MCP config instead of mcp-remote --- plugins/agent-auth/.mcp.json | 3 +-- plugins/full-stack-auth/.mcp.json | 3 +-- plugins/mcp-auth/.mcp.json | 3 +-- plugins/modular-scim/.mcp.json | 3 +-- plugins/modular-sso/.mcp.json | 3 +-- 5 files changed, 5 insertions(+), 10 deletions(-) diff --git a/plugins/agent-auth/.mcp.json b/plugins/agent-auth/.mcp.json index 36dbbf4..baa0002 100644 --- a/plugins/agent-auth/.mcp.json +++ b/plugins/agent-auth/.mcp.json @@ -1,8 +1,7 @@ { "mcpServers": { "scalekit": { - "command": "npx", - "args": ["-y", "mcp-remote", "https://mcp.scalekit.com"] + "url": "https://mcp.scalekit.com" } } } diff --git a/plugins/full-stack-auth/.mcp.json b/plugins/full-stack-auth/.mcp.json index 36dbbf4..baa0002 100644 --- a/plugins/full-stack-auth/.mcp.json +++ b/plugins/full-stack-auth/.mcp.json @@ -1,8 +1,7 @@ { "mcpServers": { "scalekit": { - "command": "npx", - "args": ["-y", "mcp-remote", "https://mcp.scalekit.com"] + "url": "https://mcp.scalekit.com" } } } diff --git a/plugins/mcp-auth/.mcp.json b/plugins/mcp-auth/.mcp.json index 36dbbf4..baa0002 100644 --- a/plugins/mcp-auth/.mcp.json +++ b/plugins/mcp-auth/.mcp.json @@ -1,8 +1,7 @@ { "mcpServers": { "scalekit": { - "command": "npx", - "args": ["-y", "mcp-remote", "https://mcp.scalekit.com"] + "url": "https://mcp.scalekit.com" } } } diff --git a/plugins/modular-scim/.mcp.json b/plugins/modular-scim/.mcp.json index 36dbbf4..baa0002 100644 --- a/plugins/modular-scim/.mcp.json +++ b/plugins/modular-scim/.mcp.json @@ -1,8 +1,7 @@ { "mcpServers": { "scalekit": { - "command": "npx", - "args": ["-y", "mcp-remote", "https://mcp.scalekit.com"] + "url": "https://mcp.scalekit.com" } } } diff --git a/plugins/modular-sso/.mcp.json b/plugins/modular-sso/.mcp.json index 36dbbf4..baa0002 100644 --- a/plugins/modular-sso/.mcp.json +++ b/plugins/modular-sso/.mcp.json @@ -1,8 +1,7 @@ { "mcpServers": { "scalekit": { - "command": "npx", - "args": ["-y", "mcp-remote", "https://mcp.scalekit.com"] + "url": "https://mcp.scalekit.com" } } } From 9e6753cebc6053080a918ee4d46a00ba0c84ae63 Mon Sep 17 00:00:00 2001 From: Saif Shines Date: Thu, 30 Apr 2026 12:11:13 +0530 Subject: [PATCH 2/2] docs: align Cursor MCP guidance with native URL config --- README.md | 1 + plugins/mcp-auth/agents/mcp-auth-troubleshooter.md | 2 +- plugins/mcp-auth/agents/scalekit-mcp-auth-troubleshooter.md | 2 +- plugins/mcp-auth/agents/scalekit-setup.md | 5 ++--- plugins/mcp-auth/references/scalekit-mcp-server.md | 3 +-- 5 files changed, 6 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 9381c9b..a69421e 100644 --- a/README.md +++ b/README.md @@ -47,6 +47,7 @@ The installer: - downloads the latest `cursor-authstack` repository - installs each plugin into `~/.cursor/plugins/local/` - verifies each installed plugin root contains `.cursor-plugin/plugin.json` +- lets Cursor load each plugin's `.mcp.json` through the plugin manifest, including the hosted Scalekit MCP server URL - prints the next steps to reload Cursor and confirm the plugins loaded After it finishes: diff --git a/plugins/mcp-auth/agents/mcp-auth-troubleshooter.md b/plugins/mcp-auth/agents/mcp-auth-troubleshooter.md index 759b2d9..04d900d 100644 --- a/plugins/mcp-auth/agents/mcp-auth-troubleshooter.md +++ b/plugins/mcp-auth/agents/mcp-auth-troubleshooter.md @@ -66,7 +66,7 @@ Common failures: ### redirect_uri mismatch Cause: MCP client cached an old domain and is sending auth requests to a stale URL. Fix by client: -- MCP-Remote: delete `~/.mcp-auth/mcp-remote-` then reconnect. +- Cursor: open Cursor Settings → MCP, remove the affected MCP server entry, then reconnect. - VS Code: open Command Palette → "Authentication: Remove Dynamic Authentication Provider" → reconnect. - Claude Desktop: clearing cached auth is NOT currently supported. Workaround: use a different domain/subdomain. diff --git a/plugins/mcp-auth/agents/scalekit-mcp-auth-troubleshooter.md b/plugins/mcp-auth/agents/scalekit-mcp-auth-troubleshooter.md index f7777e4..47f585c 100644 --- a/plugins/mcp-auth/agents/scalekit-mcp-auth-troubleshooter.md +++ b/plugins/mcp-auth/agents/scalekit-mcp-auth-troubleshooter.md @@ -45,7 +45,7 @@ If the 401/header/metadata checks fail, classify as “metadata/handshake miscon If the handshake looks correct but the client still fails, suspect the client cached an old domain/metadata after a domain change. Clear cached auth (by client): -- MCP-Remote: delete `~/.mcp-auth/mcp-remote-` and reconnect. +- Cursor: open Cursor Settings → MCP, remove the Scalekit MCP server entry, then reconnect. - VS Code: run “Authentication: Remove Dynamic Authentication Provider”, remove the cached entry, and reconnect. If the failing client is Claude Desktop, note that client behavior can differ and some issues are client-specific (see sections below). diff --git a/plugins/mcp-auth/agents/scalekit-setup.md b/plugins/mcp-auth/agents/scalekit-setup.md index e5fcfe8..fe83f6a 100644 --- a/plugins/mcp-auth/agents/scalekit-setup.md +++ b/plugins/mcp-auth/agents/scalekit-setup.md @@ -188,14 +188,13 @@ If yes, open or create `.cursor/mcp.json` and merge: { "mcpServers": { "scalekit": { - "command": "npx", - "args": ["-y", "mcp-remote", "https://mcp.scalekit.com/"] + "url": "https://mcp.scalekit.com" } } } ``` -Instruct the user to restart Cursor. After restart, an OAuth workflow will launch to authorize the connection. +Instruct the user to restart Cursor. After restart, Cursor will connect to the hosted Scalekit MCP server and launch an OAuth workflow to authorize the connection. ## Step 7: Index Scalekit Docs in Cursor (Recommended) diff --git a/plugins/mcp-auth/references/scalekit-mcp-server.md b/plugins/mcp-auth/references/scalekit-mcp-server.md index e950b57..9c7cf99 100644 --- a/plugins/mcp-auth/references/scalekit-mcp-server.md +++ b/plugins/mcp-auth/references/scalekit-mcp-server.md @@ -441,8 +441,7 @@ The Scalekit MCP server is already hosted and ready to use: { "mcpServers": { "scalekit": { - "command": "npx", - "args": ["-y", "mcp-remote", "https://mcp.scalekit.com/"] + "url": "https://mcp.scalekit.com" } } }