macOS上のOpenAI CodexブラウザランタイムをAIクライアントから利用可能にし、Node.js REPLを介してログイン済みのChromeまたはHeliumプロファイルを実行します。
別名 stickerdaniel/browserjack
- スター
- 5
- ツール
- —
- ダウンロード数（30日間）
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月9日
- ライセンス
- MIT
Browserjack MCPとは
BrowserjackはMCPサーバーです。 macOS上のOpenAI CodexブラウザランタイムをAIクライアントから利用可能にし、Node.js REPLを介してログイン済みのChromeまたはHeliumプロファイルを実行します。.
プロジェクトのREADMEから生成された概要
Browserjack MCP server について
Browserjackは、Claude CodeなどのMCPクライアントがmacOS上のOpenAI Codexブラウザランタイムにアクセスするためのブリッジを提供します。これにより、AIエージェントは永続的なNode.js REPLを通じて、既存のログイン済みChromeまたはHeliumプロファイルを操作できます。この構成は、Apple Siliconハードウェア上のChatGPT.app経由ですでにインストールされているネイティブなOpenAIスタックを使用するため、個別のブラウザ拡張機能のインストールやPlaywrightの使用は必要ありません。
利用には、macOS、Node.js 22以降、およびCodex拡張機能が設定された公式のChatGPT.appが必要です。このサーバーは、OpenAI署名済みのcodexサンドボックスを起動する軽量なstdioプロキシとして機能します。固定されたツールリストではなくREPLを使用するため、エージェントはmacOSのcomputer useを通じてより広範な機能を得ることができます。これは、ブラウザ統合のためにAnthropicのプランを必要とせず、実際のログイン済みウェブセッションを使用したい開発者向けに設計されています。
できること
- 1ログイン済みウェブセッションへのアクセスAIエージェントが、既存のChromeまたはHeliumプロファイルを使用してウェブサイトとやり取りできます。
- 2任意のブラウザコマンドの実行開発者は、制限されたツールではなくNode.js REPLを使用することで、AIに複雑なウェブ操作を実行させることができます。
- 3ブラウザ接続の検証診断コマンドを実行して、MCPクライアントとブラウザ間のハンドシェイクが正常に動作しているか確認できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Browserjack MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにBrowserjack MCPをインストール
$ claude mcp add browserjack -- npx -y browserjackCursorにBrowserjack MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"browserjack": {
"command": "npx",
"args": [
"-y",
"browserjack"
]
}
}
}VS CodeにBrowserjack MCPをインストール
.vscode/mcp.json
{
"servers": {
"browserjack": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"browserjack"
]
}
}
}VS Code CLIにBrowserjack MCPをインストール
$ code --add-mcp '{"name":"browserjack","type":"stdio","command":"npx","args":["-y","browserjack"]}'Claude DesktopにBrowserjack MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"browserjack": {
"command": "npx",
"args": [
"-y",
"browserjack"
]
}
}
}CodexにBrowserjack MCPをインストール
$ codex mcp add browserjack -- npx -y browserjackCodex config.tomlにBrowserjack MCPをインストール
~/.codex/config.toml
[mcp_servers.browserjack] command = "npx" args = ["-y", "browserjack"]
Gemini CLIにBrowserjack MCPをインストール
$ gemini mcp add -s user browserjack npx -- -y browserjackGemini settings.jsonにBrowserjack MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"browserjack": {
"command": "npx",
"args": [
"-y",
"browserjack"
]
}
}
}自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能stickerdaniel/browserjack is public and reachablegithub.com/stickerdaniel/browserjack ↗合格
- パッケージがこのリポジトリをソースとして指定browserjack names stickerdaniel/browserjack as sourcenpmjs.com/package/browserjack ↗合格
- ビルドの来歴 (Sigstore 証明)Sigstore attestation for browserjacknpmjs.com/package/browserjack/v/0.4.1#provenance ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-09github.com/stickerdaniel/browserjack ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from browserjack合格
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るBrowserjack: 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.
Browserjack MCPのよくある質問
Browserjack MCPをClaude Codeに追加するには
ターミナルでclaude mcp add browserjack -- npx -y browserjackを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Browserjack MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
なぜBrowserjackはmacOSでのみ動作するのですか？
ChatGPT.appのmacOS版に含まれている特定のランタイムと、コード署名されたネイティブホストを必要とするためです。
これはOpenAIの公式製品ですか？
いいえ、BrowserjackはOpenAIまたはAnthropicの提携や承認を受けたものではありません。
Browserjackはブラウザを乗っ取るのですか？
いいえ、この名称は、ユーザー自身が既にインストールしているコンポーネントのコネクターとして機能することを指しています。