Echo

Echo es un navegador de escritorio que se ejecuta en tu ordenador. Expone un servidor MCP para que Cursor, Claude Desktop, ChatGPT/Codex, Continue, Cline, Windsurf, VS Code y otros clientes MCP puedan controlarlo con tu suscripción existente.

No hay API de modelos ni Chromium en la nube. La ventana del navegador que ves es la que controla el asistente.

Inicio rápido (para tu amigo)

1. Instala Echo en tu ordenador (Windows, Mac o Linux; consulta más abajo).

2. Deja Echo en ejecución. Cerrar la ventana lo oculta; sigue ejecutándose en la bandeja del sistema (Windows/Linux) o en la barra de menú (Mac).

3. Abre Configuración (menú ⋮, arriba a la derecha) → Conexiones.

4. Haz clic en Conectar para Cursor, Claude o ChatGPT/Codex.

5. Cierra y vuelve a abrir por completo esa aplicación de IA para que detecte Echo.

6. Pide al asistente que busque en la web o abra una página; debería usar las herramientas de Echo (navigate, snapshot, search_web, etc.).

URL MCP en el mismo ordenador: http://127.0.0.1:18931/mcp
Nombre del servidor: echo
En Configuración → Conexiones se muestra un token de portador (Echo lo crea en el primer inicio).

Related MCP server: agentify-desktop

Descarga

Instaladores: GitHub Releases

Elige el archivo para tu sistema operativo:

Si la página de Releases está vacía, el mantenedor debe publicar una etiqueta de versión (por ejemplo, v1.0.0) para que GitHub Actions compile los instaladores. Hasta entonces, usa Ejecutar desde el código fuente más abajo.

Repositorio: https://github.com/krishngohel/local-browser

Instalación — Windows

1. Descarga el instalador para tu CPU desde Releases:

   • La mayoría de los PC: Echo-Setup-*-x64.exe

   • Portátiles ARM (Surface Pro X, Snapdragon, PC Copilot+): Echo-Setup-*-arm64.exe — no uses la compilación x64 en ARM.

2. Ejecuta el instalador. Windows SmartScreen puede avisarte porque la compilación no está firmada:

   • Haz clic en Más información → Ejecutar de todos modos.

3. Completa el asistente. Echo se instala en %LOCALAPPDATA%\Programs\Echo\ y añade accesos directos al Escritorio y al Menú Inicio.

4. Echo se abre al terminar la instalación. Déjalo en ejecución.

5. Cerrar la ventana no cierra Echo — se oculta en la bandeja del sistema (junto al reloj). Haz clic con el botón derecho en el icono de Echo para Mostrar o Salir.

Abrir Configuración: haz clic en el menú ⋮ (arriba a la derecha) → Conexiones.

Desinstalar: Configuración de Windows → Aplicaciones → Echo. Tu perfil de navegación permanece en %APPDATA%\Echo a menos que elimines esa carpeta manualmente.

Instalación — Mac

1. Descarga Echo-1.0.0-mac-universal.dmg desde Releases.

2. Abre el .dmg. Arrastra Echo a Aplicaciones.

3. Expulsa la imagen de disco. No sigas usando Echo desde el .dmg montado — dejará de funcionar después de expulsarlo. Echo te avisa si lo abres desde la imagen de disco.

4. Abre Echo desde Aplicaciones.

5. Primer inicio — Gatekeeper: la aplicación no está firmada (aún no tiene Apple Developer ID). macOS bloquea un doble clic normal:

   • Haz clic con el botón derecho en Echo → Abrir → Abrir.

   • En macOS Sequoia o posterior, si es necesario: Configuración del Sistema → Privacidad y seguridad → Abrir de todos modos.

6. Deja Echo en ejecución. El botón rojo de cerrar oculta la ventana; Echo permanece en el Dock y en la barra de menú (arriba a la derecha).

   • Para mostrarlo de nuevo: haz clic en el icono del Dock, en el icono de la barra de menú o en Echo → Mostrar Echo.

   • Para salir: Echo → Salir de Echo, Cmd+Q o icono de la barra de menú → Salir.

Abrir Configuración: menú ⋮ → Conexiones.

Si usas Claude Desktop: instala Node.js (LTS) desde nodejs.org. Claude iniciado desde el Dock no puede ver el PATH de Homebrew; Echo escribe la ruta completa de Node cuando haces clic en Conectar.

Carpeta de perfil: ~/Library/Application Support/Echo

Firewall (opcional): si otro dispositivo en tu Wi-Fi no puede conectarse, permite Echo en Configuración del Sistema → Red → Firewall.

Instalación — Linux

1. Descarga Echo-1.0.0-linux-x64.AppImage desde Releases.

2. Hazlo ejecutable y ejecútalo:

chmod +x Echo-1.0.0-linux-x64.AppImage
./Echo-1.0.0-linux-x64.AppImage

3. Deja Echo en ejecución (bandeja del sistema). Abre Configuración → Conexiones desde el menú ⋮.

Carpeta de perfil: ~/.config/Echo (o la ruta userData de Electron para la aplicación empaquetada).

Firewall (opcional): permite el puerto TCP 18931 (o el puerto que se muestra en Configuración) si otro dispositivo en tu red local necesita conectarse.

Conecta tu IA

Echo debe estar en ejecución antes de conectar. Abre Configuración (⋮) → Conexiones.

El punto verde junto a servidor MCP indica que Echo está escuchando. Copia la URL Este ordenador si la necesitas manualmente: http://127.0.0.1:18931/mcp.

Cursor

1. En Echo: haz clic en Conectar bajo Cursor.

2. Echo escribe ~/.cursor/mcp.json (hace una copia de seguridad de cualquier archivo existente en mcp.json.bak).

3. En Cursor: Configuración → MCP — activa echo si aparece desactivado.

4. Inicia un nuevo chat. El asistente debería ver las herramientas de Echo (navigate, snapshot, search_web, …).

Claude Desktop

Conectar no hace conexión en caliente. Echo escribe un archivo de configuración; Claude solo lo lee al iniciarse.

1. En Echo: haz clic en Conectar bajo Claude Desktop (Echo debe estar en ejecución).

2. Echo escribe la configuración de Claude:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

3. Cierra Claude Desktop por completo — este es el paso que la mayoría olvida:

   • Mac: Cmd+Q (cerrar el botón rojo no es suficiente)

   • Windows: haz clic con el botón derecho en Claude en la bandeja del sistema → Salir

4. Mantén Echo en ejecución (bandeja / barra de menú).

5. Abre Claude de nuevo.

6. En Claude: Configuración → Desarrollador → Servidores MCP locales — confirma que echo aparece en la lista. Un icono de martillo en el chat significa que las herramientas MCP están activas.

Echo empaquetado (v1.0.1+) usa el propio Echo como puente — Node.js no es necesario.

No uses el "Añadir conector personalizado" de Claude — eso es solo para servidores HTTPS públicos.

Si sigue fallando, consulta Claude no se conecta más abajo.

ChatGPT / Codex de escritorio

1. En Echo: haz clic en Conectar bajo ChatGPT / Codex.

2. Echo escribe ~/.codex/config.toml (hace una copia de seguridad en config.toml.bak).

3. Cierra y vuelve a abrir por completo ChatGPT de escritorio o Codex.

Nota: chatgpt.com en un navegador normal no puede acceder a Echo en tu ordenador a menos que configures tu propio túnel HTTPS.

Cualquier otro cliente MCP

En la misma página de Configuración, copia una de estas opciones:

• HTTP (este ordenador) — Cursor, Continue, Cline, Windsurf, VS Code, etc.

• stdio (este ordenador) — clientes que solo admiten MCP basado en comandos.

• Esta red — si el cliente de IA se ejecuta en otro dispositivo de tu Wi-Fi (usa la IP LAN de tu ordenador; sigue necesitando el token de portador).

Pega el JSON/TOML en la configuración MCP de ese cliente. Incluye el encabezado Authorization: Bearer … exactamente como se muestra.

Verifica que funciona

1. Echo está en ejecución (bandeja / barra de menú).

2. Configuración → Conexiones muestra servidor MCP como escuchando.

3. Tu aplicación de IA se reinició por completo después de Conectar.

4. Pide algo como: "Busca en Google Echo browser MCP y abre el primer resultado en Echo."

El asistente debería llamar a herramientas como search_web, navigate y snapshot. Si faltan herramientas, comprueba que echo está activado en la configuración MCP del cliente y vuelve a conectar.

Captcha / inicio de sesión / 2FA: complétalo tú mismo en la ventana de Echo. Dile al asistente que use wait_for y que luego continúe.

Uso diario

Abrir al iniciar sesión: Configuración → Sistema → Abrir al iniciar sesión (se inicia oculto en segundo plano).

Descargas, capturas de pantalla, grabaciones: Configuración → Sistema → Abrir carpeta.

Uso de tokens: Configuración → Transferencias — desactiva las fotos de página, los fotogramas de vigilancia o el árbol de habilidades al conectar si quieres usar menos tokens. Vuelve a conectar el cliente de IA después de cambiar los grupos de herramientas.

Ejecutar desde el código fuente (desarrolladores)

Requiere Node.js 20+.

git clone https://github.com/krishngohel/local-browser.git
cd local-browser
npm install
npm run dev

Esto compila la aplicación y abre la ventana de Electron. Playwright se conecta al mismo Chromium a través de CDP (puerto 9333). No necesitas una instalación de navegador aparte.

Compilar un instalador en tu máquina:

npm run dist

No puedes compilar un .dmg de Mac desde Windows — eso requiere un Mac o GitHub Actions en macos-latest.

En Windows, después de npm run dist, npm run start-menu añade Echo al Menú Inicio sin volver a ejecutar el asistente de instalación.

Solución de problemas

"Echo ya está en ejecución"

Solo debe ejecutarse una instancia de Echo (conflicto de puerto MCP). Busca Echo en la bandeja (Windows/Linux) o en la barra de menú (Mac). Sal desde allí y luego abre Echo una vez.

Claude no se conecta

Conectar guarda un archivo — no reinicia Claude por ti.

1. Echo debe estar en ejecución cuando Claude se inicie (bandeja en Windows, barra de menú en Mac).

2. Cierra Claude por completo, no solo la ventana de chat:

   • Mac: Cmd+Q

   • Windows: icono de bandeja → Salir

3. Vuelve a abrir Claude. Comprueba Configuración → Desarrollador → Servidores MCP locales para ver echo.

4. En Configuración de Echo → Conexiones, el estado debería cambiar de "Guardado en Claude" a Conectado ahora (verde) una vez que el puente de Claude esté activo.

5. En v1.0.0, instala Node.js y haz clic en Conectar de nuevo. v1.0.1+ no necesita Node — actualiza desde Releases.

6. Registros de Claude (si es necesario): Mac ~/Library/Logs/Claude/, Windows %APPDATA%\Claude\logs\.

Cursor / Claude no ve Echo (general)

• Echo debe estar en ejecución antes de que la aplicación de IA se inicie (o reinicia la aplicación de IA después de que Echo esté activo).

• Haz clic en Conectar de nuevo en Configuración → Conexiones.

• Cierra por completo Cursor o Claude (no solo la ventana de chat) y vuelve a abrirlos.

• Cursor: Configuración → MCP → activa echo.

• Claude: usa Servidores MCP locales, no "Añadir conector personalizado".

Claude dice que falta Node.js

Instala Node desde https://nodejs.org y luego haz clic en Conectar de nuevo en Echo para que escriba la ruta correcta.

Mac: "Echo no se puede abrir" / "dañado"

Haz clic con el botón derecho → Abrir, o Configuración del Sistema → Privacidad y seguridad → Abrir de todos modos. Esto es normal en aplicaciones sin firmar.

Mac: abierto desde la imagen de disco

Arrastra Echo a Aplicaciones, expulsa el .dmg y ábrelo desde Aplicaciones.

Avisos de SmartScreen / Gatekeeper

Los instaladores no están firmados hasta que se añada un certificado de firma de código. Usa los pasos anteriores — la aplicación se compila desde las GitHub Actions de este repositorio.

Google muestra captcha o consentimiento

Complétalo en la ventana de Echo. Pide al asistente que espere (wait_for) y reintente.

Otro dispositivo en Wi-Fi no puede conectarse

Usa la URL This network y el token de Settings. Permite que Echo pase por el firewall del equipo host en redes privadas. No compartas el token públicamente.

Puerto MCP en uso

Echo prefiere el puerto 18931 e intenta 18931–18940. Se evita el puerto 8931 (predeterminado de Playwright MCP). Consulta Settings para ver la URL real.

Portátil ARM con Windows (Surface, Snapdragon)

Usa Echo-Setup-*-arm64.exe, no el instalador x64. La compilación x64 puede fallar al instalar, bloquearse o comportarse de forma extraña bajo emulación. Las versiones desde v1.0.2 incluyen una compilación nativa ARM64 para Windows. Settings → System → About → System type debería indicar ARM64-based PC.

Qué le ofrece Echo a un asistente

Al conectarse, Echo envía un árbol de habilidades (cómo navegar, buscar, capturar, grabar, etc.) a menos que lo desactives en Settings → Transfers.

Navegación: tabs_list, tabs_new, tabs_close, tabs_select, navigate, back, reload, snapshot, screenshot, watch, click, type, fill, press, scroll, select, wait_for

Búsqueda / extracción: search_web, extract_readable

Depuración: console_errors, network_failures

Pruebas: viewport_set, test_start, test_assert_text, test_assert_url, test_end

Grabación / reproducción: record_start, record_stop, recordings_list, recording_play, recording_delete

Siempre haz snapshot antes de click / type / fill. Las referencias se ven como e0, e1.

Guía completa: skills/ECHO-SKILL-TREE.md

Seguridad (léelo)

• Cualquier cosa en la que inicies sesión en Echo es visible para un asistente conectado mientras MCP esté conectado.

• MCP escucha en este equipo y en tu LAN (0.0.0.0:18931, o el siguiente puerto libre). Los clientes de la misma máquina deben usar 127.0.0.1.

• Un bearer token protege el servidor MCP. Echo lo escribe en la configuración de Cursor/Claude cuando haces Connect. No publiques el token en línea.

• Echo usa un perfil separado de tu Chrome diario, no las cookies de tu navegador normal.

• Descargas: carpeta de datos de la app → downloads/. Grabaciones: recordings/.

Legal

• Política de privacidad

• Términos de servicio

• Licencia MIT

También en la app: Settings → About, Privacy, Terms.

Compilación / lanzamiento (mantenedores)

GitHub Actions (.github/workflows/release.yml) compila instaladores para Windows, Mac y Linux en etiquetas v* (por ejemplo git tag v1.0.0 && git push origin v1.0.0). El Run workflow manual sube artefactos a la ejecución de Actions, pero no crea una página de Release.

Las compilaciones de Mac y Windows no están firmadas a menos que se configuren secretos de firma.