Browse Bridge

Cursor 向け Browse Bridge

Browse Bridge リモート MCP を Cursor に接続する Cursor プラグインです。Chrome 拡張機能で明示的に有効にしたブラウザータブを、エージェントが確認し、操作できるようにします。

• MCP： https://mcp.browsebridge.com/mcp
• サイト： https://browsebridge.com
• Chrome 拡張機能： Chrome Web Store に掲載されています
• ライセンス： MIT

前提条件

1. https://browsebridge.com/sign-up でアカウントを作成します（プラン：https://browsebridge.com/plans）。
2. Chrome Web Store から Browse Bridge Chrome 拡張機能をインストールし、同じアカウントでサインインします。
3. サインインして Connections を開き、API キー（bbk_ で始まります）を作成します。キーは秘密にしてください。
4. プラグイン／MCP に対応した Cursor。

インストール（マーケットプレイス／ローカル）

公式マーケットプレイス（掲載後）

Cursor マーケットプレイスから browse-bridge をインストールし、プロンプトが表示されたら API キーを貼り付けます（BROWSEBRIDGE_API_KEY）。

ローカルでのテスト（マーケットプレイス掲載前／非掲載時）

# Copy (do not symlink outside this folder)
cp -R /path/to/browsebridge-cursor-plugin ~/.cursor/plugins/local/browse-bridge

ウィンドウを再読み込みし、Customize を開いて BROWSEBRIDGE_API_KEY を設定し、MCP ツール（browser_observe、browser_click など）が表示されることを確認します。

mcp.json の手動設定例

{
  "mcpServers": {
    "browse-bridge": {
      "url": "https://mcp.browsebridge.com/mcp",
      "headers": {
        "Authorization": "Bearer ${BROWSEBRIDGE_API_KEY}"
      }
    }
  }
}

プラグイン変数が設定されるのはプラグイン内だけです。手動で設定する場合は、実際のキーまたは ${env:BROWSEBRIDGE_API_KEY} を使用してください。

使い方

1. 通常のウェブサイトのタブを開きます（chrome:// は対象外です）。
2. Browse Bridge のツールバーアイコンをクリックし、共有するタブで Enable をクリックします。確認メッセージと、表示される場合は Chrome の権限リクエストを承認します。いつでも Take control（または Ctrl+Shift+Period）を使ってタブの操作権を取り戻せます。
3. Cursor で browser_list_sessions、browser_observe、browser_click、browser_screenshot などの MCP ツールを使用します。
4. チャレンジが必要なサイトや機密性の高いサイトでは、エージェントが一時停止し、人による Take over または Approve を求めることがあります。

ツール（19）

ツール	機能
browser_list_sessions	有効化された共有タブを一覧表示します。
browser_get_status	操作モード、URL、deviceOnline、保留中の承認、月間残りクォータ（actionsRemaining、screenshotsRemaining、quotaExceeded、quotaResetAt）を表示します。月間クォータを使い切ると、ツールは QUOTA_EXCEEDED を返します。
browser_observe	セマンティックなページツリーと observationId／elementId を返します。
browser_screenshot	表示中のタブの JPEG を MCP 画像コンテンツとして返します。
browser_click	観察済みの要素をクリックします。省略可能な button："left"（既定値）、"right"、"middle"。
browser_type	コントロールの値を設定します（パスワードは対象外です）。
browser_select	リストにある <option> を選択します。
browser_press_key	フォーカスされている要素（または名前を指定した要素）にキーを入力します。
browser_hover	観察済みの要素に mouseover／mouseenter を発生させます。
browser_scroll	ページをスクロールするか、要素が表示領域に入るまでスクロールします。
browser_navigate	許可されている http(s) URL に移動します。
browser_back	履歴を戻ります。
browser_forward	履歴を進みます。
browser_reload	タブを再読み込みします。
browser_wait	0～30000 ms の間、一時停止します。
browser_release_control	タブの操作権を人に戻します（controlMode: "human"）。
browser_handle_dialog	保留中の JavaScript alert／confirm／prompt を承認または閉じます（action：accept|dismiss。prompt を承認する場合は promptText も指定できます）。
browser_cancel_approval	保留中のエージェント承認を取り消します（approvalId）。
get_profile	サインイン済みアカウントの Browse Bridge ユーザー ID を読み取り専用で取得します（メールアドレス、トークン、Cookie、ページコンテンツは含まれません）。

JavaScript ダイアログ

エージェントが制御している間、ページの alert／confirm／prompt は、browser_handle_dialog が実行されるか（または約30秒後にタイムアウトで閉じられるまで）保留中になります。ダイアログが開いている間にほかのクリック、入力、移動の呼び出しを行うと、DIALOG_PENDING が返されます。ネイティブの HTTP 基本認証またはダイジェスト認証のサインインプロンプトは、JavaScript ダイアログではありません（HTTP_AUTH_REQUIRED）。人間が入力を完了するか、キャンセルします。Browse Bridge はこれらの認証情報を入力しません。

承認

機密サイトでのクリック／入力／移動、およびオリジンをまたぐ移動（オリジンをまたぐリンクのクリックも含む）では、APPROVAL_REQUIRED が返されます。人間は Chrome サイドパネルで承認または拒否します。エージェントは browser_cancel_approval で自分のリクエストを取り下げることができます（APPROVAL_CANCELLED — これは人間による拒否ではありません）。承認が保留中でも、observe／screenshot／wait／get_status／list_sessions／release_control は引き続き実行できます。

設定

変数	必須	説明
BROWSEBRIDGE_API_KEY	はい	Browse Bridge ダッシュボードから取得した API キー

.cursor-plugin/plugin.json → variables で宣言され、mcp.json 内で ${BROWSEBRIDGE_API_KEY} としてのみ参照されます。

プライバシーとセキュリティ

PRIVACY.md と SECURITY.md を参照してください。

リポジトリ構成

.cursor-plugin/plugin.json
mcp.json
assets/logo.svg
README.md
LICENSE
PRIVACY.md
SECURITY.md
SUPPORT.md