Permite que los clientes de IA utilicen el runtime de navegador OpenAI Codex en macOS para controlar perfiles de Chrome o Helium con sesión iniciada a través de un REPL de Node.js.
También conocido como stickerdaniel/browserjack
- Stars
- 5
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 9 nov 2026
- Licencia
- MIT
¿Qué es Browserjack MCP?
Browserjack es un MCP server. Permite que los clientes de IA utilicen el runtime de navegador OpenAI Codex en macOS para controlar perfiles de Chrome o Helium con sesión iniciada a través de un REPL de Node.js.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Browserjack
Browserjack proporciona un puente para que clientes MCP como Claude Code accedan al runtime de navegador OpenAI Codex en macOS. Permite que un agente de IA controle perfiles existentes de Chrome o Helium con sesión iniciada mediante un REPL de Node.js persistente. Esta configuración utiliza el stack nativo de OpenAI que ya está instalado a través de la ChatGPT.app en hardware con Apple Silicon, lo que significa que no requiere instalar extensiones de navegador por separado ni usar Playwright.
Los usuarios deben tener macOS, Node.js 22 o superior, y la ChatGPT.app oficial con la extensión Codex configurada. El servidor actúa como un proxy stdio ligero que lanza el sandbox de codex firmado por OpenAI. Debido a que utiliza un REPL en lugar de una lista fija de herramientas, el agente obtiene capacidades más amplias mediante el uso de la computadora en macOS. Está diseñado para desarrolladores que desean utilizar sus sesiones web reales con sesión iniciada sin necesidad de un plan de Anthropic para la integración del navegador.
Qué puedes hacer con él
- 1Acceder a sesiones web con sesión iniciadaUn agente de IA puede interactuar con sitios web utilizando tus perfiles existentes de Chrome o Helium.
- 2Ejecutar comandos de navegador arbitrariosUn desarrollador puede asignar a una IA la realización de acciones web complejas utilizando un REPL de Node.js en lugar de herramientas limitadas.
- 3Verificar la conectividad del navegadorPuedes ejecutar un comando de diagnóstico para asegurar que el handshake entre el cliente MCP y el navegador esté funcionando.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Browserjack MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Browserjack MCP en Claude Code
$ claude mcp add browserjack -- npx -y browserjackInstalar Browserjack MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"browserjack": {
"command": "npx",
"args": [
"-y",
"browserjack"
]
}
}
}Instalar Browserjack MCP en VS Code
.vscode/mcp.json
{
"servers": {
"browserjack": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"browserjack"
]
}
}
}Instalar Browserjack MCP en VS Code CLI
$ code --add-mcp '{"name":"browserjack","type":"stdio","command":"npx","args":["-y","browserjack"]}'Instalar Browserjack MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"browserjack": {
"command": "npx",
"args": [
"-y",
"browserjack"
]
}
}
}Instalar Browserjack MCP en Codex
$ codex mcp add browserjack -- npx -y browserjackInstalar Browserjack MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.browserjack] command = "npx" args = ["-y", "browserjack"]
Instalar Browserjack MCP en Gemini CLI
$ gemini mcp add -s user browserjack npx -- -y browserjackInstalar Browserjack MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"browserjack": {
"command": "npx",
"args": [
"-y",
"browserjack"
]
}
}
}Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblestickerdaniel/browserjack is public and reachablegithub.com/stickerdaniel/browserjack ↗Aprobado
- El paquete indica este repositorio como su origenbrowserjack names stickerdaniel/browserjack as sourcenpmjs.com/package/browserjack ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)Sigstore attestation for browserjacknpmjs.com/package/browserjack/v/0.4.1#provenance ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-09github.com/stickerdaniel/browserjack ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from browserjackAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubBrowserjack: OpenAI Codex browser bridge for MCP
Browserjack lets Claude Code and other MCP clients use the browser runtime that ChatGPT.app already installed on your Mac. Your agent gets a persistent Node.js REPL that drives your real, signed-in Chrome or Helium profile. Browserjack injects nothing into the browser and installs no extension of its own.
[!NOTE] Your agent acts in your logged-in browser sessions. The OpenAI interfaces it uses are undocumented, and any ChatGPT.app update can break them.
Requirements
- macOS on Apple Silicon with Node.js 22 or newer
- The official ChatGPT.app with the ChatGPT/Codex extension set up in Chrome or Helium
- Claude Code or another stdio MCP client
Quickstart
npx browserjack setup --client claude --scope user
npx browserjack doctor --live
setup installs a versioned runtime in ~/Library/Application Support/browserjack/ and registers a stable shim with Claude Code, so later changes to the npx cache cannot change what Claude Code runs. doctor --live tests the browser handshake end to end.
Restart Claude Code and ask:
Use the browserjack MCP server to open https://example.com and return the page title.
Claude should answer Example Domain. If it doesn't, run npx browserjack doctor and see docs/troubleshooting.md.
How it works
Browserjack is a thin launcher and stdio proxy. It starts the OpenAI-signed codex sandbox, which runs OpenAI's own node_repl, and passes MCP messages between that runtime and your client. Every browser feature comes from the runtime. Browserjack has no Playwright, CDP, or navigation code and does not modify or redistribute OpenAI software.
Compared with Playwright MCP, Browser MCP, or Claude Code's Chrome integration, Browserjack reuses the OpenAI stack already on your Mac, gives the agent a REPL with macOS computer use instead of a fixed tool list, works with any stdio MCP client, and needs no Anthropic plan. In exchange it runs only on macOS and needs upkeep for new ChatGPT.app builds. If you have a direct Anthropic plan, the Chrome integration is the supported cross-platform choice.
Commands
browserjack run Start the stdio MCP server (Claude Code calls this)
browserjack doctor Check ChatGPT.app, signatures, runtime, compatibility
--json Machine-readable report
--live Also cold-start the runtime and test the handshake
browserjack status Show version, shim, current link, and Node path
browserjack setup Install the runtime and register the MCP server
--client claude (direct MCP) or plugin (runtime only)
--scope user | local | project
--mcp-name NAME MCP server name (default: browserjack)
browserjack update Reinstall this version with the recorded MCP identity
browserjack uninstall Remove the installation and its MCP entry
--keep-state Keep releases and state
doctor and status exit with 2 when a check fails and 1 on an unexpected error.
Compatibility
When a ChatGPT.app build is new to Browserjack, its first start runs a self-test with a real browser handshake. A build that passes starts instantly from then on. A build that fails does not start, and the next start tests it again. If a new build misbehaves in a way the self-test misses, open a compatibility issue with your doctor --json output and remove your username from the paths.
Security and privacy
Each launch runs the checks in the diagram. The sandbox lets the runtime write only to CODEX_HOME and temp directories. Browserjack has no telemetry, reads only OpenAI's public app update feed, and logs no browser content, cookies, tokens, or form data. Whatever the MCP client requests does enter that client's conversation. Details are in docs/security.md and docs/privacy.md. Report vulnerabilities as described in SECURITY.md.
FAQ
Why only macOS? Browserjack needs the runtime and code-signed native hosts that ship with ChatGPT.app for macOS. Windows and Linux have no local runtime to reuse.
Is this supported by OpenAI? No. Browserjack is not affiliated with or endorsed by OpenAI or Anthropic.
Is "browserjack" a hijacker? No. The name means jack as in connector. It only connects components you installed yourself.
Contributing
Run npm install && npm run verify, then read CONTRIBUTING.md.
MIT for this project's original code. OpenAI components remain under their own terms and licenses.
Preguntas sobre Browserjack MCP
¿Cómo agrego Browserjack MCP a Claude Code?
Ejecuta claude mcp add browserjack -- npx -y browserjack en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Browserjack MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Por qué Browserjack solo funciona en macOS?
Requiere el runtime específico y los hosts nativos con firma de código que se incluyen en la versión de macOS de ChatGPT.app.
¿Es este un producto oficial de OpenAI?
No, Browserjack no está afiliado ni respaldado por OpenAI o Anthropic.
¿Browserjack secuestra mi navegador?
No, el nombre se refiere a actuar como un conector para componentes que tú mismo ya has instalado.