انتقل إلى المحتوى
Browsa
  1. الأدلة
  2. خادم MCP

إعداد خادم Browsa MCP في Claude وCursor وVS Code.

خادم Browsa MCP (@browsa/mcp) هو خادم Model Context Protocol يمنح مساعد الذكاء الاصطناعي متصفحًا حقيقيًا في السحابة. تطلب ما تريد بلغة طبيعية، فينفّذ وكيل متصفح على Browsa العمل، ويتلقى المساعد الإجابة مع رابط لمشاهدة المتصفح مباشرة.

الوقت
نحو دقيقتين
المتطلبات
Node.js 18 أو أحدث، ومفتاح Browsa API
الحزمة
@browsa/mcp على npm، برخصة MIT

ما خادم MCP للمتصفح؟

MCP بروتوكول مفتوح يتيح لتطبيق ذكاء اصطناعي استدعاء أدوات من خارج النموذج. ويضيف خادم MCP للمتصفح أدوات تفتح صفحات الويب وتنقر وتكتب وتقرأ، فيستطيع المساعد استخدام مواقع لا تملك API. ينفّذ خادم Browsa هذه الخطوات في متصفح سحابي بدلًا من جهازك، فلا يُمَس متصفحك ولا ملفات تعريف الارتباط ولا كلمات المرور لديك، ويستمر العمل حتى لو كانت الصفحة بطيئة.

الخادم نفسه عملية Node.js صغيرة يشغّلها عميل MCP لديك عبر npx. وكل طلب يرسله يذهب إلى Browsa API مع مفتاح agt_live_ الخاص بك.

  1. احصل على مفتاح API

    أنشئ حسابًا وانسخ مفتاحك من صفحة Keys في لوحة التحكم. تحصل على 100 رصيد مجاني عند تأكيد بريدك الإلكتروني، بلا بطاقة.

  2. أضف الخادم إلى عميلك

    Claude Desktop

    افتح ملف الإعدادات: ~/Library/Application Support/Claude/claude_desktop_config.json على macOS أو %APPDATA%\Claude\claude_desktop_config.json على Windows. أضف الخادم، واحفظ، وأعد تشغيل Claude Desktop.

    claude_desktop_config.json
    {
      "mcpServers": {
        "browsa": {
          "command": "npx",
          "args": ["-y", "@browsa/mcp"],
          "env": {
            "BROWSA_API_KEY": "agt_live_..."
          }
        }
      }
    }

    Claude Code

    أضفه من الطرفية. ضع اسم الخادم قبل -e، وكل ما بعد -- هو الأمر الذي يشغّله Claude Code.

    الطرفية
    claude mcp add browsa -e BROWSA_API_KEY=agt_live_... -- npx -y @browsa/mcp

    شغّل claude mcp list للتحقق من اتصاله.

    Cursor

    أضف الكتلة نفسها إلى ~/.cursor/mcp.json لكل المشاريع، أو إلى .cursor/mcp.json في مشروع واحد.

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "browsa": {
          "command": "npx",
          "args": ["-y", "@browsa/mcp"],
          "env": { "BROWSA_API_KEY": "agt_live_..." }
        }
      }
    }

    VS Code

    يقرأ VS Code الملف .vscode/mcp.json في مساحة عملك، وصيغته تستخدم servers بدلًا من mcpServers. هذه النسخة تطلب المفتاح عند أول تشغيل للخادم، فلا يُحفظ المفتاح في الملف.

    .vscode/mcp.json
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "browsa-api-key",
          "description": "Browsa API key (agt_live_...)",
          "password": true
        }
      ],
      "servers": {
        "browsa": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "@browsa/mcp"],
          "env": { "BROWSA_API_KEY": "${input:browsa-api-key}" }
        }
      }
    }

    Cline وContinue وZed وعملاء آخرون

    يعمل أي عميل يشغّل خوادم MCP عبر stdio. وجّهه إلى npx -y @browsa/mcp واضبط BROWSA_API_KEY في بيئة الخادم.

  3. جرّبه

    اطلب من مساعدك شيئًا يحتاج إلى صفحة ويب حية، مثلًا:

    • «اذهب إلى news.ycombinator.com وأخبرني بالخبر الأول.»
    • «افتح books.toscrape.com واذكر أول خمسة كتب مع أسعارها.»
    • «كل صباح، تحقق من السعر في صفحة هذا المنتج وأرسل النتيجة إلى Webhook الخاص بي.»

    يستدعي المساعد run_task. وتعود النتيجة مع live_url: افتحه لمشاهدة المتصفح، واستخدم الفأرة ولوحة المفاتيح إن احتاجت صفحة إلى تدخل بشري.

أي نموذج ينفّذ مهمة المتصفح؟

يحتاج وكيل المتصفح إلى نموذج لغوي، ولا تحتاج إلى وضع مفتاح نموذج في الإعدادات. في كل استدعاء، يُعتمد أول خيار متاح:

  1. llm: "browsa" في الاستدعاءالنموذج المستضاف من Browsa، دون مفتاح، مقابل 5 أرصدة إضافية لكل مهمة.
  2. BROWSA_LLM_API_KEYمفتاحك من Anthropic أو OpenAI أو Google، يُرسل مع كل مهمة، ويبقى مشفّرًا أثناء تشغيلها ويُحذف عند انتهائها.
  3. BROWSA_LLM_KEY_IDمفتاح حفظته في لوحة التحكم، بمعرّفه.
  4. لا شيء مضبوطالمفتاح المحفوظ الافتراضي لمساحة العمل. إن لم يوجد مفتاح محفوظ ولم يُحدَّد نموذج، تعمل المهمة على النموذج المستضاف من Browsa وتذكر النتيجة ذلك.

يضبط BROWSA_LLM نموذجًا افتراضيًا، مثل anthropic:claude-sonnet-5-5. وإذا حدّدت نموذجًا ولم يتوفر مفتاح له، تُرجع الأداة LLM_KEY_REQUIRED بدلًا من الرجوع إلى النموذج المستضاف.

ما الأدوات التي يحصل عليها المساعد؟

run_task
ينفّذ مهمة متصفح موصوفة بلغة طبيعية ويُرجع النتيجة ورابط العرض المباشر.
get_job
يتحقق من مهمة طويلة، مع إمكانية الانتظار على الخادم.
cancel_job
يلغي مهمة قيد التشغيل.
respond_to_job
يجيب مهمة توقفت لتطلب مدخلات.
list_job_files
يعرض الملفات التي كتبتها مهمة، مثل التقارير المنزّلة.
create_schedule, list_schedules
مهام متكررة، من كل ساعة إلى كل 30 يومًا.
list_webhooks, create_webhook, delete_webhook
وجهات تسليم النتائج، عبر Webhooks موقّعة بـ HMAC.
list_identities
هويات دائمة يمكن للمهمة إعادة استخدام تسجيلات الدخول المحفوظة فيها.
list_llm_keys
مفاتيح النماذج المحفوظة، مخفية. لا يُرجع أي سر أبدًا.
credits
رصيد الحساب والباقات.

كم يكلف؟

خادم MCP مجاني. وكل run_task مهمة وكيل تُحاسَب بالرصيد: وقت متصفحها (1 رصيد لكل 12 دقيقة بدأت)، زائد 1 رصيد، زائد 1 رصيد لكل 5 خطوات. ويضيف النموذج المستضاف من Browsa 5 أرصدة.

المهمة (تنتهي خلال 12 دقيقة)مفتاح نموذجك الخاصالنموذج المستضاف من Browsa
10 خطوات4 أرصدة9 أرصدة
20 خطوة6 أرصدة11 رصيدًا

المهمة التي تفشل تسترد رسوم متصفحها ولا تُحاسَب على الخطوات. مع مفتاحك الخاص، يحاسبك مزوّد النموذج على الرموز (tokens)، ولا تضيف Browsa أي هامش. الرصيد الواحد يساوي $0.10 في باقة Starter بقيمة $20. الأسعار كاملة.

استكشاف الأخطاء وإصلاحها

الخادم لا يظهر

أعد تشغيل العميل بعد تعديل إعداداته، وتأكد من صحة JSON، وشغّل node --version في الطرفية: يحتاج الخادم إلى Node.js 18 أو أحدث وإلى npx في المسار الذي يستخدمه العميل.

LLM_KEY_REQUIRED

حدّدت نموذجًا لكن لا يتوفر مفتاح له. احفظ مفتاحًا في dashboard/llm-keys، أو اضبط BROWSA_LLM_API_KEY، أو اطلب llm: "browsa".

402 INSUFFICIENT_CREDIT أو BUDGET_REACHED

الرصيد منخفض جدًا، أو بلغت حد الإنفاق الشهري. اطلب من المساعد تشغيل أداة credits، أو راجع صفحة الرصيد في لوحة التحكم.

أسئلة

هل يعمل المتصفح على جهازي؟

لا. خادم MCP عملية Node.js صغيرة على جهازك تستدعي Browsa API. أما المتصفح فيعمل في سحابة Browsa، فلا حاجة إلى تثبيت أي شيء آخر ولا يُمَس متصفحك أبدًا.

هل أحتاج إلى مفتاح Anthropic أو OpenAI؟

لا. مع ضبط BROWSA_API_KEY فقط ودون مفتاح محفوظ، تعمل المهام على النموذج المستضاف من Browsa مقابل 5 أرصدة إضافية لكل منها، ويذكر الخادم ذلك في النتيجة. لاستخدام نموذجك الخاص، احفظ مفتاح Anthropic أو OpenAI أو Google في لوحة التحكم، أو اضبط BROWSA_LLM_API_KEY.

كم يكلف كل طلب؟

كل استدعاء run_task مهمة وكيل: وقت متصفحها (1 رصيد لكل 12 دقيقة بدأت)، زائد 1 رصيد، زائد 1 رصيد لكل 5 خطوات. المهمة من 10 خطوات التي تنتهي خلال 12 دقيقة تكلف 4 أرصدة بمفتاحك و9 على النموذج المستضاف من Browsa. وخادم MCP نفسه مجاني.

مع أي عملاء MCP يعمل؟

مع أي عميل يستطيع تشغيل خادم MCP محلي عبر stdio، ومنها Claude Desktop وClaude Code وCursor وVS Code وCline وContinue وZed. يحتاج الخادم إلى Node.js 18 أو أحدث من أجل npx.

الخطوات التالية

امنح مساعدك متصفحًا.

100 رصيد مجاني. بلا بطاقة ولا اشتراك.