From 5e303ad1e5f9500c0b5a5504f869885aa55fd6cd Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 23 May 2026 03:36:39 +0000 Subject: [PATCH] fix(connect): remove references to non-existent `super-agent` CLI MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The /connect page (and two of its quick-start prompts) advertised `npx -y super-agent connect`, `super-agent login`, `super-agent status`, `super-agent mcp`, etc. The `super-agent` npm package is unpublished — users running these commands got 404s and dead-ended. Replaces the CLI section and the two affected prompts with the two auth paths that actually work today: - OAuth via the client's built-in MCP OAuth flow (Claude Desktop, Cursor, Codex, VS Code) pointed at the Streamable HTTP endpoint. - Personal access token from /account/tokens for any client with a static Authorization header (Hermes, OpenClaw, n8n, curl, CI). The 'super-agent-skill' identifier (the MCP server name used in client configs) is preserved — only the phantom CLI name is removed. https://claude.ai/code/session_019gMoupKKTVydpNwiiACQRd --- src/routes/connect.tsx | 69 +++++++++++++----------------------------- 1 file changed, 21 insertions(+), 48 deletions(-) diff --git a/src/routes/connect.tsx b/src/routes/connect.tsx index 72a25391..3bf58720 100644 --- a/src/routes/connect.tsx +++ b/src/routes/connect.tsx @@ -280,25 +280,33 @@ const QUICK_PROMPTS: Prompt[] = [ title: "One prompt → fully connected (recommended)", code: `Connect me to the "Super Agent Skill" MCP server with full access (read + write tools). -Run this in my shell and follow the browser login it opens: +Use the Streamable HTTP endpoint ${ENDPOINT}. - npx -y super-agent connect --client claude-code +1. Add it to my MCP client (Claude Code / Claude Desktop / Cursor / Codex / VS Code / Windsurf). + - Claude Code: claude mcp add --transport http super-agent-skill ${ENDPOINT} + - Claude Desktop / Cursor / VS Code: write the JSON config for my OS (preserve existing servers). +2. For write tools (upload_packages, request_primitive, report_execution): the client opens OAuth in my browser on first call. If my client doesn't auto-OAuth, mint a token at https://superagentskill.com/account/tokens and add Authorization: Bearer to the MCP config. +3. Restart the client, call the MCP tool "overview", and show me the intent→tool map. -Notes: -- It does OAuth (loopback PKCE), stores the token in ~/.superagentskill, and writes my client's MCP config automatically. -- Swap --client for: claude | cursor | codex | vscode | windsurf. -- After it finishes, restart the client, then call the MCP tool "overview" and show me the intent→tool map. -If anything fails, paste the exact command output and the config file it wrote.`, +If anything fails, paste the exact error and the config file you wrote.`, }, { - title: "Enable write tools (OAuth)", + title: "Enable write tools (OAuth or PAT)", code: `I want to use the auth-gated write tools (upload_packages, request_primitive, report_execution) of the Super Agent Skill MCP. -1. Run: npx -y super-agent login (complete the browser OAuth login) -2. Run: npx -y super-agent status (confirm the token is valid) -3. If my client supports header auth, ensure the MCP config sends Authorization: Bearer . - Otherwise wire it through the local bridge: command "npx", args ["-y","super-agent","mcp"]. -4. Restart the MCP connection and call "overview" to verify write tools are listed.`, +Pick whichever auth my client supports best: + +A. OAuth (recommended — Claude Desktop, Cursor, Codex, VS Code with MCP OAuth support): + 1. Add the server with URL ${ENDPOINT}. + 2. On first write-tool call, the client opens a browser tab to https://superagentskill.com/oauth/authorize — approve. + 3. Token is stored by the client and refreshed automatically. + +B. Personal access token (any client with header auth — Hermes, OpenClaw, n8n, curl, CI): + 1. Mint a token at https://superagentskill.com/account/tokens (shown once; store it). + 2. Add Authorization: Bearer to the MCP config or HTTP request. + 3. Verify with: curl -i -X POST https://superagentskill.com/api/packages/upload -H "Authorization: Bearer $SAS_TOKEN" -H "Content-Type: application/json" -d '{"files":[{"name":"x.md","content":"# test"}]}' + +After auth is wired, restart the MCP connection and call "overview" to confirm write tools are listed.`, }, { title: "Codex CLI / OpenCode", @@ -573,41 +581,6 @@ function ConnectPage() {

- {/* ============ ONE-COMMAND (CLI) PATH ============ */} -
-
- -

- Plug and play · one command -

-
-

- OAuth login + client auto-config, no JSON editing -

-

- The CLI runs the full OAuth flow in your browser (loopback PKCE), - stores the token locally, and writes the MCP config for your client - — including the auth-gated write tools. It also ships a local stdio - bridge that injects and refreshes the token automatically. -

-
- -
-

- Stdio-only client? Point it at{" "} - npx -y super-agent mcp — the - bridge handles auth for you. -

-
- {/* ============ JUMP NAV ============ */}