ما خادم MCP للمتصفح؟
MCP بروتوكول مفتوح يتيح لتطبيق ذكاء اصطناعي استدعاء أدوات من خارج النموذج. ويضيف خادم MCP للمتصفح أدوات تفتح صفحات الويب وتنقر وتكتب وتقرأ، فيستطيع المساعد استخدام مواقع لا تملك API. ينفّذ خادم Browsa هذه الخطوات في متصفح سحابي بدلًا من جهازك، فلا يُمَس متصفحك ولا ملفات تعريف الارتباط ولا كلمات المرور لديك، ويستمر العمل حتى لو كانت الصفحة بطيئة.
الخادم نفسه عملية Node.js صغيرة يشغّلها عميل MCP لديك عبر npx. وكل طلب يرسله يذهب إلى Browsa API مع مفتاح agt_live_ الخاص بك.
-
احصل على مفتاح API
أنشئ حسابًا وانسخ مفتاحك من صفحة Keys في لوحة التحكم. تحصل على 100 رصيد مجاني عند تأكيد بريدك الإلكتروني، بلا بطاقة.
-
أضف الخادم إلى عميلك
Claude Desktop
افتح ملف الإعدادات:
~/Library/Application Support/Claude/claude_desktop_config.jsonعلى macOS أو%APPDATA%\Claude\claude_desktop_config.jsonعلى Windows. أضف الخادم، واحفظ، وأعد تشغيل Claude Desktop.{ "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في مشروع واحد.{ "mcpServers": { "browsa": { "command": "npx", "args": ["-y", "@browsa/mcp"], "env": { "BROWSA_API_KEY": "agt_live_..." } } } }VS Code
يقرأ VS Code الملف
.vscode/mcp.jsonفي مساحة عملك، وصيغته تستخدمserversبدلًا منmcpServers. هذه النسخة تطلب المفتاح عند أول تشغيل للخادم، فلا يُحفظ المفتاح في الملف.{ "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في بيئة الخادم. -
جرّبه
اطلب من مساعدك شيئًا يحتاج إلى صفحة ويب حية، مثلًا:
- «اذهب إلى news.ycombinator.com وأخبرني بالخبر الأول.»
- «افتح books.toscrape.com واذكر أول خمسة كتب مع أسعارها.»
- «كل صباح، تحقق من السعر في صفحة هذا المنتج وأرسل النتيجة إلى Webhook الخاص بي.»
يستدعي المساعد
run_task. وتعود النتيجة معlive_url: افتحه لمشاهدة المتصفح، واستخدم الفأرة ولوحة المفاتيح إن احتاجت صفحة إلى تدخل بشري.
أي نموذج ينفّذ مهمة المتصفح؟
يحتاج وكيل المتصفح إلى نموذج لغوي، ولا تحتاج إلى وضع مفتاح نموذج في الإعدادات. في كل استدعاء، يُعتمد أول خيار متاح:
llm: "browsa"في الاستدعاءالنموذج المستضاف من Browsa، دون مفتاح، مقابل 5 أرصدة إضافية لكل مهمة.BROWSA_LLM_API_KEYمفتاحك من Anthropic أو OpenAI أو Google، يُرسل مع كل مهمة، ويبقى مشفّرًا أثناء تشغيلها ويُحذف عند انتهائها.BROWSA_LLM_KEY_IDمفتاح حفظته في لوحة التحكم، بمعرّفه.- لا شيء مضبوطالمفتاح المحفوظ الافتراضي لمساحة العمل. إن لم يوجد مفتاح محفوظ ولم يُحدَّد نموذج، تعمل المهمة على النموذج المستضاف من 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.