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 つ目のセッションもいっしょです。
プランを見る