Quick Start

Quick Start (60 seconds)

Build SurfaceProxy, run the daemon, and connect your IDE or browser automation tool in a minute.

Last updated: June 10, 2026

1. Build the binary

git clone https://github.com/sentrysurface/surfaceproxy-core
cd surfaceproxy-core
go build -o surface-proxy ./cmd/surface-proxy

2. Run the full daemon

./surface-proxy --config surface-proxy.json

The proxy starts on :8443, launches a headless Chrome browser automatically, and opens the dashboard at http://localhost:8080.

3. Connect your IDE

Cursor - add to ~/.config/Cursor/mcp.json:

{
	"mcpServers": {
		"surface-proxy": {
			"command": "./surface-proxy",
			"args": ["mcp-mode", "--config", "surface-proxy.json"]
		}
	}
}

Claude Desktop - add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
	"mcpServers": {
		"surface-proxy": {
			"command": "./surface-proxy",
			"args": ["mcp-mode", "--config", "surface-proxy.json"]
		}
	}
}

4. Connect Playwright / Browser-Use

browser = await playwright.chromium.connect(
		wsEndpoint="ws://localhost:8443/v1/session?allowlist=*.github.com"
)