Echo

Echo ist ein Desktop-Browser, der auf deinem Computer läuft. Er stellt einen MCP-Server bereit, sodass Cursor, Claude Desktop, ChatGPT/Codex, Continue, Cline, Windsurf, VS Code und andere MCP-Clients ihn mit deinem bestehenden Abonnement steuern können.

Es gibt keine Modell-API und kein Cloud-Chromium. Das Browserfenster, das du siehst, ist das, das der Assistent steuert.

Schnellstart (für deinen Freund)

1. Installiere Echo auf deinem Computer (Windows, Mac oder Linux – siehe unten).

2. Lass Echo laufen. Das Schließen des Fensters blendet es aus; es läuft im Tray (Windows/Linux) oder in der Menüleiste (Mac) weiter.

3. Öffne Einstellungen (⋮-Menü, oben rechts) → Verbindungen.

4. Klicke auf Verbinden für Cursor, Claude oder ChatGPT/Codex.

5. Beende und starte diese KI-App vollständig neu, damit sie Echo erkennt.

6. Bitte den Assistenten, im Web zu suchen oder eine Seite zu öffnen – er sollte Echos Tools verwenden (navigate, snapshot, search_web usw.).

MCP-URL auf demselben Computer: http://127.0.0.1:18931/mcp
Servername: echo
Ein Bearer-Token wird in Einstellungen → Verbindungen angezeigt (Echo erstellt es beim ersten Start).

Related MCP server: agentify-desktop

Download

Installationsprogramme: GitHub Releases

Wähle die Datei für dein Betriebssystem:

Wenn die Releases-Seite leer ist, muss der Maintainer einen Versions-Tag (z. B. v1.0.0) veröffentlichen, damit GitHub Actions die Installationsprogramme erstellt. Bis dahin verwende Aus dem Quellcode ausführen unten.

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

Installation – Windows

1. Lade das Installationsprogramm für deine CPU von Releases herunter:

   • Die meisten PCs: Echo-Setup-*-x64.exe

   • ARM-Laptops (Surface Pro X, Snapdragon, Copilot+-PC): Echo-Setup-*-arm64.exe – verwende den x64-Build nicht auf ARM.

2. Führe das Installationsprogramm aus. Windows SmartScreen warnt möglicherweise, weil der Build nicht signiert ist:

   • Klicke auf Weitere Informationen → Trotzdem ausführen.

3. Schließe den Assistenten ab. Echo wird in %LOCALAPPDATA%\Programs\Echo\ installiert und fügt Desktop- und Startmenü-Verknüpfungen hinzu.

4. Echo öffnet sich, wenn die Installation abgeschlossen ist. Lass es laufen.

5. Das Schließen des Fensters beendet Echo nicht – es wird in der Systemleiste (neben der Uhr) ausgeblendet. Klicke dort mit der rechten Maustaste auf das Echo-Symbol, um Anzeigen oder Beenden zu wählen.

Einstellungen öffnen: Klicke auf das ⋮-Menü (oben rechts) → Verbindungen.

Deinstallieren: Windows-Einstellungen → Apps → Echo. Dein Browserprofil bleibt in %APPDATA%\Echo erhalten, es sei denn, du löschst diesen Ordner manuell.

Installation – Mac

1. Lade Echo-1.0.0-mac-universal.dmg von Releases herunter.

2. Öffne die .dmg. Ziehe Echo in den Programme-Ordner.

3. Wirf das Disk-Image aus. Verwende Echo nicht weiter vom eingehängten .dmg – es funktioniert nach dem Auswerfen nicht mehr. Echo warnt dich, wenn du es vom Disk-Image startest.

4. Öffne Echo aus Programme.

5. Erster Start – Gatekeeper: Die App ist nicht signiert (noch keine Apple Developer ID). macOS blockiert einen normalen Doppelklick:

   • Rechtsklick auf Echo → Öffnen → Öffnen.

   • Auf macOS Sequoia oder neuer, falls nötig: Systemeinstellungen → Datenschutz & Sicherheit → Trotzdem öffnen.

6. Lass Echo laufen. Der rote Schließen-Button blendet das Fenster aus; Echo bleibt im Dock und in der Menüleiste (oben rechts).

   • Wieder anzeigen: Klicke auf das Dock-Symbol, das Menüleisten-Symbol oder Echo → Echo anzeigen.

   • Beenden: Echo → Echo beenden, Cmd+Q oder Menüleisten-Symbol → Beenden.

Einstellungen öffnen: ⋮-Menü → Verbindungen.

Wenn du Claude Desktop verwendest: Installiere Node.js (LTS) von nodejs.org. Claude, das vom Dock gestartet wird, kann den PATH von Homebrew nicht sehen; Echo schreibt den vollständigen Pfad von Node, wenn du auf Verbinden klickst.

Profilordner: ~/Library/Application Support/Echo

Firewall (optional): Wenn ein anderes Gerät in deinem WLAN keine Verbindung herstellen kann, erlaube Echo in Systemeinstellungen → Netzwerk → Firewall.

Installation – Linux

1. Lade Echo-1.0.0-linux-x64.AppImage von Releases herunter.

2. Mache es ausführbar und führe es aus:

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

3. Lass Echo laufen (Systemleiste). Öffne Einstellungen → Verbindungen über das ⋮-Menü.

Profilordner: ~/.config/Echo (oder der Electron-userData-Pfad für die gepackte App).

Firewall (optional): Erlaube TCP-Port 18931 (oder den in den Einstellungen angezeigten Port), wenn ein anderes Gerät in deinem LAN eine Verbindung benötigt.

Verbinde deine KI

Echo muss laufen, bevor du dich verbindest. Öffne Einstellungen (⋮) → Verbindungen.

Der grüne Punkt neben MCP-Server bedeutet, dass Echo lauscht. Kopiere die Dieser Computer-URL, falls du sie manuell benötigst: http://127.0.0.1:18931/mcp.

Cursor

1. In Echo: Klicke auf Verbinden unter Cursor.

2. Echo schreibt ~/.cursor/mcp.json (sichert eine vorhandene Datei als mcp.json.bak).

3. In Cursor: Einstellungen → MCP – aktiviere echo, falls es als deaktiviert angezeigt wird.

4. Starte einen neuen Chat. Der Assistent sollte Echos Tools sehen (navigate, snapshot, search_web, …).

Claude Desktop

Verbinden ist nicht hot-plug-fähig. Echo schreibt eine Konfigurationsdatei; Claude liest sie nur beim Start.

1. In Echo: Klicke auf Verbinden unter Claude Desktop (Echo muss laufen).

2. Echo schreibt Claudes Konfiguration:

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

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

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

3. Beende Claude Desktop vollständig – das ist der Schritt, den die meisten übersehen:

   • Mac: Cmd+Q (das Schließen des roten Buttons reicht nicht)

   • Windows: Rechtsklick auf Claude in der Systemleiste → Beenden

4. Lass Echo laufen (Tray / Menüleiste).

5. Öffne Claude erneut.

6. In Claude: Einstellungen → Entwickler → Lokale MCP-Server – bestätige, dass echo aufgelistet ist. Ein Hammer-Symbol im Chat bedeutet, dass MCP-Tools aktiv sind.

Gepacktes Echo (v1.0.1+) verwendet Echo selbst als Brücke – Node.js ist nicht erforderlich.

Verwende nicht Claudes „Benutzerdefinierten Connector hinzufügen“ – das ist nur für öffentliche HTTPS-Server gedacht.

Wenn es weiterhin fehlschlägt, siehe Claude verbindet nicht unten.

ChatGPT / Codex Desktop

1. In Echo: Klicke auf Verbinden unter ChatGPT / Codex.

2. Echo schreibt ~/.codex/config.toml (sichert als config.toml.bak).

3. Beende und starte ChatGPT Desktop oder Codex vollständig neu.

Hinweis: chatgpt.com in einem normalen Browser kann Echo auf deinem Computer nicht erreichen, es sei denn, du richtest deinen eigenen HTTPS-Tunnel ein.

Jeder andere MCP-Client

Kopiere auf derselben Einstellungsseite eine der folgenden Optionen:

• HTTP (dieser Computer) – Cursor, Continue, Cline, Windsurf, VS Code usw.

• stdio (dieser Computer) – Clients, die nur befehlsbasiertes MCP unterstützen.

• Dieses Netzwerk – wenn der KI-Client auf einem anderen Gerät in deinem WLAN läuft (verwendet die LAN-IP deines Computers; benötigt weiterhin das Bearer-Token).

Füge das JSON/TOML in die MCP-Konfiguration des Clients ein. Füge den Authorization: Bearer …-Header genau wie angegeben hinzu.

Überprüfen, ob es funktioniert

1. Echo läuft (Tray / Menüleiste).

2. Einstellungen → Verbindungen zeigt MCP-Server als lauschend an.

3. Deine KI-App wurde nach dem Verbinden vollständig neu gestartet.

4. Frage etwas wie: „Suche bei Google nach Echo-Browser-MCP und öffne das erste Ergebnis in Echo.“

Der Assistent sollte Tools wie search_web, navigate und snapshot aufrufen. Wenn Tools fehlen, überprüfe, ob echo in den MCP-Einstellungen des Clients aktiviert ist, und verbinde erneut.

Captcha / Login / 2FA: Erledige es selbst im Echo-Fenster. Sage dem Assistenten, er soll wait_for und dann fortfahren.

Tägliche Nutzung

Beim Anmelden öffnen: Einstellungen → System → Beim Anmelden öffnen (startet im Hintergrund ausgeblendet).

Downloads, Screenshots, Aufnahmen: Einstellungen → System → Ordner öffnen.

Token-Verbrauch: Einstellungen → Übertragungen – deaktiviere Seitenfotos, Frame-Überwachung oder den Fähigkeitenbaum beim Verbinden, wenn du weniger Tokens verbrauchen möchtest. Verbinde den KI-Client nach dem Ändern der Tool-Gruppen neu.

Aus dem Quellcode ausführen (Entwickler)

Erfordert Node.js 20+.

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

Dies kompiliert die App und öffnet das Electron-Fenster. Playwright verbindet sich über CDP (Port 9333) mit demselben Chromium. Du benötigst keine separate Browser-Installation.

Erstelle ein Installationsprogramm auf deinem Rechner:

npm run dist

Du kannst kein Mac-.dmg von Windows aus erstellen – das erfordert einen Mac oder GitHub Actions auf macos-latest.

Unter Windows fügt npm run start-menu nach npm run dist Echo zum Startmenü hinzu, ohne den Installationsassistenten erneut auszuführen.

Fehlerbehebung

„Echo läuft bereits“

Es sollte nur eine Echo-Instanz laufen (MCP-Portkonflikt). Finde Echo im Tray (Windows/Linux) oder in der Menüleiste (Mac). Beende es von dort und öffne Echo dann einmal.

Claude verbindet nicht

Verbinden speichert eine Datei – es startet Claude nicht für dich neu.

1. Echo muss laufen, wenn Claude startet (Tray unter Windows, Menüleiste unter Mac).

2. Beende Claude vollständig, nicht nur das Chat-Fenster schließen:

   • Mac: Cmd+Q

   • Windows: Tray-Symbol → Beenden

3. Öffne Claude erneut. Überprüfe Einstellungen → Entwickler → Lokale MCP-Server auf echo.

4. In Echo-Einstellungen → Verbindungen sollte der Status von „In Claude gespeichert“ auf Jetzt verbunden (grün) wechseln, sobald Claudes Brücke aktiv ist.

5. Bei v1.0.0 installiere Node.js und klicke erneut auf Verbinden. v1.0.1+ benötigt kein Node – aktualisiere von Releases.

6. Claude-Protokolle (falls nötig): Mac ~/Library/Logs/Claude/, Windows %APPDATA%\Claude\logs\.

Cursor / Claude sieht Echo nicht (allgemein)

• Echo muss laufen, bevor die KI-App startet (oder starte die KI-App neu, nachdem Echo läuft).

• Klicke in Einstellungen → Verbindungen erneut auf Verbinden.

• Beende Cursor oder Claude vollständig (nicht nur das Chat-Fenster schließen), dann öffne erneut.

• Cursor: Einstellungen → MCP → aktiviere echo.

• Claude: Verwende Lokale MCP-Server, nicht „Benutzerdefinierten Connector hinzufügen“.

Claude meldet, dass Node.js fehlt

Installiere Node von https://nodejs.org und klicke dann in Echo erneut auf Verbinden, damit es den korrekten Pfad schreibt.

Mac: „Echo kann nicht geöffnet werden“ / „beschädigt“

Rechtsklick → Öffnen, oder Systemeinstellungen → Datenschutz & Sicherheit → Trotzdem öffnen. Das ist bei unsignierten Apps normal.

Mac: vom Disk-Image geöffnet

Ziehe Echo in den Programme-Ordner, wirf die .dmg aus und öffne Echo aus dem Programme-Ordner.

SmartScreen / Gatekeeper-Warnungen

Die Installationsprogramme sind unsigniert, bis ein Code-Signaturzertifikat hinzugefügt wird. Verwende die obigen Schritte – die App wird aus den GitHub Actions dieses Repositories erstellt.

Google zeigt Captcha oder Zustimmungsabfrage

Schließen Sie es im Echo-Fenster ab. Bitten Sie den Assistenten zu warten (wait_for) und es erneut zu versuchen.

Ein anderes Gerät im Wi-Fi kann keine Verbindung herstellen

Verwenden Sie die Dieses Netzwerk-URL und das Token aus den Einstellungen. Erlauben Sie Echo in der Firewall des Host-Computers für private Netzwerke. Teilen Sie das Token nicht öffentlich.

MCP-Port wird verwendet

Echo bevorzugt Port 18931 und versucht 18931–18940. Port 8931 wird vermieden (Playwright-MCP-Standard). Prüfen Sie in den Einstellungen die tatsächliche URL.

Windows-ARM-Laptop (Surface, Snapdragon)

Verwenden Sie Echo-Setup-*-arm64.exe, nicht den x64-Installer. Der x64-Build kann unter Emulation fehlschlagen, abstürzen oder sich ungewöhnlich verhalten. Versionen ab v1.0.2 enthalten einen nativen ARM64-Windows-Build. Einstellungen → System → Info → Systemtyp sollte ARM64-basierter PC anzeigen.

Was Echo einem Assistenten bietet

Bei der Verbindung sendet Echo einen Skill-Baum (wie man browst, sucht, Screenshots macht, aufzeichnet usw.), sofern Sie das nicht in Einstellungen → Übertragungen deaktivieren.

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

Suchen / Extrahieren: search_web, extract_readable

Debuggen: console_errors, network_failures

Testen: viewport_set, test_start, test_assert_text, test_assert_url, test_end

Aufzeichnen / Wiedergeben: record_start, record_stop, recordings_list, recording_play, recording_delete

Führen Sie immer snapshot vor click / type / fill aus. Refs sehen wie e0, e1 aus.

Vollständiger Leitfaden: skills/ECHO-SKILL-TREE.md

Sicherheit (lesen Sie dies)

• Alles, bei dem Sie sich in Echo anmelden, ist für einen verbundenen Assistenten sichtbar, solange MCP verbunden ist.

• MCP lauscht auf diesem Computer und in Ihrem LAN (0.0.0.0:18931 oder dem nächsten freien Port). Clients auf demselben Rechner sollten 127.0.0.1 verwenden.

• Ein Bearer-Token schützt den MCP-Server. Echo schreibt es in die Cursor/Claude-Konfiguration, wenn Sie sich verbinden. Veröffentlichen Sie das Token nicht online.

• Echo verwendet ein separates Profil von Ihrem täglichen Chrome — nicht Ihre normalen Browser-Cookies.

• Downloads: App-Datenordner → downloads/. Aufzeichnungen: recordings/.

Rechtliches

• Datenschutzrichtlinie

• Nutzungsbedingungen

• MIT-Lizenz

Auch in der App: Einstellungen → Info, Datenschutz, Nutzungsbedingungen.

Build / Release (Maintainer)

GitHub Actions (.github/workflows/release.yml) erstellt Windows-, Mac- und Linux-Installer bei v*-Tags (zum Beispiel git tag v1.0.0 && git push origin v1.0.0). Manuelles Run workflow lädt Artefakte zum Actions-Lauf hoch, erstellt aber keine Release-Seite.

Mac- und Windows-Builds sind unsigniert, sofern keine Signing-Secrets konfiguriert sind.