Zynlex logo

Zynlex

A Windows browser and MCP server for testing localhost or approved staging apps through an agent-visible, shared session.

Install Zynlex

Run the project’s own setup commands, in order.

Setup steps from the project

Zynlex installs with its own commands rather than a config we can generate, so these are copied as-is. Run them in order in a terminal. Source: github.com

  1. 1. Add to Claude Code
    claude mcp add zynlex zynlex-mcp
    
  2. 2. Install
    pnpm install
    

Overview

Zynlex MCP server lets Claude Code, Codex, and other MCP clients inspect and operate the web app open in its Windows browser. Agents can read page structure, perform multi-step interactions, inspect console and network activity, capture screenshots, emulate mobile viewports, and wait for UI changes. Developers can flag elements, record reproduction steps, pause agent activity, and continue using an already authenticated session. Reach for Zynlex when an agent needs to debug a local or permitted staging app interactively in the browser you are already using.

Use cases

  • Debug a localhost application with an AI coding agent
  • Flag a broken UI element and attach reproduction notes
  • Record a browser bug and generate a Playwright test
  • Inspect console errors and failed network requests
  • Test responsive behavior with phone or tablet emulation

Key features

  • Shared visible browser session
  • Element snapshots with action references
  • Multi-step browser interactions
  • Console and network diagnostics
  • Request mocking and custom headers
  • Recorded steps converted to Playwright tests

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars8Stargazers on the source repository.
Last commitTodayMost recent push to the default branch.

How Zynlex works

What Zynlex does

Zynlex combines a Windows developer browser with an MCP server so an AI coding agent can work in the same visible page as the developer. The agent connects to the Zynlex window rather than launching an isolated browser session. This lets it use the page’s existing login state, observe the same UI, and act on local application bugs while the developer watches.

The primary targets are applications running on localhost and staging environments explicitly enabled for agent access. Production access is blocked. Zynlex also retains browser errors and failed requests, including activity that occurred before the agent connected, so the agent can begin with relevant debugging context.

Developers can press Ctrl+Shift+E to flag an element and attach a note. The agent receives the note and the element reference. A recording mode captures clicks and keyboard actions along with errors or failed requests caused by those actions. Recordings can be converted into Playwright tests for later CI coverage.

How it works

Install the Windows application, open the target app in Zynlex, and connect an MCP client to the zynlex-mcp command. The agent can list available tabs and local development servers, then open or switch to a page. It uses element references from a page snapshot to perform actions.

Each interaction reports page changes and newly observed errors or failed requests. The check operation waits for the page to settle and returns new diagnostic information. The developer can watch actions in the Agent Activity panel, pause the agent to use the page manually, resume it with the intervening changes reported, or stop the connection.

Page text, console messages, and response bodies are passed to the agent as data rather than instructions. Mocks and added request headers are visible in the browser panels as well as to the agent.

Setup and configuration

  1. Download and run the Windows installer from the project’s release page. It adds zynlex-mcp to the system PATH.

  2. Register the server with an MCP client. For Claude Code, use:

    Terminal
    claude mcp add zynlex zynlex-mcp
    
  3. Open the application under test in Zynlex and ask the connected agent to inspect or fix it.

The Zynlex Settings area includes an AI agents section with connection snippets for Codex, Cursor, Antigravity, OpenCode, and other MCP clients. In Settings → Environments, staging targets must be explicitly marked for agent access.

Tools and capabilities

  • tabs and open list tabs and development servers, then open or switch pages.
  • snapshot returns interactive page elements and references.
  • act clicks, types, selects, presses keys, hovers, drags, uploads files, navigates back, and answers dialogs. One call can contain up to 10 steps.
  • check, errors, and network expose page stability, console output, failed requests, request headers, and response bodies.
  • screenshot captures the viewport, a selected element, or the whole page.
  • viewport emulates phone or tablet dimensions with touch input.
  • wait_for waits for text to appear or disappear, or for the URL to change.
  • mock supplies fake API responses or request headers.
  • eval runs JavaScript in the page.
  • recording retrieves captured steps or a Playwright test generated from them.

Limitations and notes

Zynlex is Windows-only and supports Windows 10 and 11. Its agent-accessible targets are localhost and staging environments enabled in Settings; production is not allowed. It is intended for interactive browser work rather than headless execution, CI runs, Firefox, or WebKit. Playwright remains the option for running the generated regression tests in CI.

The agent operates with the session already open in Zynlex, so the developer’s visible authentication state can be used without putting passwords into prompts. Developers can take control at any time by pausing or stopping agent activity.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Zynlex

Zynlex is an MCP server that connects AI coding agents to its Windows browser and the localhost or approved staging app open there. Its main tools inspect page elements, perform browser actions, check console and network issues, capture screenshots, emulate mobile viewports, mock requests, and retrieve recordings or Playwright tests.

Install the Windows application, which places `zynlex-mcp` on your PATH, then register that command with your MCP client. In Claude Code, run `claude mcp add zynlex zynlex-mcp`; other connection snippets are available under Settings → AI agents.

Yes, Zynlex includes a Cursor connection snippet in Settings → AI agents. After installing the Windows application, configure Cursor with the `zynlex-mcp` command and open the target localhost or permitted staging app in Zynlex.

No, Zynlex blocks production access. Agents can work with localhost and staging environments that a developer explicitly enables with the agent setting under Settings → Environments.

Yes, its recording capability can turn captured browser steps into a Playwright test. The generated test can then be used for CI, while Zynlex remains focused on interactive debugging in the shared browser.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewZynlex AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/zynlex?style=directory)](https://allmcps.com/mcp/zynlex)
HTML Embed
<a href="https://allmcps.com/mcp/zynlex"><img src="https://allmcps.com/api/badge/zynlex?style=directory" alt="Zynlex on AllMCPs" /></a>