fix(desktop): resolve actual desktop-mcp bin path for setup snippet

apps/desktop/src/lib/trpc/routers/browser-automation/index.ts

@@ -1,7 +1,7 @@
 import { EventEmitter } from "node:events";
-import { readFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { join, resolve } from "node:path";
 import {
 	browserAutomationBindings,
 	projects,
@@ -11,6 +11,7 @@ import {
 } from "@superset/local-db";
 import { observable } from "@trpc/server/observable";
 import { and, eq, ne } from "drizzle-orm";
+import { app } from "electron";
 import { localDb } from "main/lib/local-db";
 import { getProcessName, getProcessTree } from "main/lib/terminal/port-scanner";
 import { getTerminalHostClient } from "main/lib/terminal-host/client";
@@ -288,6 +289,33 @@ const CLAUDE_SETTINGS_JSON_PATH = join(homedir(), ".claude", "settings.json");
 const CLAUDE_CONFIG_PATHS = [CLAUDE_USER_JSON_PATH, CLAUDE_SETTINGS_JSON_PATH];
 const CODEX_CONFIG_PATH = join(homedir(), ".codex", "config.toml");
 
+/**
+ * Resolve the absolute command Claude / Codex should spawn to start the
+ * superset-browser MCP server. `desktop-mcp` is a workspace-private bin
+ * (TypeScript, no compiled output), so it is not on PATH. We point
+ * users at `bun <repo>/packages/desktop-mcp/src/bin.ts` instead — bun
+ * can execute TypeScript directly.
+ *
+ * In packaged production builds the source tree isn't available, so we
+ * fall back to the bare `desktop-mcp` name and let the user pick the
+ * command themselves. (Browser automation is dev-only today.)
+ */
+function resolveDesktopMcpCommand(): {
+	command: string;
+	args: string[];
+	available: boolean;
+} {
+	if (!app.isPackaged) {
+		// `app.getAppPath()` is the `apps/desktop` directory in dev.
+		const repoRoot = resolve(app.getAppPath(), "../..");
+		const binPath = join(repoRoot, "packages/desktop-mcp/src/bin.ts");
+		if (existsSync(binPath)) {
+			return { command: "bun", args: [binPath], available: true };
+		}
+	}
+	return { command: "desktop-mcp", args: [], available: false };
+}
+
 export interface TerminalAgentSession {
 	paneId: string;
 	workspaceId: string;
@@ -374,12 +402,14 @@ export const createBrowserAutomationRouter = () => {
 				claudeReadyByWorkspaceId[workspaceId] = localScope || projectScope;
 			}
 			const codexReady = detectCodexMcp(CODEX_CONFIG_PATH);
+			const serverCommand = resolveDesktopMcpCommand();
 			return {
 				claudeHomeReady,
 				claudeReadyByWorkspaceId,
 				codexReady,
 				claudeConfigPath: CLAUDE_USER_JSON_PATH,
 				codexConfigPath: CODEX_CONFIG_PATH,
+				serverCommand,
 			};
 		}),
 

apps/desktop/src/renderer/screens/main/components/WorkspaceView/ContentView/TabsContent/TabView/BrowserPane/components/SessionConnectModal/SessionConnectModal.tsx

@@ -16,6 +16,7 @@ import { electronTrpc } from "renderer/lib/electron-trpc";
 import {
 	type AutomationSession,
 	getSnippetForSession,
+	type ServerCommand,
 	useBrowserAutomationStore,
 } from "renderer/stores/browser-automation";
 import { useTabsStore } from "renderer/stores/tabs/store";
@@ -143,10 +144,14 @@ export function SessionConnectModal({
 		}
 	};
 
+	const serverCommand = mcpStatus?.serverCommand;
+
 	const handleCopySnippet = async () => {
 		if (!session) return;
 		try {
-			await navigator.clipboard.writeText(getSnippetForSession(session));
+			await navigator.clipboard.writeText(
+				getSnippetForSession(session, serverCommand),
+			);
 			toast.success("Configuration snippet copied");
 		} catch {
 			toast.error("Failed to copy snippet");
@@ -244,6 +249,7 @@ export function SessionConnectModal({
 											? (mcpStatus?.codexConfigPath ?? null)
 											: (mcpStatus?.claudeConfigPath ?? null)
 									}
+									serverCommand={serverCommand}
 									onCopy={handleCopySnippet}
 								/>
 							)
@@ -448,13 +454,15 @@ function DetailItem({
 function SetupPanel({
 	session,
 	mcpConfigPath,
+	serverCommand,
 	onCopy,
 }: {
 	session: AutomationSession;
 	mcpConfigPath: string | null;
+	serverCommand?: ServerCommand;
 	onCopy: () => void;
 }) {
-	const snippet = getSnippetForSession(session);
+	const snippet = getSnippetForSession(session, serverCommand);
 	return (
 		<div className="flex flex-col gap-3">
 			<div className="rounded-xl border p-3 bg-card/60">

apps/desktop/src/renderer/stores/browser-automation.ts

@@ -64,18 +64,36 @@ export const useBrowserAutomationStore = create<BrowserAutomationUiState>(
 	}),
 );
 
-export function getSnippetForSession(session: AutomationSession): string {
+export interface ServerCommand {
+	command: string;
+	args: string[];
+	available: boolean;
+}
+
+function tomlString(value: string): string {
+	return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+
+function shellQuote(value: string): string {
+	return /^[\w@./:+-]+$/.test(value)
+		? value
+		: `'${value.replace(/'/g, "'\\''")}'`;
+}
+
+export function getSnippetForSession(
+	session: AutomationSession,
+	server?: ServerCommand,
+): string {
+	const cmd = server?.command ?? "desktop-mcp";
+	const args = server?.args ?? [];
 	if (session.provider === "Codex") {
-		// TOML is section-based, so appending this block to an existing
-		// config.toml is safe. The bin comes from packages/desktop-mcp.
+		const argsToml = args.map(tomlString).join(", ");
 		return `[mcp_servers.superset-browser]
-command = "desktop-mcp"
-args = []`;
+command = ${tomlString(cmd)}
+args = [${argsToml}]`;
 	}
-	// For Claude Code we recommend `claude mcp add` so the user's
-	// ~/.claude.json is updated in-place instead of manually merging a
-	// standalone JSON document (which would produce invalid JSON).
-	return `claude mcp add superset-browser -s local -- desktop-mcp`;
+	const parts = [cmd, ...args].map(shellQuote).join(" ");
+	return `claude mcp add superset-browser -s local -- ${parts}`;
 }
 
 function formatRelativeTime(ts: number | null | undefined): string {