From a13a05d9b4837f045a46b3a6ad1ff5167569e159 Mon Sep 17 00:00:00 2001 From: olaservo Date: Wed, 10 Dec 2025 09:23:32 -0700 Subject: [PATCH] docs(spec): Add Connection Mode dropdown to ServerCard wireframes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Update UX spec to show inline Connection Mode dropdown on ServerCard for quick switching between Direct and Via Proxy modes. Based on Cliff's feedback about making connection type more accessible rather than buried in Settings modal. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- specification/v2_ux.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/specification/v2_ux.md b/specification/v2_ux.md index aeba441b..e0bc5adc 100644 --- a/specification/v2_ux.md +++ b/specification/v2_ux.md @@ -95,7 +95,7 @@ Each server in the list is displayed as a card with connection controls and stat ``` ┌─────────────────────────────────────────────────────────────────┐ │ [Icon] Server Name v1.0.0 │ -│ STDIO [●] Connected [Toggle]│ +│ STDIO [Via Proxy ▼] [●] Connected [Toggle]│ ├─────────────────────────────────────────────────────────────────┤ │ npx -y @modelcontextprotocol/server-everything [Copy]│ ├─────────────────────────────────────────────────────────────────┤ @@ -103,11 +103,17 @@ Each server in the list is displayed as a card with connection controls and stat └─────────────────────────────────────────────────────────────────┘ ``` +**Connection Mode Dropdown:** +- Quick access to switch between Direct and Via Proxy modes without opening Settings +- STDIO servers default to "Via Proxy" (required - cannot connect directly from browser) +- HTTP/SSE servers default to "Direct" (assumes CORS enabled) +- Shows warning text if STDIO + Direct selected: "(STDIO requires proxy)" + **With OAuth (shows OAuth Debug button):** ``` ┌─────────────────────────────────────────────────────────────────┐ │ [Icon] Server Name v1.0.0 │ -│ HTTP (OAuth) [●] Connected [Toggle]│ +│ HTTP [Direct ▼] [●] Connected [Toggle]│ ├─────────────────────────────────────────────────────────────────┤ │ https://api.example.com/mcp [Copy]│ ├─────────────────────────────────────────────────────────────────┤ @@ -119,7 +125,7 @@ Each server in the list is displayed as a card with connection controls and stat ``` ┌─────────────────────────────────────────────────────────────────┐ │ [Icon] Server Name v1.0.0 │ -│ HTTP [●] Failed (3)[Toggle]│ +│ HTTP [Direct ▼] [●] Failed (3)[Toggle]│ ├─────────────────────────────────────────────────────────────────┤ │ https://api.example.com/mcp [Copy]│ ├─────────────────────────────────────────────────────────────────┤