MCP で AI アシスタントをつなぐ

Browser.lol はホスト型の MCP サーバーを提供しており、AI アシスタントに当社クラウドの実物のブラウザを渡せます。このガイドでは、キー、クライアントの設定、アシスタントが使えるツール、そしてセッションの挙動を扱います。

MCP (Model Context Protocol) は、アシスタントが標準では備えていないツールに手を伸ばすための仕組みです。Browser.lol に向ければ、隔離されたクラウドブラウザで、選んだ出口ロケーションから、ページを開き、読み取り、クリックし、入力し、フォームを埋め、ファイルをアップロードし、JavaScript を実行し、スクリーンショットを撮れます。

お手元のマシンでは何も動きません。インストールするローカルブラウザも、更新し続けるドライバーも、ここで設定するモデルのキーもありません。当社がブラウザ、セッションのライフサイクル、通信の出口、そしていつでも開いて操作を引き取れるライブビューを用意します。モデルはお使いのクライアント側のままです。

必要なもの

エンドポイント
https://api.browser.lol/mcp
トランスポート
Streamable HTTP、リクエストごとにステートレス
認証
リクエストヘッダーに入れる Browser.lol の API キー
プラン
プログラムからのアクセスを備えた Premium
ブラウザ
ご利用のプランで使える Chromium 系のイメージ (既定は Chrome)

API キーを発行する

アシスタントを認証するのはこのキーで、その背後にあるプランとアカウントを引き継ぎます。ダッシュボードで発行してください。表示は一度きりなので、そのままクライアントにコピーしてください。

API キーのページへ

クライアント・マシン・パイプラインごとに 1 つのキーをお使いください。キーを削除すると、そのクライアントだけが即座に止まり、ほかには何も影響しません。会話の途中でも同じです。

クライアントにサーバーを追加する

お使いのクライアントを選び、設定を入れて、YOUR_API_KEY を先ほど発行したキーに置き換えてください。同じキーがどこでも使えるので、2 台目のマシンではこの手順だけで済みます。

Claude Code

ターミナルで実行してください。

claude mcp add --transport http browserlol https://api.browser.lol/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

claude_desktop_config.json に記述します。

{
  "mcpServers": {
    "browserlol": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://api.browser.lol/mcp",
        "--header", "Authorization:Bearer YOUR_API_KEY"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json に記述します。

{
  "mcpServers": {
    "browserlol": {
      "url": "https://api.browser.lol/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Any other client

HTTP 経由で MCP を話し、リクエストヘッダーを設定できるクライアントならどれでも使えます。

{
  "mcpServers": {
    "browserlol": {
      "type": "http",
      "url": "https://api.browser.lol/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

そのあとクライアントを再起動して、新しいサーバーを読み込ませてください。ほかにインストールするものはありません。ブラウザは当社側にあります。

何か頼んでみる

ブラウザが必要な作業をアシスタントに頼んでみてください。セッションはアシスタント自身が開きます:

Browser.lol のブラウザで example.com を開いて、ページに何が書いてあるか教えてください。

アシスタントが使えるツール

ツールはすべて browser_* という名前で、構造化された結果を返します。アシスタントは browser_navigate からそのまま始められます。セッションが開き、アクセシビリティスナップショットが返ってきます。ほかのツールはすべて、そのスナップショットの ref ID に対して動作します。スクリーンショットから読み取るより負荷が小さく、はるかに正確です。

セッションとライフサイクル

ブラウザを起動し、動いているものを一覧し、閉じ、再起動せずに通信の出口を変更します。

  • browser_session_create
  • browser_session_get
  • browser_session_list
  • browser_session_rename
  • browser_session_close
  • browser_set_location

ナビゲーション

URL を開き、戻り、再読み込みし、複数のタブで作業します。

  • browser_navigate
  • browser_go_back
  • browser_go_forward
  • browser_reload
  • browser_tabs

ページを読む

操作系ツールが対象とするアクセシビリティスナップショット、テキスト検索、スクリーンショット、コンソール出力、ページが送ったリクエスト。

  • browser_snapshot
  • browser_find
  • browser_screenshot
  • browser_console_messages
  • browser_network_requests
  • browser_network_request

操作

クリック、入力、フォーム全体の記入、選択肢の選択、キー操作、JavaScript の実行。どのツールも、指示されたとおりのことだけを行います。サーバーがモデルに問い合わせることはないため、判断はお使いのアシスタントの側に残ります。

  • browser_click
  • browser_type
  • browser_fill_form
  • browser_select_option
  • browser_hover
  • browser_drag
  • browser_press_key
  • browser_scroll
  • browser_wait_for
  • browser_handle_dialog
  • browser_evaluate
  • browser_resize
  • browser_mouse

ファイル

ファイル入力欄にファイルを渡し、セッションがダウンロードしたものを受け取ります。

  • browser_file_upload
  • browser_downloads

セッションの挙動

  • セッションは自動で作成されます。 キーで動いているセッションがないとき、最初のページ操作ツールがセッションを開きます。複数が動いている場合、セッション ID のない呼び出しは推測されずに拒否されます。
  • セッションは自動で終了します。 操作するものがなくなるとセッションは自分で終了し、いずれにしても最長の稼働時間に達すると終了します。自分で閉じれば、その枠はすぐに空きます。
  • 人とエージェントは 1 つのアカウントを共有します。 アプリで開始したセッションをアシスタントが一覧・操作・終了でき、アシスタントが開いたセッションも同じように扱えます。
  • 届く範囲はアカウントの中までです。 どのツールもご自身のセッションだけを対象にします。ほかの人のセッションは、このサーバーからは見えず、届きません。
  • プログラムからのアクセスはプランの機能です。 Premium がない場合、どの呼び出しもツールの結果ではなくアップグレードのご案内を返します。

セキュリティ

  • API キーは認証情報です。クライアントのシークレットストアか環境変数に保管し、共有の設定ファイルやリンクには決して置かず、外に漏れた瞬間に削除してください。
  • キーはリクエストヘッダーで送られます。URL には入れないでください。ブラウザの履歴、プロキシのログ、アクセス解析に残ってしまいます。
  • ページが読み込まれるのは当社のインフラ上だけです。アシスタントが動いているマシンでも、お使いのブラウザプロフィールでもありません。どのセッションも使い捨てのコンテナです。
  • エージェントのセッションも、ご自身のセッションと同じように見えます。動いている様子をそのまま見られ、いつでも手動で終了できます。

つないでみますか?

MCP アクセスは、近日提供予定の Premium に含まれます。保存したプロフィール、より大きなレジデンシャルデータ枠、2 つ目のセッションもいっしょです。

プランを見る