Merge pull request #69 from RoopikLabs/external-agent-support

Expose MCP connection info and token

Author: HumbleBee14

src/vs/workbench/contrib/roopik/browser/commands/mcpCommands.ts

@@ -18,6 +18,7 @@ import { registerAction2, Action2 } from '../../../../../platform/actions/common
 import { ServicesAccessor } from '../../../../../platform/instantiation/common/instantiation.js';
 import { INotificationService, Severity } from '../../../../../platform/notification/common/notification.js';
 import { IQuickInputService, IQuickPickItem } from '../../../../../platform/quickinput/common/quickInput.js';
+import { IClipboardService } from '../../../../../platform/clipboard/common/clipboardService.js';
 import { IMcpServerService, AgentId, AgentStatus } from '../../common/mcp/index.js';
 
 /**
@@ -236,4 +237,75 @@ export function registerMcpCommands(): void {
 			}
 		}
 	});
+
+	// Show MCP Connection Info (for external IDEs)
+	registerAction2(class extends Action2 {
+		constructor() {
+			super({
+				id: 'roopik.mcp.showConnectionInfo',
+				title: localize2('roopik.mcp.showConnectionInfo', 'Show MCP Connection Info'),
+				category: localize2('roopik.category', 'Roopik'),
+				f1: true
+			});
+		}
+
+		async run(accessor: ServicesAccessor): Promise<void> {
+			const notificationService = accessor.get(INotificationService);
+			const mcpServerService = accessor.get(IMcpServerService);
+			const quickInputService = accessor.get(IQuickInputService);
+			const clipboardService = accessor.get(IClipboardService);
+
+			try {
+				const connectionInfo = await mcpServerService.getConnectionInfo();
+
+				if (!connectionInfo.isRunning) {
+					notificationService.warn('MCP Server is not running. Enable it in Settings > Roopik > MCP.');
+					return;
+				}
+
+				// Build the MCP config JSON that users can copy
+				const mcpConfig = JSON.stringify({
+					roopik: {
+						command: connectionInfo.binaryPath,
+						args: ['--ws-port', connectionInfo.wsPort.toString(), '--token', connectionInfo.token]
+					}
+				}, null, 2);
+
+				const items: IQuickPickItem[] = [
+					{
+						label: '$(key) Copy Token',
+						description: connectionInfo.token,
+						detail: 'Copy authentication token to clipboard'
+					},
+					{
+						label: '$(terminal) Copy MCP Config',
+						description: 'JSON config for mcp_servers',
+						detail: 'Copy complete MCP server config for external IDEs'
+					},
+					{
+						label: '$(info) Connection Details',
+						description: `Port: ${connectionInfo.wsPort}`,
+						detail: `Binary: ${connectionInfo.binaryPath}`
+					}
+				];
+
+				const selected = await quickInputService.pick(items, {
+					title: 'Roopik MCP Connection Info',
+					placeHolder: 'Select what to copy (token changes on IDE restart)'
+				});
+
+				if (selected) {
+					if (selected.label.includes('Copy Token')) {
+						await clipboardService.writeText(connectionInfo.token);
+						notificationService.info('Token copied to clipboard');
+					} else if (selected.label.includes('Copy MCP Config')) {
+						await clipboardService.writeText(mcpConfig);
+						notificationService.info('MCP config copied to clipboard');
+					}
+				}
+			} catch (error) {
+				notificationService.error(`Failed to get connection info: ${error}`);
+			}
+		}
+	});
 }

src/vs/workbench/contrib/roopik/browser/mcpServerServiceClient.ts

@@ -20,6 +20,7 @@ import { IMainProcessService } from '../../../../platform/ipc/common/mainProcess
 import {
 	IMcpServerService,
 	McpServerStatus,
+	McpConnectionInfo,
 	AgentId,
 	AgentStatus,
 	McpIntegrationStatus,
@@ -98,4 +99,12 @@ export class McpServerServiceClient implements IMcpServerService {
 	async syncAgentRegistrations(): Promise<void> {
 		return this.channel.call('syncAgentRegistrations');
 	}
+
+	// ========================================
+	// Connection Info (for external IDEs)
+	// ========================================
+
+	async getConnectionInfo(): Promise<McpConnectionInfo> {
+		return this.channel.call('getConnectionInfo');
+	}
 }

src/vs/workbench/contrib/roopik/browser/roopik.contribution.ts

@@ -133,7 +133,7 @@ Registry.as<IConfigurationRegistry>(ConfigurationExtensions.Configuration).regis
 			type: 'boolean',
 			default: true,
 			order: 10,
-			markdownDescription: '**Enable STDIO MCP** [Recommended] - Allow AI agents (Claude, Codex, etc.) to control Roopik IDE via the standard STDIO-based MCP protocol.'
+			markdownDescription: '**Enable STDIO MCP** [Recommended] - Allow AI agents (Claude, Codex, etc.) to control Roopik IDE via the standard STDIO-based MCP protocol.\n\nFor external IDEs (Cursor, Windsurf, VS Code): Run command [Show MCP Connection Info](command:roopik.mcp.showConnectionInfo) to get token and setup instructions.'
 		},
 		'roopik.mcp.stdioMCPPort': {
 			type: 'number',
@@ -202,6 +202,17 @@ Registry.as<IConfigurationRegistry>(ConfigurationExtensions.Configuration).regis
 			description: 'Register with Windsurf IDE. Allows Windsurf AI to control Roopik IDE.'
 		},
 
+		// ========================================
+		// MCP Connection Info (for external IDEs)
+		// ========================================
+		'roopik.mcp.connectionInfo': {
+			type: 'object',
+			default: {},
+			order: 27,
+			markdownDescription: '**Connect External IDEs** - Use Roopik MCP tools from Cursor, Windsurf, or VS Code.\n\n[Show Connection Info](command:roopik.mcp.showConnectionInfo) - Get token and command to configure external IDEs.\n\n*Note: Token changes when Roopik restarts. Re-register agents after restart.*',
+			ignoreSync: true
+		},
+
 		// ========================================
 		// Browser Settings
 		// ========================================

src/vs/workbench/contrib/roopik/common/mcp/index.ts

@@ -10,6 +10,7 @@
 export {
 	IMcpServerService,
 	McpServerStatus,
+	McpConnectionInfo,
 	AgentId,
 	AgentStatus,
 	McpIntegrationStatus

src/vs/workbench/contrib/roopik/common/mcp/mcpServerService.ts

@@ -75,6 +75,20 @@ export interface McpIntegrationStatus {
 	lastChecked: number;
 }
 
+/**
+ * Connection info for external IDEs
+ */
+export interface McpConnectionInfo {
+	/** WebSocket port */
+	wsPort: number;
+	/** Authentication token (for external IDEs) */
+	token: string;
+	/** Path to MCP binary */
+	binaryPath: string;
+	/** Whether the server is running */
+	isRunning: boolean;
+}
+
 // ============================================================================
 // Service Interface
 // ============================================================================
@@ -134,4 +148,7 @@ export interface IMcpServerService {
 
 	/** Sync all agent registrations with current settings */
 	syncAgentRegistrations(): Promise<void>;
+
+	/** Get connection info for external IDEs */
+	getConnectionInfo(): Promise<McpConnectionInfo>;
 }

src/vs/workbench/contrib/roopik/electron-main/channel/mcpServerChannel.ts

@@ -73,6 +73,10 @@ export class McpServerChannel implements IServerChannel {
 			case 'syncAgentRegistrations':
 				return this.service.syncAgentRegistrations();
 
+			// Connection info (for external IDEs)
+			case 'getConnectionInfo':
+				return this.service.getConnectionInfo();
+
 			default:
 				throw new Error(`[McpServerChannel] Unknown command: ${command}`);
 		}

src/vs/workbench/contrib/roopik/electron-main/mcp/installer/mcpInstaller.ts

@@ -90,6 +90,7 @@ const CODEX_EXTENSION_ID = 'openai.chatgpt';
 export class McpInstaller extends Disposable {
 	private _wsPort: number = 9876;
 	private _binaryPath: string;
+	private _authToken: string = '';
 	private _platformAdapter: McpPlatformAdapter | null = null;
 
 	// Events
@@ -125,6 +126,14 @@ export class McpInstaller extends Disposable {
 		this._binaryPath = path;
 	}
 
+	/**
+	 * Set the authentication token for external agent configs
+	 * External IDEs (Cursor, Windsurf) need this passed via --token arg
+	 */
+	setAuthToken(token: string): void {
+		this._authToken = token;
+	}
+
 	// ==========================================================================
 	// Agent Detection
 	// ==========================================================================
@@ -462,10 +471,11 @@ export class McpInstaller extends Disposable {
 			// Read existing config
 			const existingConfig = readJsonConfig<{ mcpServers?: Record<string, unknown> }>(configPath);
 
-			// Generate server entry
+			// Generate server entry with token for external IDEs
 			const serverEntry = generateMcpServerEntry({
 				binaryPath: this._binaryPath,
-				wsPort: this._wsPort
+				wsPort: this._wsPort,
+				token: this._authToken
 			});
 
 			// Add Roopik to config

src/vs/workbench/contrib/roopik/electron-main/mcp/installer/mcpInstallerUtils.ts

@@ -583,16 +583,18 @@ export function backupConfig(filePath: string): string | null {
 
 /**
  * Generate the MCP server entry for registration
+ * @param token - Required for external IDEs (Cursor, Windsurf), they don't inherit env var
  */
 export function generateMcpServerEntry(options: {
 	binaryPath: string;
 	wsPort: number;
+	token: string;
 }): McpServerEntry {
 	return {
 		name: ROOPIK_MCP_NAME,
 		transport: 'stdio',
 		command: options.binaryPath,
-		args: ['--ws-port', options.wsPort.toString()],
+		args: ['--ws-port', options.wsPort.toString(), '--token', options.token],
 		env: {}
 	};
 }

src/vs/workbench/contrib/roopik/electron-main/mcp/mcpServerService.ts

@@ -26,7 +26,7 @@ import { Disposable } from '../../../../../base/common/lifecycle.js';
 import { ILoggerService } from '../../../../../platform/log/common/log.js';
 import { getRoopikLogger } from '../../common/roopikLogger.js';
 import { IConfigurationService } from '../../../../../platform/configuration/common/configuration.js';
-import { IMcpServerService, McpServerStatus, AgentId, AgentStatus, McpIntegrationStatus } from '../../common/mcp/mcpServerService.js';
+import { IMcpServerService, McpServerStatus, McpConnectionInfo, AgentId, AgentStatus, McpIntegrationStatus } from '../../common/mcp/mcpServerService.js';
 import type { DevServerService } from '../projectMode/devServer/devServerService.js';
 import type { BrowserViewService } from '../projectMode/browserViewService.js';
 import type { ComponentService } from '../component/componentService.js';
@@ -37,6 +37,7 @@ import type { IRoopikStorageService } from '../../common/storage/storageService.
 import { ToolExecutor } from './executor/index.js';
 import { McpWebSocketServer } from './websocket/index.js';
 import { McpInstaller, type McpPlatformAdapter, type McpIntegrationSettings } from './installer/index.js';
+import { getMcpBinaryPath } from './installer/mcpInstallerUtils.js';
 
 // ============================================================================
 // MCP Server Service Implementation
@@ -186,6 +187,8 @@ export class McpServerService extends Disposable implements IMcpServerService {
 	private async initializeInstaller(): Promise<void> {
 		this.installer = new McpInstaller();
 		this.installer.setWsPort(this.wsPort);
+		// Pass token for external IDEs (Cursor, Windsurf) - they need it via --token arg
+		this.installer.setAuthToken(this.sessionToken);
 
 		// Create platform adapter for VS Code extension access
 		const platformAdapter: McpPlatformAdapter = {
@@ -310,12 +313,12 @@ export class McpServerService extends Disposable implements IMcpServerService {
 				// Initialize Tool Executor if needed
 				if (!this.toolExecutor) {
 					this.toolExecutor = new ToolExecutor(
-					this.browserViewService,
-					this.storageService,
-					this.canvasService,
-					this.componentService,
-					this.devServerService
-				);
+						this.browserViewService,
+						this.storageService,
+						this.canvasService,
+						this.componentService,
+						this.devServerService
+					);
 				}
 				await this.startWebSocketServer();
 				await this.initializeInstaller();
@@ -412,6 +415,15 @@ export class McpServerService extends Disposable implements IMcpServerService {
 		this._onAgentStatusChanged.fire(await this.getAgentStatus());
 	}
 
+	async getConnectionInfo(): Promise<McpConnectionInfo> {
+		return {
+			wsPort: this.wsPort,
+			token: this.sessionToken,
+			binaryPath: getMcpBinaryPath(),
+			isRunning: this.wsServer !== null
+		};
+	}
+
 	private agentIdToSettingKey(agentId: AgentId): string | null {
 		const map: Record<AgentId, string> = {
 			'claude-code': 'roopik.mcp.agents.claudeCode',

tools/roopik/mcp-stdio-server/src/index.ts

@@ -38,6 +38,7 @@ import { TOOL_DEFINITIONS, PROMPT_DEFINITIONS, MCP_INSTRUCTIONS } from './tools.
 interface CliArgs {
 	wsPort?: number;
 	wsUrl?: string;
+	token?: string;
 }
 
 function parseArgs(): CliArgs {
@@ -51,6 +52,9 @@ function parseArgs(): CliArgs {
 		} else if (args[i] === '--ws-url' && args[i + 1]) {
 			result.wsUrl = args[i + 1];
 			i++;
+		} else if (args[i] === '--token' && args[i + 1]) {
+			result.token = args[i + 1];
+			i++;
 		}
 	}
 
@@ -88,7 +92,7 @@ async function main(): Promise<void> {
 			console.error(`[Roopik MCP] Auto-discovered Roopik at ${serverUrl}`);
 		}
 
-		bridge = new WebSocketBridge({ serverUrl });
+		bridge = new WebSocketBridge({ serverUrl, token: cliArgs.token });
 		await bridge.connect();
 		console.error('[Roopik MCP] Connected to Roopik IDE');