بدء استخدام "أدوات مطوّري البرامج في Chrome" للوكلاء

أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء هي مجموعة من الأدوات التي تمنحك إمكانات "أدوات مطوّري البرامج في Chrome" في مهام سير عمل الترميز المستندة إلى الذكاء الاصطناعي. عند تثبيت "أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء"، يمكنك الوصول إلى:

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

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

على سبيل المثال، يمكن للوكيل استخدام الأدوات لتسجيل وتقييم عمليات تتبُّع الأداء من أجل تحليل أداء موقع إلكتروني وتحديد التحسينات المحتملة. بالإضافة إلى تطوير الويب، تتيح "أدوات مطوّري البرامج المخصّصة للوكلاء" أيضًا لوكيلك تصفُّح الويب المباشر بدلاً من استرداد HTML ثابت فقط.

الإعداد

يوضّح لك هذا الدليل كيفية إعداد "أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء" لمساعدة وكيل الترميز في التحكّم في متصفّح Chrome مباشر وفحصه.

استخدِم حزمة chrome-devtools-mcp للتحكّم في متصفّح Chrome مباشر وفحصه من وكيل الترميز (مثل Gemini أو Claude أو Cursor أو Copilot). يُرجى العِلم أنّه على الرغم من أنّ "أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء" توفّر المجموعة الكاملة من الأدوات، لا تتوافق واجهة سطر الأوامر (CLI) إلا مع مجموعة فرعية مستهدَفة للأتمتة المستندة إلى shell.

نماذج وبيئات تطوير متكاملة (IDE) متوافقة

تتوافق "أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء" مع أي أداة أو بيئة تطوير متكاملة (IDE) تتوافق مع بروتوكول سياق النموذج. ويشمل ذلك Antigravity وGemini CLI وClaude Code وCursor وCopilot وغير ذلك.

الاعتبارات الأمنية

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

المتطلبات الأساسية

قبل تثبيت "أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء"، تأكَّد من أنّ بيئتك تستوفي المتطلبات التالية:

  • Node.js (أحدث إصدار LTS) و npm
  • Chrome (الإصدار الثابت الحالي)

لإعداد "أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء"، اختَر الطريقة التي تتطابق مع بيئة الترميز المفضّلة لديك. تتطلّب بعض الوكلاء التثبيت اليدوي، بينما يأتي البعض الآخر مع الأدوات المدمَجة مسبقًا.

Antigravity

تأتي "أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء" مجمّعة مسبقًا مع Antigravity 2.0. يمكنك البدء في استخدامها على الفور مع الوكيل الفرعي للمتصفّح. جرِّب استخدام أمر يبدأ بشرطة مائلة، مثل:

/browser Navigate to the Google homepage

للوصول إلى مهارات الوكيل المتخصّصة، ننصحك بتثبيت المكوّن الإضافي لأدوات مطوّري البرامج خلال خطوة الإنشاء باستخدام Google في الإعداد الأولي أو ضمن إعدادات التطبيق. لمزيد من المعلومات، يمكنك الاطّلاع على مستندات الوكيل الفرعي للمتصفّح في Antigravity Browser Subagent.

التثبيت باستخدام واجهة سطر الأوامر (CLI)

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

إذا لم يكن وكيلك مدرجًا هنا، يمكنك معرفة كيفية تثبيته في مستودع Chrome DevTools for Agents GitHub repository.

لإضافة "أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء" إلى وكيل سطر أوامر، استخدِم أوامر واجهة سطر الأوامر (CLI) المضمّنة لوكيلك المحدد:

Gemini CLI

ثبِّت إضافة Gemini CLI التي تتضمّن حزمة بروتوكول سياق النموذج والمهارات المصاحبة باستخدام الأمر التالي:

# Gemini extension (MCP+Skills)
  gemini extensions install --auto-update https://github.com/ChromeDevTools/chrome-devtools-mcp

ثبِّت حزمة بروتوكول سياق النموذج فقط باستخدام الأمر التالي:

# MCP only
gemini mcp add chrome-devtools npx chrome-devtools-mcp@latest

Claude Code

لتثبيت "أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء" كمكوّن إضافي لـ Claude Code، استخدِم أوامر الشرطة المائلة التالية في Claude Code. أضِف قاعدة بيانات المسجّلين في Marketplace:

/plugin marketplace add ChromeDevTools/chrome-devtools-mcp

وثبِّت المكوّن الإضافي من قاعدة بيانات المسجّلين في Marketplace:

/plugin install chrome-devtools-mcp@chrome-devtools-plugins

راجِع صفحة المكوّن الإضافي الرسمي لأدوات مطوّري البرامج في Chrome في Claude لمزيد من المعلومات.

Codex

codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

التثبيت باستخدام إعداد JSON

بالنسبة إلى الوكلاء الآخرين الذين يتيحون مفتاح الإعداد mcpServers، أضِف هذا الإدخال يدويًا وتأكَّد من تثبيت "أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء" من خلال npm i chrome-devtools-mcp.

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

التثبيت في وكلاء آخرين

لإعداد وكيل غير مدرَج، راجِع مستودع GitHub الخاص ببروتوكول سياق النموذج في "أدوات مطوّري البرامج في Chrome" .

اختبار الإعداد

أدخِل الطلب التالي في وكيلك لمعرفة ما إذا كان كل شيء يعمل:

Check the performance of https://developers.chrome.com

من المفترض أن يفتح وكيلك نافذة متصفّح ويسجِّل عملية تتبُّع الأداء.

تحديد المشاكل في الإعداد وحلّها

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

Use the Chrome DevTools troubleshooting skill to fix my setup.

أو يمكنك أن تكون أكثر تحديدًا:

I'm having trouble with Chrome DevTools for agents. I tried to run [Tool Name]
but got the error: [Error Message]. I am on [OS Name]. Use the Chrome DevTools
troubleshooting skill to fix my setup.

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

لتخصيص الإعداد، راجِع الإعداد.