English Français العربية

Browse Bridge

السجل الرسمي الذكاء الاصطناعي والوكلاء

Let AI agents observe and control Chrome tabs you explicitly share via Browse Bridge.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http browse-bridge 'https://mcp.browsebridge.com/mcp' --header 'Authorization: <Bearer token: your Browse Bridge API key (bbk_...) from https://browsebridge.com/dashboard/connections>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "browse-bridge": {
            "type": "http",
            "url": "https://mcp.browsebridge.com/mcp",
            "headers": {
                "Authorization": "<Bearer token: your Browse Bridge API key (bbk_...) from https://browsebridge.com/dashboard/connections>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Browse Bridge for Cursor
  2. Prerequisites
  3. Install (Marketplace / local)
  4. Usage
  5. Tools (17)
  6. Configuration
  7. Privacy & security
  8. Repo layout

Browse Bridge for Cursor

Cursor Plugin that wires Browse Bridge remote MCP into Cursor so agents can observe and control browser tabs you have Explicitly Enabled in the Chrome extension.

Prerequisites

  1. Create an account at https://browsebridge.com/sign-up (plans: https://browsebridge.com/plans).
  2. Install the Browse Bridge Chrome extension from the Chrome Web Store and sign in with the same account.
  3. Sign in and open Connections to create an API key (starts with bbk_). Keep it secret.
  4. Cursor with plugin/MCP support.

Install (Marketplace / local)

Official Marketplace (after listing)

Install browse-bridge from the Cursor Marketplace and paste your API key when prompted (BROWSEBRIDGE_API_KEY).

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

Restart Cursor, open Customize, configure BROWSEBRIDGE_API_KEY, confirm MCP tools appear (browser_observe, browser_click, etc.).

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

Plugin variables only fill in inside the plugin, so for a manual config use your real key or ${env:BROWSEBRIDGE_API_KEY}.

Usage

  1. Open a normal website tab (not chrome://).
  2. Click the Browse Bridge toolbar icon, then Enable on the tab you want to share. Accept the confirmation and any Chrome permission prompt. Use Take control (or Ctrl+Shift+Period) to take the tab back at any time.
  3. In Cursor, use MCP tools such as browser_list_sessions, browser_observe, browser_click, browser_screenshot.
  4. Challenges / sensitive sites may pause the agent for human Take over or Approve.

Tools (17)

ToolWhat it does
browser_list_sessionsList Enabled shared tabs.
browser_get_statusControl mode, URL, deviceOnline, pending approvals, remaining monthly quota (actionsRemaining, screenshotsRemaining, quotaExceeded, quotaResetAt). Tools return QUOTA_EXCEEDED when a monthly quota is exhausted.
browser_observeSemantic page tree + observationId / elementIds.
browser_screenshotVisible-tab JPEG as MCP image content.
browser_clickClick an observed element. Optional button: "left" (default), "right", or "middle".
browser_typeSet a control's value (not a password).
browser_selectChoose a listed <option>.
browser_press_keyKey in the focused (or named) element.
browser_hovermouseover / mouseenter on an observed element.
browser_scrollScroll the page or an element into view.
browser_navigateGo to an allowed http(s) URL.
browser_backHistory back.
browser_forwardHistory forward.
browser_reloadReload the tab.
browser_waitPause 0–30000 ms.
browser_release_controlGive the tab back to the human (controlMode: "human").
browser_cancel_approvalWithdraw a pending agent approval (approvalId).
JavaScript dialogs

Page alert / confirm / prompt are auto-handled so they cannot freeze the tab: alerts are accepted, confirms are dismissed, and prompts return null. The handled dialog is reported in the dialog field on click (and in dialogs on observe).

Approvals

Sensitive-site clicks/types/navigations and cross-origin navigations (and cross-origin link clicks) return APPROVAL_REQUIRED. The human Approves or Denies in the Chrome side panel. The agent can withdraw its own request with browser_cancel_approval (APPROVAL_CANCELLED — that is not a human Deny). While an approval is pending, observe/screenshot/wait/get_status/list_sessions/release_control still run.

Configuration

VariableRequiredDescription
BROWSEBRIDGE_API_KEYYesAPI key from the Browse Bridge dashboard

Declared in .cursor-plugin/plugin.json → variables and referenced only as ${BROWSEBRIDGE_API_KEY} in mcp.json.

Privacy & security

See PRIVACY.md and SECURITY.md.

Repo layout

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

الأسئلة الشائعة

ما هو Browse Bridge؟

Let AI agents observe and control Chrome tabs you explicitly share via Browse Bridge.

كيف أثبّت Browse Bridge؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http browse-bridge 'https://mcp.browsebridge.com/mcp' --header 'Authorization: <Bearer token: your Browse Bridge API key (bbk_...) from https://browsebridge.com/dashboard/connections>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Browse Bridge إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل Browse Bridge مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Browse Bridge؟

ينشره BryanHamilton. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.