تستطيع وكلاء البرمجة بالذكاء الاصطناعي كتابة صفحة ويب، لكن معظمها لا يرى ما تفعله تلك الصفحة عندما تعمل في المتصفح. يعالج 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 أو أحدث.
- في Chrome، انتقل إلى
chrome://inspect/#remote-debuggingواتبع مربع الحوار للسماح باتصالات تصحيح الأخطاء الواردة. - أضف
--autoConnectإلى إعداداتك:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["chrome-devtools-mcp@latest", "--autoConnect"]
}
}
}
- اترك 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.





اكتب ردًّا