التهيئة

Matthias Rohmer
José Luis Zapata

يمكنك ضبط "أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء" لتخصيص طريقة تفاعلها مع المتصفّح والأدوات المفعّلة وطريقة معالجة البيانات.

اضبط الخادم عن طريق تمرير علامات سطر الأوامر في مصفوفة args ضمن ملف إعداد عميل Model Context Protocol (MCP). ويكون هذا الملف عادةً هو ملف config.json.

على سبيل المثال، لتشغيل Chrome في وضع بلا واجهة مستخدم رسومية واستخدام قناة Canary، استخدِم الإعدادات التالية:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--headless",
        "--channel=canary"
      ]
    }
  }
}

سيناريوهات الإعداد الشائعة

توضّح السيناريوهات التالية الطرق الشائعة التي يمكن من خلالها ضبط "أدوات مطوّري البرامج في Chrome" للوكلاء.

التشغيل في وضع التشغيل بلا واجهة مستخدم رسومية

لتنفيذ مهام في الخلفية بدون نافذة متصفّح مرئية، شغِّل Chrome في وضع بلا رأس (بدون واجهة مستخدم). أضِف العلامة --headless إلى وسيطات الخادم.

الربط بجلسة متصفّح حالية

تبدأ "أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء" تلقائيًا مثيلاً جديدًا من Chrome. ومع ذلك، يمكنك ربط وكيلك بجلسة متصفّح حالية. يكون هذا الخيار مفيدًا إذا كان على الموظف التحقيق في مشكلة في جلسة سبق أن بدأتها (على سبيل المثال، إذا كنت قد سجّلت الدخول).

يمكنك الاتصال بجلسة حالية بطريقتَين:

الربط التلقائي (الإصدار 144 من Chrome أو الإصدارات الأحدث)

إذا كنت تستخدم العلامة --autoConnect، يتصل خادم MCP تلقائيًا بنسخة Chrome نشطة.

  1. في متصفّح Chrome الذي تستخدمه، انتقِل إلى chrome://inspect/#remote-debugging وفعِّل تصحيح الأخطاء عن بُعد.
  2. أضِف --autoConnect إلى إعدادات MCP: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
  3. عندما يحاول الوكيل الاتصال، يعرض Chrome مربّع حوار يطلب الإذن. انقر على سماح.

الربط اليدوي

إذا تعذّر عليك استخدام --autoConnect (على سبيل المثال، في بيئة معزولة)، يمكنك بدء تشغيل Chrome يدويًا باستخدام منفذ تصحيح الأخطاء والاتصال باستخدام --browser-url.

  1. ابدأ Chrome من الوحدة الطرفية مع تفعيل تصحيح الأخطاء عن بُعد ودليل مخصّص لبيانات المستخدمين.
    • macOS: shell /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
    • نظام التشغيل Windows: shell start chrome --remote-debugging-port=9222 --user-data-dir=%TEMP%\chrome-profile-stable
    • Linux: shell google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
  2. اضبط الوكيل للاتصال بهذا المنفذ: json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

مرجع خيارات الإعداد

تدرِج الأقسام التالية علامات الإعداد المتاحة. للاطّلاع على أحدث الخيارات والتحديثات، يُرجى الرجوع إلى مستودع GitHub الخاص بأداة MCP ضمن "أدوات مطوّري البرامج في Chrome".

خيارات الاتصال

استخدِم هذه الخيارات لتحديد طريقة اتصال الخادم بمتصفّح Chrome.

علم النوع القيمة التلقائية الوصف
--autoConnect أو --auto-connect قيمة منطقية false يتصل تلقائيًا بنسخة من Chrome (الإصدار 144 أو الإصدارات الأحدث) تعمل على الجهاز. يجب تفعيل ميزة تصحيح الأخطاء عن بُعد باستخدام chrome://inspect/#remote-debugging.
‫--browserUrl أو --browser-url
-u		 سلسلة false الاتصال بنسخة Chrome قيد التشغيل وقابلة لتصحيح الأخطاء (على سبيل المثال، http://127.0.0.1:9222)
‫--wsEndpoint أو --ws-endpoint
-w		 سلسلة false نقطة نهاية WebSocket للاتصال بمثيل Chrome قيد التشغيل (على سبيل المثال، ws://127.0.0.1:9222/devtools/browser/<id>)، وهي بديل عن --browserUrl
--wsHeaders أو --ws-headers سلسلة false عناوين مخصّصة لاتصال WebSocket بتنسيق JSON (على سبيل المثال، '{"Authorization":"Bearer token"}'). لا تعمل إلا مع --wsEndpoint.

خيارات فتح المتصفّح

تنطبق هذه الخيارات عندما يبدأ خادم MCP تشغيل Chrome.

علم النوع القيمة التلقائية الوصف
--headless قيمة منطقية false يشغّل Chrome في وضع بلا واجهة مستخدم رسومية.
--channel سلسلة stable تحدِّد هذه السياسة قناة Chrome التي سيتم استخدامها. الخيارات: canary وdev وbeta وstable
‫--executablePath أو --executable-path
-e		 سلسلة false مسار إلى ملف Chrome تنفيذي مخصّص
--userDataDir أو --user-data-dir سلسلة عرض الوصف مسار دليل بيانات المستخدم القيمة التلقائية هي $HOME/.cache/chrome-devtools-mcp/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE.
--isolated قيمة منطقية false تنشئ هذه السياسة دليل بيانات مستخدم مؤقتًا يتم تنظيفه تلقائيًا عند إغلاق المتصفّح.
--viewport سلسلة false حجم إطار العرض الأولي (على سبيل المثال، 1280x720). في وضع التشغيل بلا واجهة مستخدم رسومية، يبلغ الحد الأقصى للحجم 3840x2160.
--proxyServer أو --proxy-server سلسلة false إعدادات الخادم الوكيل التي تم تمريرها إلى Chrome
--chromeArg أو --chrome-arg صفيف false وسيطات إضافية لتمريرها إلى Chrome
--ignoreDefaultChromeArg أو --ignore-default-chrome-arg صفيف false إيقاف الوسيطات التلقائية في Chrome بشكل صريح

خيارات الأمان والخصوصية

استخدِم هذه الخيارات لإدارة إعدادات الأمان وخصوصية البيانات.

علم النوع القيمة التلقائية الوصف
--acceptInsecureCerts أو --accept-insecure-certs قيمة منطقية false يتجاهل الأخطاء المتعلقة بالشهادات الموقَّعة ذاتيًا والشهادات المنتهية الصلاحية. يجب استخدامه بحذر.
--blockedUrlPattern أو --blocked-url-pattern صفيف false يحظر الوصول إلى الشبكة من خلال حظر أنماط عناوين URL محدّدة (يستخدم URLPattern). يحظر عمليات التنقّل والموارد الفرعية.
--allowedUrlPattern أو --allowed-url-pattern صفيف false يحظر هذا الإعداد الوصول إلى الشبكة من خلال السماح فقط بأنماط عناوين URL محدّدة. تتطلّب هذه الميزة الإصدار 149 من Chrome أو إصدارًا أحدث.
--redactNetworkHeaders أو --redact-network-headers قيمة منطقية false يخفي عناوين الشبكة الحسّاسة قبل إرسالها إلى العميل.
--usageStatistics أو --usage-statistics قيمة منطقية true تتيح هذه الإعدادات جمع إحصاءات الاستخدام لتحسين الأداة. يمكن أيضًا إيقافها باستخدام متغيّرات البيئة CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS أو CI.
--performanceCrux أو --performance-crux قيمة منطقية true إرسال عناوين URL من عمليات تتبُّع الأداء إلى واجهة برمجة التطبيقات Google CrUX API لاسترجاع بيانات تجربة المستخدم الفعلي

فئات الميزات

يمكنك تفعيل أو إيقاف مجموعات من الأدوات باستخدام هذه العلامات.

علم النوع القيمة التلقائية الوصف
--categoryEmulation أو --category-emulation قيمة منطقية true تفعيل الأدوات ذات الصلة بالمحاكاة
--categoryNetwork أو --category-network قيمة منطقية true تفعيل الأدوات ذات الصلة بالشبكة
--categoryPerformance أو --category-performance قيمة منطقية true تفعيل الأدوات ذات الصلة بالأداء
--categoryExtensions أو --category-extensions قيمة منطقية false تفعيل الأدوات المتعلّقة بالإضافات لا تتوافق هذه السمة إلا مع الاتصال عبر الأنابيب.
--categoryExperimentalThirdParty أو --category-experimental-third-party قيمة منطقية false تتيح هذه السمة أدوات المطوّرين التابعة لجهات خارجية التي تعرضها الصفحة التي تم فحصها.
--categoryExperimentalWebmcp أو --category-experimental-webmcp قيمة منطقية false تتيح هذه السمة تصحيح أخطاء أدوات WebMCP. يتطلّب هذا الإجراء الإصدار 149 من Chrome أو إصدارًا أحدث مع تفعيل ميزات WebMCP.
--memoryDebugging أو --memory-debugging قيمة منطقية false تفعّل هذه السمة أدوات تصحيح أخطاء الذاكرة.

خيارات لقطة الشاشة

استخدِم هذه الخيارات لتخصيص طريقة التقاط البرنامج المساعد للقطات الشاشة.

علم النوع القيمة التلقائية الوصف
--screenshotFormat أو --screenshot-format سلسلة false تتجاوز هذه السمة تنسيق الإخراج التلقائي (png). الخيارات: jpeg وpng وwebp. تكون تنسيقات jpeg وwebp أصغر حجمًا، ما يساعد في تقليل حجم السياق في محادثات الذكاء الاصطناعي.
--screenshotQuality أو --screenshot-quality الرقم false تتجاوز هذه السمة جودة الضغط (من 0 إلى 100) لكل من jpeg وwebp.
--screenshotMaxWidth أو --screenshot-max-width الرقم false الحد الأقصى للعرض بالبكسل يتم تصغير حجم لقطات الشاشة الأكبر.
--screenshotMaxHeight أو --screenshot-max-height الرقم false الحد الأقصى للارتفاع بالبكسل يتم تصغير حجم لقطات الشاشة الأكبر.

خيارات تجريبية

استخدِم هذه الخيارات لتفعيل الميزات التجريبية التي لا تزال قيد التطوير.

علم النوع القيمة التلقائية الوصف
--experimentalPageIdRouting أو --experimental-page-id-routing قيمة منطقية false تعرض هذه السمة pageId على الأدوات ذات النطاق المحدود بالصفحة لتوجيه الطلبات في جلسات الوكيل المتزامنة.
--experimentalDevtools أو --experimental-devtools قيمة منطقية false تتيح هذه السياسة التشغيل الآلي على أهداف "أدوات مطوّري البرامج".
--experimentalVision أو --experimental-vision قيمة منطقية false تفعيل الأدوات المستندة إلى الإحداثيات (مثل click_at)، ويتطلّب ذلك عادةً نموذجًا للاستخدام على الكمبيوتر يمكنه إنشاء إحداثيات دقيقة من خلال النظر إلى لقطات الشاشة
--experimentalStructuredContent أو --experimental-structured-content قيمة منطقية false تنتج محتوًى منسَّقًا ومنظَّمًا.
--experimentalIncludeAllPages أو --experimental-include-all-pages قيمة منطقية false يشمل جميع أنواع الصفحات (مثل طرق عرض الويب والصفحات التي تعمل في الخلفية).
--experimentalScreencast أو --experimental-screencast قيمة منطقية false تعرض أدوات التسجيل الرقمي للشاشة (تتطلّب ffmpeg في PATH).
--experimentalFfmpegPath أو --experimental-ffmpeg-path سلسلة false مسار الملف التنفيذي ffmpeg

خيارات أخرى

استخدِم هذه الخيارات لضبط تسجيل الدخول أو لتفعيل مجموعة مبسطة من الأدوات.

علم النوع القيمة التلقائية الوصف
--slim قيمة منطقية false تعرض مجموعة صغيرة من ثلاث أدوات (التنقل وتنفيذ النصوص البرمجية ولقطات الشاشة). مفيد للمهام الأساسية في المتصفّح
--logFile أو --log-file سلسلة false مسار إلى ملف لكتابة سجلّات تصحيح الأخطاء فيه

متغيرات البيئة

يمكنك أيضًا استخدام متغيّرات البيئة التالية لضبط إعدادات الخادم:

  • CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: في حال ضبطها، يتم إيقاف جمع إحصاءات الاستخدام (وهي تعادل --no-usage-statistics).
  • CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS: في حال ضبط هذا الخيار، يتم إيقاف عمليات التحقّق الدورية من التحديثات.
  • CI: في حال ضبط هذا الخيار، يتم إيقاف جمع إحصاءات الاستخدام.
  • DEBUG: اضبط القيمة على * لتفعيل ميزة تسجيل معلومات تصحيح الأخطاء المطوَّل (تعمل بالتزامن مع --logFile).