Permet aux clients IA d'utiliser le runtime de navigateur OpenAI Codex sur macOS pour piloter des profils Chrome ou Helium connectés via un REPL Node.js.
Aussi connu sous stickerdaniel/browserjack
- Étoiles
- 5
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 9 nov. 2026
- Licence
- MIT
Qu'est-ce que Browserjack MCP ?
Browserjack est un serveur MCP. Permet aux clients IA d'utiliser le runtime de navigateur OpenAI Codex sur macOS pour piloter des profils Chrome ou Helium connectés via un REPL Node.js.
Résumé généré à partir du README du projet
À propos du MCP server Browserjack
Browserjack fournit une passerelle permettant aux clients MCP comme Claude Code d'accéder au runtime de navigateur OpenAI Codex sur macOS. Il permet à un agent IA de piloter des profils Chrome ou Helium existants et connectés via un REPL Node.js persistant. Cette configuration utilise la pile native d'OpenAI déjà installée via l'application ChatGPT.app sur le matériel Apple Silicon, ce qui signifie qu'il n'est pas nécessaire d'installer des extensions de navigateur séparées ou d'utiliser Playwright.
Les utilisateurs doivent disposer de macOS, de Node.js 22 ou d'une version ultérieure, et de l'application officielle ChatGPT.app avec l'extension Codex configurée. Le serveur agit comme un proxy stdio léger qui lance le sandbox codex signé par OpenAI. Comme il utilise un REPL plutôt qu'une liste fixe d'outils, l'agent bénéficie de capacités plus étendues grâce à l'utilisation de l'ordinateur via macOS. Il est conçu pour les développeurs qui souhaitent utiliser leurs sessions web réelles sans avoir besoin d'un forfait Anthropic pour l'intégration du navigateur.
Ce que vous pouvez faire avec
- 1Accéder à des sessions web connectéesUn agent IA peut interagir avec des sites web en utilisant vos profils Chrome ou Helium existants.
- 2Exécuter des commandes de navigateur arbitrairesUn développeur peut confier à une IA la réalisation d'actions web complexes en utilisant un REPL Node.js plutôt que des outils limités.
- 3Vérifier la connectivité du navigateurVous pouvez exécuter une commande de diagnostic pour vous assurer que la liaison entre le client MCP et le navigateur fonctionne correctement.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Browserjack MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Browserjack MCP dans Claude Code
$ claude mcp add browserjack -- npx -y browserjackInstaller Browserjack MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"browserjack": {
"command": "npx",
"args": [
"-y",
"browserjack"
]
}
}
}Installer Browserjack MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"browserjack": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"browserjack"
]
}
}
}Installer Browserjack MCP dans VS Code CLI
$ code --add-mcp '{"name":"browserjack","type":"stdio","command":"npx","args":["-y","browserjack"]}'Installer Browserjack MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"browserjack": {
"command": "npx",
"args": [
"-y",
"browserjack"
]
}
}
}Installer Browserjack MCP dans Codex
$ codex mcp add browserjack -- npx -y browserjackInstaller Browserjack MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.browserjack] command = "npx" args = ["-y", "browserjack"]
Installer Browserjack MCP dans Gemini CLI
$ gemini mcp add -s user browserjack npx -- -y browserjackInstaller Browserjack MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"browserjack": {
"command": "npx",
"args": [
"-y",
"browserjack"
]
}
}
}Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblestickerdaniel/browserjack is public and reachablegithub.com/stickerdaniel/browserjack ↗Réussi
- Le nom du package correspond au dépôt sourcebrowserjack names stickerdaniel/browserjack as sourcenpmjs.com/package/browserjack ↗Réussi
- Provenance du build (attestation Sigstore)Sigstore attestation for browserjacknpmjs.com/package/browserjack/v/0.4.1#provenance ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-09github.com/stickerdaniel/browserjack ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from browserjackRéussi
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur 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.
Questions sur Browserjack MCP
Comment ajouter Browserjack MCP à Claude Code ?
Exécutez claude mcp add browserjack -- npx -y browserjack dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Browserjack MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Pourquoi Browserjack ne fonctionne-t-il que sur macOS ?
Il nécessite le runtime spécifique et les hôtes natifs signés qui sont inclus dans la version macOS de ChatGPT.app.
S'agit-il d'un produit officiel d'OpenAI ?
Non, Browserjack n'est pas affilié à OpenAI ou Anthropic et n'est pas approuvé par eux.
Est-ce que Browserjack détourne mon navigateur ?
Non, le nom fait référence au rôle de connecteur pour des composants que vous avez déjà installés vous-même.