Scalebrowser

Scalebrowser MCP

エージェントがブロックされたり、ログイン画面で止まったり、CAPTCHAを諦めたりしていませんか？ Scalebrowserは、各AI エージェントに、ベンダーのクラウドではなくお使いのマシン上で動作する、永続的なIDを持つ独立したブラウザーを提供します。ログイン状態を維持し、CAPTCHAに対応し、人間のように入力します。いつでも操作を引き継げます。

このリポジトリは、そのブラウザーをMCP経由でエージェントに接続します。ドキュメントで扱うすべてのクライアント用のコピー＆ペースト可能な設定、小規模なstdioブリッジ、実行可能なSDKのサンプルが含まれています。

始める前に

• Windows 10または11（64ビット）、実GPU搭載。 Scalebrowserはお使いのマシンで動作するデスクトップアプリです。ホステッドモードはありません。
• 有効なプランがあるScalebrowserアカウント。 7日間のトライアルでは、ブラウザーを1つ利用できます。事前にお支払い方法の登録が必要です。プランと料金

無料、アカウント不要： scalebrowser.net/checkでは、現在のブラウザーが外部からどのように見えるかを測定できます。また、scalebrowser.net/ai-agent-checkでは、お使いの自動化ツールがどのように動作するかを測定できます。エージェントに後者を開かせて、ウェブサイトから何が分かるか確認してみてください。

5分で試す

1. scalebrowser.netにサインインし、Downloadを開いてインストーラーを実行します。現在のユーザー用にインストールされ、管理者権限は必要ありません。初回起動時にSmartScreenの警告が表示された場合は、More infoを選んでからRun anywayを選択してください。

2. アプリを起動し、Sign inを押します。続いてアプリがブラウザーエンジンをダウンロードして検証します。プロファイルを起動する前に、これを完了する必要があります。

3. Settings, General, Connect an agentからAPIトークンをコピーします。

4. エージェントを接続します。Claude Codeなら、次のコマンドを実行するだけです。

   claude mcp add --transport http scalebrowser http://127.0.0.1:8787/v1/mcp \
     --header "Authorization: Bearer $SCALEBROWSER_TOKEN"
   

5. エージェントに次のように頼みます。

   Scalebrowserのプロファイルでnews.ycombinator.comを開き、トップページを読んで、コメント数が最も多い記事を3つ教えてください。

エージェントはリースを取得してプロファイルを確保し、ブラウザーを起動してページを開きます。ページのテキストマップを読み取り、回答します。その後、プロファイルを解放するように頼んでください。

クライアントを接続する

以下の各ファイルは、公式ドキュメントの設定をすぐにコピーして使えるようにしたものです。<token>をAPIトークンに、<you>をWindowsのユーザー名に置き換えてください。各ファイルの配置場所と、エラーなしで失敗する2つの表記については、clients/README.mdをご覧ください。

クライアント	設定
Claude Code	claude-code.mcp.json、上記のコマンド、またはプラグイン
Claudeデスクトップアプリ	claude-desktop.json
Cursor	cursor.mcp.json
Codex	codex.config.toml
VS CodeのGitHub Copilot	github-copilot.mcp.json
Antigravity	antigravity.mcp_config.json
WSL内のClaude Code	wsl-claude-code.json
ウェブ版Claude、Grok、ChatGPT、その他のクラウドチャットサービス	ファイルは不要です。リモートアクセス経由でお使いのマシンに接続します

エージェントができること

エージェントはページのテキストマップを使い、参照によって要素を指定します。ページを一度確認し、その後は変更された部分だけを確認します。同じページで75ステップを超えて操作する場合、Playwright MCP と比べてモデルのトークン消費を11分の1に抑えられます。

• サインイン： credential_fill はプロファイルに保存されたログイン情報でサインインし、credential_new は Scalebrowser が生成して保存したパスワードでアカウントを作成します。エージェントがパスワードの値を見ることはありません。
• 確認コード： read_inbox はプロファイルに紐づけられたアドレスに届いたコードを読み取り、inbox_open_link はメッセージ内のリンクを開きます。
• チャレンジ： press_and_hold、click、4つの計測ツールは、同じ人間の入力で認証チャレンジに対応します。チャレンジの種類ごとの計測結果では、何が通過し、何が通過しないかを確認できます。
• 作業の証跡： record と video は実行内容を動画に変換し、すべてのツール呼び出しが実行履歴のステップになります。

全ツールの一覧はツールリファレンスにあります。エージェントが実行できる操作は、クライアントではなくアプリによって決まります。

ブリッジ

bridge/scalebrowser-mcp.mjs は、依存関係のない stdio MCP サーバーです。同じ Windows マシンで Scalebrowser アプリを実行すると、アプリが %LOCALAPPDATA%\Scalebrowser に保存しているアドレスとトークンを使って、すべてのメッセージをアプリ独自の MCP エンドポイントに中継します。アプリがない場合は、ツール一覧とインストール手順を返します。MCP ディレクトリがこのリポジトリを構築するときに使用するのは、後者のモードです。

HTTP に対応するクライアントでは、このブリッジは不要です。上記の設定を使用してください。stdio 経由でしかサーバーを起動できないクライアントの場合は、npm から実行します。

npx -y @scalebrowser/mcp

または、このリポジトリをクローンして実行します。

node bridge/scalebrowser-mcp.mjs

Node 22 以降が必要です。--data-dir で別のデータディレクトリを指定でき、SCALEBROWSER_TOKEN でトークンファイルを上書きできます。

Claude デスクトップ拡張機能として

各リリースには、MCP Bundle としてブリッジ scalebrowser-<version>.mcpb が含まれています。アプリを実行する Windows マシンでダウンロードして Claude デスクトップアプリで開くか、そこで Settings, Extensions, Install Extension を選択してください。設定は不要です。アプリとそのトークンを自動的に検出します。

このブリッジは、MCP Registry に net.scalebrowser/mcp としても掲載されています。

Claude Code プラグインとして

このリポジトリは Claude Code プラグインでもあります。アプリを実行する Windows マシン上の Claude Code で、次のように実行します。

/plugin marketplace add blackdiamond-labs/scalebrowser-mcp
/plugin install scalebrowser@scalebrowser

プラグインがブリッジを起動するため、Node 22 以降が必要ですが、トークンをファイルに保存する必要はありません。また、リース、読み取り、操作、解放のループや、失敗した操作を繰り返す前に状況を確認すること、パスワードを尋ねる代わりに保存済みのログイン情報でサインインすることをエージェントに教えるスキルも追加されます。

SDK の例

どちらの SDK でも、同じ簡単なタスクを実行します。プロファイルで Hacker News を開き、上位3件の記事を出力します。アプリを実行する Windows マシンで、SCALEBROWSER_TOKEN にトークンを設定して実行してください。

cd examples/node
npm ci
node top-stories.mjs

cd examples/python
pip install --require-hashes -r requirements.txt
python top_stories.py

どちらも公開済みの SDK を使用します。npm の @scalebrowser/sdk と、PyPI の scalebrowser です。SDK ドキュメントでは、機能の全容を説明しています。

プライバシーポリシー

このブリッジは、情報を収集、保存、または当社や第三者に送信することはありません。

• 読み取る情報： お使いのマシンのデータディレクトリ（--data-dir を指定しない場合は %LOCALAPPDATA%\Scalebrowser）に Scalebrowser アプリが保存しているアドレスと API トークンです。
• メッセージの送信先： 同じマシン上の Scalebrowser アプリのみです。このマシン自身のループバックアドレス以外は拒否するため、トークンやエージェントのメッセージがブリッジを経由してコンピューターの外に送信されることはありません。
• 保持する情報： 何もありません。アプリとのセッションはメモリ上に保持し、クライアントが切断すると終了します。ファイルは一切書き込まず、標準エラーに出力するステータス行以外のログも記録しません。
• 第三者： ありません。ブリッジには依存関係もテレメトリーもなく、アプリへのループバック接続以外のネットワークアクセスもありません。

Scalebrowser アプリ自体、アカウント、ウェブサイトについては、Scalebrowser のプライバシーポリシーが適用されます。プライバシーに関するお問い合わせは [email protected] までご連絡ください。

ご質問とサポート

[email protected] までご連絡ください。このリポジトリではイシューを無効にしています。理由については CONTRIBUTING.md をご覧ください。

リンク

• ウェブサイト
• ドキュメントとクイックスタート
• 料金

ライセンス

このリポジトリの内容はすべて MIT ライセンスです。Scalebrowser アプリとそのブラウザーエンジンは、別個のライセンス製品です。