كيف تمنح وكيل البرمجة بالذكاء الاصطناعي متصفحًا حقيقيًا باستخدام Chrome DevTools MCP

دع وكيل البرمجة بالذكاء الاصطناعي يفتح Chrome ويقرأ أخطاء وحدة التحكم ويسجّل تتبعات الأداء. خطوات التثبيت والإعدادات وحلول المشكلات الشائعة في Chrome DevTools MCP.

Graphic of a browser window connected to a terminal prompt reading mcp, for a guide to Chrome DevTools MCP

تستطيع وكلاء البرمجة بالذكاء الاصطناعي كتابة صفحة ويب، لكن معظمها لا يرى ما تفعله تلك الصفحة عندما تعمل في المتصفح. يعالج Chrome DevTools MCP هذه المشكلة، وهو خادم مفتوح المصدر من فريق Chrome DevTools يتيح لوكيل مثل Claude Code أو Cursor أو Copilot أو Gemini CLI فتح Chrome وقراءة وحدة التحكم وفحص طلبات الشبكة والتقاط لقطات الشاشة وتسجيل تتبعات الأداء. يشرح لك هذا الدليل كيف تثبّته، وتجري اختبارًا أول، وتربطه بنافذة Chrome مفتوحة لديك بالفعل، وتحل أكثر مشكلات الإعداد شيوعًا.

حتى 14 نوفمبر 2026، أحدث إصدار هو 1.13.0 الذي نُشر في 11 نوفمبر، وقد ظهر المشروع هذا الأسبوع في قائمة GitHub اليومية للمشاريع الرائجة.

ماذا يفعل Chrome DevTools MCP

بروتوكول MCP (Model Context Protocol) طريقة قياسية تتيح لمساعدي الذكاء الاصطناعي استدعاء أدوات خارجية. والحزمة chrome-devtools-mcp هي خادم MCP: يرسل إليها وكيلك طلبات مثل “افتح هذا الرابط” أو “اعرض أخطاء وحدة التحكم”، فتنفذها في متصفح Chrome حقيقي باستخدام Chrome DevTools وPuppeteer.

الأدوات مقسمة إلى فئات. أتمتة الإدخال (النقر، والملء، والكتابة، ورفع ملف)، والتنقل، والمحاكاة، وتتبع الأداء، وفحص الشبكة، وتصحيح الأخطاء (رسائل وحدة التحكم، ولقطات الشاشة، ولقطات الصفحة، وتدقيقات Lighthouse) كلها مفعّلة افتراضيًا. أما الفئات الإضافية مثل محاكاة الشبكة (network mocks) والإضافات وتطبيقات الويب التقدمية فتبقى معطلة حتى تفعّلها بخيار (flag). وأضاف الإصدار 1.13.0 نقاط التسجيل (logpoints) ومحاكاة الشبكة على مستوى الصفحة.

تتضمن الحزمة نفسها أيضًا أداة سطر أوامر باسم chrome-devtools، فيمكنك التحكم في المتصفح من الطرفية دون أي وكيل على الإطلاق.

ما الذي تحتاج إليه

  • Node.js بإصدار LTS. حتى 14 نوفمبر 2026، تذكر حزمة npm دعم Node ^20.19.0 || ^22.12.0 || >=23.
  • npm (يأتي مع Node).
  • Google Chrome بالإصدار المستقر الحالي أو أحدث. يدعم المشروع رسميًا Google Chrome وChrome for Testing فقط؛ وقد تعمل متصفحات Chromium الأخرى لكن دون ضمان.
  • وكيل أو محرر يدعم MCP، مثل Claude Code أو Cursor أو VS Code مع Copilot أو Gemini CLI أو Codex.

تحقق أولًا من إصدار Node لديك:

الطرفية
node --version

الخطوة 1: تأكد من أن الخادم يعمل

قبل أن تغيّر إعدادات وكيلك، تأكد من أن الحزمة تعمل على جهازك. يوصي دليل حل المشكلات الرسمي بهذا الاختبار:

الطرفية
npx chrome-devtools-mcp@latest --help

يُفترض أن ترى قائمة خيارات مثل --headless و--isolated و--browser-url. إذا ظهر خطأ هنا، فأصلحه قبل المتابعة (راجع قسم الأخطاء أدناه).

الخطوة 2: أضِفه إلى وكيلك

تقبل معظم عملاء MCP كتلة JSON نفسها. هذه هي الإعدادات القياسية من ملف README الخاص بالمشروع:

الكود
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest"]
    }
  }
}

استخدام @latest يعني أن عميلك سيحصل على الإصدارات الجديدة تلقائيًا.

لعدة أدوات أيضًا أمر تثبيت من سطر واحد، مأخوذ من دليل إعداد العملاء في المشروع.

Claude Code:

الكود
claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest

Gemini CLI:

الكود
gemini mcp add chrome-devtools npx chrome-devtools-mcp@latest

OpenAI Codex:

الكود
codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

VS Code (على macOS وLinux):

الكود
code --add-mcp '{"name":"io.github.ChromeDevTools/chrome-devtools-mcp","command":"npx","args":["-y","chrome-devtools-mcp"],"env":{}}'

في Cursor، يقول الدليل أن تنتقل إلى Cursor Settings (إعدادات Cursor)، ثم MCP، ثم New MCP Server (خادم MCP جديد)، وتلصق الإعدادات القياسية. قد تتغير أسماء القوائم بين الإصدارات، فإن لم تجد هذا المسار فراجع وثائق MCP الخاصة بـ Cursor.

اختياري: ثبّته كإضافة مع المهارات

يوفّر المشروع أيضًا “مهارات” (skills)، وهي ملفات تعليمات قصيرة تعلّم وكيلك كيف يستخدم الأدوات جيدًا. في Claude Code يمكنك تثبيت الخادم والمهارات معًا بتشغيل /plugin marketplace add ChromeDevTools/chrome-devtools-mcp ثم /plugin install chrome-devtools-mcp@chrome-devtools-plugins، ثم إعادة تشغيل Claude Code. وإن كانت المهارات جديدة عليك، فدليلنا حول تثبيت مهارات الوكيل واستخدامها في Claude Code يشرح طريقة عملها.

الخطوة 3: شغّل أول طلب (prompt)

أعد تشغيل وكيلك ليحمّل الخادم الجديد، ثم اكتب طلب الاختبار الذي يقترحه المشروع:

الكود
Check the performance of https://developers.chrome.com

النتيجة المتوقعة: تُفتح نافذة Chrome، وتُحمَّل الصفحة، ويقدّم لك وكيلك تقريرًا عن تتبع الأداء. لا يبدأ المتصفح إلا عندما يستخدم الوكيل لأول مرة أداة تحتاج إليه، لذا فإن ربط الخادم وحده لن يفتح Chrome.

بعد أن ينجح ذلك، جرّب طلبات تناسب عملك:

الكود
Open http://localhost:3000, list any console errors, and tell me which network requests failed.
الكود
Take a screenshot of http://localhost:3000 at a mobile viewport and check the page for accessibility problems.

افتراضيًا، يشغّل الخادم Chrome بملف تعريف خاص به محفوظ في $HOME/.cache/chrome-devtools-mcp/chrome-profile على macOS وLinux. يبقى هذا الملف محفوظًا بين مرات التشغيل، لذا تظل عمليات تسجيل الدخول التي تجريها فيه قائمة.

الخطوة 4: غيّر طريقة تشغيل Chrome (اختياري)

تتحكم في السلوك بإضافة خيارات إلى المصفوفة args. يشغّل هذا المثال Chrome دون نافذة، ويستخدم ملف تعريف مؤقتًا يُحذف بعد ذلك، ويوقف إحصاءات الاستخدام التي تجمعها Google افتراضيًا:

الكود
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--headless=true",
        "--isolated=true",
        "--no-usage-statistics"
      ]
    }
  }
}

هناك إعدادان آخران للخصوصية يستحقان المعرفة. قد ترسل أدوات الأداء روابط التتبع إلى واجهة Chrome UX Report (CrUX) API من Google لجلب بيانات مستخدمين حقيقيين؛ أضف --no-performance-crux لمنع ذلك. وإذا كنت تحتاج إلى تصفح بسيط فقط، فإن --slim يوفّر مجموعة مختصرة من ثلاث أدوات.

الخطوة 5: اربطه بنافذة Chrome تستخدمها بالفعل (اختياري)

أحيانًا تريد أن يعمل الوكيل في متصفحك أنت، مثلًا على موقع سجّلت الدخول إليه بالفعل. حتى 14 نوفمبر 2026، يتطلب وضع “الاتصال التلقائي” هذا Chrome 144 أو أحدث.

  1. في Chrome، انتقل إلى chrome://inspect/#remote-debugging واتبع مربع الحوار للسماح باتصالات تصحيح الأخطاء الواردة.
  2. أضف --autoConnect إلى إعداداتك:
الكود
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
    }
  }
}
  1. اترك Chrome يعمل وأرسل طلبًا. سيطلب Chrome الإذن؛ انقر على Allow (سماح).

يتصل الخادم بملف تعريف Chrome الافتراضي لديك ويمكنه رؤية كل نافذة مفتوحة فيه. أغلق أولًا علامات التبويب الخاصة بالبنك أو البريد الإلكتروني أو أي بيانات حساسة أخرى. ويحذّر إخلاء المسؤولية الخاص بالمشروع نفسه من أن الوكيل يستطيع فحص أي بيانات في المتصفح وتعديلها.

إذا كان وكيلك يعمل داخل بيئة معزولة (sandbox)، فالبديل هو أن تشغّل Chrome بنفسك مع منفذ لتصحيح الأخطاء وملف تعريف منفصل (المثال لنظام macOS؛ وتذكر الوثائق مسارات Linux وWindows أيضًا):

الكود
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable

ثم استخدم "--browser-url=http://127.0.0.1:9222" في args. يمكن لأي تطبيق على جهازك التحكم في المتصفح ما دام هذا المنفذ مفتوحًا، لذا لا تتصفح مواقع حساسة في تلك النافذة.

الأخطاء الشائعة وحلولها

  • Error [ERR_MODULE_NOT_FOUND]: Cannot find module ...: السبب عادةً إصدار Node غير مدعوم أو ذاكرة npx مؤقتة تالفة. حدّث Node، ثم امسح الذاكرة المؤقتة بالأمر npm cache clean --force وأعد التثبيت. تقترح الوثائق أيضًا rm -rf ~/.npm/_npx، وهو أمر يحذف كذلك أدوات npx الأخرى المخزنة مؤقتًا.
  • Target closed: تعذّر تشغيل Chrome. تأكد من عدم وجود نسخ أخرى من Chrome قيد التشغيل (وأغلقها إن وُجدت)، ومن تثبيت أحدث إصدار مستقر من Chrome.
  • الوكيل لا يجد الخادم، لكن الاختبار في الطرفية ينجح: تأكد من أن محررك يستخدم إصدار Node وnpm نفسه الذي تستخدمه الطرفية.
  • Windows: MCP error -32000: Connection closed: اضبط "command": "cmd" وضع "/c", "npx", "-y", "chrome-devtools-mcp@latest" في args.
  • macOS: يفشل --autoConnect مع الخطأ EPERM: operation not permitted: امنح الطرفية أو المحرر صلاحية الوصول إلى Google Chrome من System Settings > Privacy & Security > Files & Folders (إعدادات النظام > الخصوصية والأمن > الملفات والمجلدات).
  • انتهاء مهلة --autoConnect: تحقق من أن Chrome 144 أو أحدث يعمل بالفعل، وأن تصحيح الأخطاء عن بُعد مفعّل في chrome://inspect/#remote-debugging، وأنك وافقت على الطلب، وأنه لا يوجد شيء آخر يستخدم منفذ تصحيح الأخطاء نفسه.
  • Chrome لا يعمل داخل حاوية أو في CI: لا يعمل Chrome بصلاحيات root. شغّل الخادم بمستخدم عادي ليس root.
  • العمل داخل جهاز افتراضي (VM): قد يرفض Chrome الاتصالات القادمة من الجهاز الافتراضي. تقترح الوثائق نفقًا عبر SSH من الجهاز الافتراضي، مثل ssh -N -L 127.0.0.1:9222:127.0.0.1:9222 user@server. ويشرح دليلنا لمفاتيح SSH طريقة الإعداد إن لم تستخدم SSH من قبل.

لأي مشكلة أخرى، شغّل الخادم مع ملف سجل واقرأ رسالة الخطأ:

الكود
NODE_DEBUG=* npx chrome-devtools-mcp@latest --log-file=/tmp/chrome-devtools-mcp.log

الخلاصة

يتيح Chrome DevTools MCP لوكيلك أن يراجع عمله في الواجهة الأمامية بنفسه بدلًا من التخمين: يحمّل الصفحة، ويقرأ الأخطاء، ويطّلع على تبويب الشبكة، ويقيس الأداء. ابدأ بالإعدادات القياسية وطلب الاختبار، وأضف --isolated أو --headless إذا أردت متصفحًا نظيفًا يُستخدم مرة واحدة، ولا تستخدم الاتصال التلقائي إلا في ملف تعريف لا يزعجك أن يرى فيه الذكاء الاصطناعي كل شيء. وحافظ على تحديث Chrome نفسه أيضًا؛ إذ يشرح مقالنا عن ثغرات Chrome من نوع zero-day سبب أهمية ذلك.

المصادر

آخر مراجعة للروابط في 15 نوفمبر 2026.

بقلم Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

عن Mindloop Experience

الردود

اكتب ردًّا

المزيد من Mindloop Experience

كل مقالات Mindloop Experience

يمكنك التصفيق حتى 50 مرة.