feat: handle mcpmux://install deep link from discovery UI

Add install deep link route to the Tauri backend and a ServerInstallModal
component on the frontend. When the discovery web UI sends
mcpmux://install?server={id}, the desktop app now shows a confirmation
modal with server info and space picker, then installs via the existing
install_server command.

- Add "install" route to handle_deep_link() in oauth.rs
- Add ServerInstallModal component with loading/ready/error/success states
- Mount modal in App.tsx alongside OAuthConsentModal
- Expose emit in __TAURI_TEST_API__ for E2E event simulation
- Add emitEvent helper to E2E tauri-api.ts
- Add deeplink-install.wdio.ts E2E tests (6 test cases)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>

Author: its-mash

apps/desktop/src-tauri/src/commands/oauth.rs

@@ -44,6 +44,9 @@ use super::gateway::GatewayAppState;
 /// Now only contains request_id - frontend must call get_pending_consent
 pub const OAUTH_CONSENT_EVENT: &str = "oauth-consent-request";
 
+/// Event name for server install requests sent to frontend (from deep link)
+pub const SERVER_INSTALL_EVENT: &str = "server-install-request";
+
 /// Minimal deep link payload - only request_id
 /// Frontend must call get_pending_consent to get full details
 #[derive(Debug, Clone, Serialize)]
@@ -52,6 +55,13 @@ pub struct OAuthDeepLinkPayload {
     pub request_id: String,
 }
 
+/// Deep link payload for server installation requests
+#[derive(Debug, Clone, Serialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ServerInstallDeepLinkPayload {
+    pub server_id: String,
+}
+
 /// Full consent request details returned by get_pending_consent
 #[derive(Debug, Clone, Serialize)]
 #[serde(rename_all = "camelCase")]
@@ -111,6 +121,9 @@ pub fn handle_deep_link<R: tauri::Runtime>(app: &tauri::AppHandle<R>, url: &str)
             // Inbound OAuth - client requesting approval
             handle_authorize_deep_link(app, &parsed);
         }
+        Some("install") => {
+            handle_install_deep_link(app, &parsed);
+        }
         Some("test") => {
             info!("[DeepLink] Test URL received successfully!");
         }
@@ -157,6 +170,41 @@ fn handle_authorize_deep_link<R: tauri::Runtime>(app: &tauri::AppHandle<R>, url:
     }
 }
 
+/// Handle server install deep link
+///
+/// Extracts server_id and emits to frontend.
+/// Frontend will look up the server definition and show install modal.
+fn handle_install_deep_link<R: tauri::Runtime>(app: &tauri::AppHandle<R>, url: &Url) {
+    let params: HashMap<_, _> = url.query_pairs().collect();
+
+    let server_id = match params.get("server") {
+        Some(id) if !id.is_empty() => id.to_string(),
+        _ => {
+            error!("[DeepLink] Install link missing required parameter: server");
+            return;
+        }
+    };
+
+    info!(
+        "[DeepLink] Server install request: server_id='{}'",
+        server_id
+    );
+
+    let payload = ServerInstallDeepLinkPayload { server_id };
+
+    if let Err(e) = app.emit(SERVER_INSTALL_EVENT, &payload) {
+        error!("[DeepLink] Failed to emit server install event: {}", e);
+        return;
+    }
+
+    // Focus the main window
+    if let Some(window) = app.get_webview_window("main") {
+        let _ = window.show();
+        let _ = window.unminimize();
+        let _ = window.set_focus();
+    }
+}
+
 /// Handle OAuth callback deep link (legacy - for outbound OAuth server connections)
 ///
 /// NOTE: The primary OAuth callback mechanism is now the loopback HTTP server

apps/desktop/src/App.tsx

@@ -28,6 +28,7 @@ import {
 } from '@mcpmux/ui';
 import { ThemeProvider } from '@/components/ThemeProvider';
 import { OAuthConsentModal } from '@/components/OAuthConsentModal';
+import { ServerInstallModal } from '@/components/ServerInstallModal';
 import { SpaceSwitcher } from '@/components/SpaceSwitcher';
 import { useDataSync } from '@/hooks/useDataSync';
 import { useAppStore, useActiveSpace, useViewSpace, useTheme } from '@/stores';
@@ -203,6 +204,8 @@ function App() {
       <AppContent />
       {/* OAuth consent modal - shown when MCP clients request authorization */}
       <OAuthConsentModal />
+      {/* Server install modal - shown when install deep link is received */}
+      <ServerInstallModal />
     </ThemeProvider>
   );
 }