محتويات الدليل
المتصفح أداة منظمة للوكيل
يوفر Playwright MCP واجهة تتحكم بمتصفح حقيقي من خلال بروتوكول MCP. بدلاً من الاعتماد على وصف عام لمحتوى الصفحة، يستطيع الوكيل استدعاء أدوات لفتح عنوان محدد وقراءة لقطة بنيوية لعناصر الصفحة ثم التفاعل مع عنصر معروف. تستخدم الآلية شجرة إمكانية الوصول لتقديم أسماء الأزرار والحقول والروابط ومراجع العناصر، وهي طريقة مفيدة للمهام التي تحتاج تتابع خطوات واضحاً. يصلح ذلك لتجربة واجهات التطبيقات والتحقق من النماذج وتنفيذ إجراءات داخل مواقع التطوير أو الاختبار. وتظل النتيجة مرتبطة بالموقع الفعلي وحالة المتصفح وإعدادات الجلسة.
جدول المحتويات
مجموعة أدوات التفاعل
تتضمن الأدوات الأساسية الموثقة browser_navigate للتوجه إلى صفحة وbrowser_snapshot لفحص بنيتها وbrowser_find للبحث داخل اللقطة، إضافة إلى browser_click وbrowser_type وbrowser_fill_form وbrowser_select_option وbrowser_press_key. تتوافر وظائف لالتقاط الصور وإدارة التبويبات والتعامل مع نوافذ الحوار وفحص رسائل وحدة التحكم وطلبات الشبكة، بحسب التكوين. تساعد هذه الأدوات على تقسيم المهمة إلى خطوات يمكن للمستخدم مراجعتها. ومن المهم التمييز بين البيانات المعروضة للقراءة وإجراء فعلي مثل النقر أو رفع ملف أو ملء نموذج، إذ قد ينتج عن الفعل تغيّر في بيانات التطبيق.
تجربة عملية لواجهة ويب
يمكن بدء اختبار صغير بفتح صفحة تجريبية، ثم طلب قائمة الحقول والأزرار التي يراها المتصفح. بعد تحديد الحقل المطلوب من اللقطة البنيوية، يملؤه الوكيل بنص اختبار ويضغط زر الإرسال، ثم يعيد فحص الصفحة للتأكد من ظهور الأثر المتوقع. يستطيع المطور استخدام هذه الخطوات لتحليل نموذج يتعطل أو صفحة تحمل رسائل خطأ أو اختبار تغير في واجهة الموقع. تعرض الوثائق مثال تطبيق TodoMVC للتدريب على هذه العمليات. ويفضل تنفيذ السيناريو على بيانات اختبارية تفصلها بيئة مستقلة عن حسابات العملاء والبيانات الإنتاجية.
وضع التشغيل والمتصفحات
يتاح الخادم عبر حزمة @playwright/mcp على npm، ويمكن إضافته إلى عميل MCP باستخدام npx. وتعرض وثائق Playwright طريقة تشغيل اعتيادية بمتصفح مرئي، إلى جانب خيار –headless للعمل دون واجهة ظاهرة، واختيار متصفح مختلف من قائمة Chrome وFirefox وWebKit وEdge بحسب التثبيت والدعم. يشرح التوثيق أيضاً نمط تشغيل خادم محلي عبر HTTP بالمعامل –port، وعنوان مثال على الجهاز المحلي من نوع localhost يتبعه المسار /mcp. يتطلب التنفيذ وجود بيئة تشغيل للمتصفح وإعداداته، وقد يحتاج تنزيل المتصفح المستخدم في المرة الأولى.
الكوكيز والجلسات ونطاق الوصول
قد يحتفظ المتصفح في الوضع الدائم بحالة تسجيل الدخول وملفات تعريف الارتباط بين الجلسات، وتتيح الإعدادات استخدام ملف تعريف معزول لبدء جلسات جديدة. لهذا السبب ينبغي الفصل بين استخدام المتصفح للأبحاث العامة وبين دخوله إلى أنظمة داخلية أو حسابات شخصية. ويمكن ضبط خيارات المتصفح والسياق والشبكة بحسب إمكانات التكوين الموثقة. التفاعل مع مواقع خارجية قد يعرّض الوكيل لتعليمات مضمنة داخل الصفحة لا تمثل طلب المستخدم، ولذلك تحتاج الأفعال الحساسة إلى مراجعة بشرية واضحة. يجب التعامل مع رفع الملفات وإرسال النماذج والعمليات التي تغير الحالة على أنها إجراءات ذات صلاحيات ملموسة.
أفضل مواضع الاستفادة والحدود
يخدم Playwright MCP المطور الذي يريد فحص واجهة فعلية، ومهندس الاختبارات الذي يجمع خطوات قابلة للتكرار، وفريق الدعم الذي يحتاج فهم سلوك نموذج أو صفحة. يتيح المشروع مراجعة لقطة الصفحة ورسائل الشبكة قبل اتخاذ إجراء، ويساعد ذلك على تقليل التخمين أثناء تتبع مشكلة. ومع هذا تظل الاختبارات بحاجة إلى شروط بداية واضحة وبيانات مناسبة ومراجعة لنتائج التنفيذ؛ صفحات الويب ديناميكية وقد يتغير ترتيب عناصرها. المشروع مفتوح المصدر بترخيص Apache-2.0، ويعمل محلياً دون اشتراك إلزامي في خدمة Playwright MCP، بينما تتحمل الجهة المشغلة تكاليف موارد المتصفح وأي خدمات خارجية متصلة.
- الاسم الرسمي
- Playwright MCP
- النماذج والمزودون
- محايد للنموذج؛ يعمل مع عملاء MCP القادرين على تشغيل stdio أو الاتصال بخادم HTTP.
الفائدة العملية
تنفيذ تفاعلات متسلسلة داخل متصفح حقيقي وفحص بنية الصفحة ونتائج الإجراءات من عميل MCP.
أبرز الوظائف
تنقل داخل المواقع وقراءة لقطات شجرة إمكانية الوصول. النقر والكتابة وملء النماذج والقوائم. التقاط الصور وإدارة التبويبات. قراءة رسائل المتصفح وطلبات الشبكة. اختيار وضع headless أو مرئي ومتصفحات متعددة.
لمن يناسب؟
مطورو الويب، مختبرو واجهات المستخدم، فرق ضمان الجودة، ووكلاء البرمجة العاملون في المتصفح.
متطلبات التشغيل
Node.js 20 أو أحدث وفق دليل Playwright؛ عميل MCP؛ بيئة تسمح بتشغيل المتصفح وتنزيله عند الحاجة.
التثبيت من المصدر
1. جهز Node.js ومتصفحاً مدعوماً. 2. أضف خادم MCP بالأمر npx @playwright/mcp@latest إلى عميلك. 3. اختر --headless عند الحاجة للتشغيل دون واجهة. 4. اختبر فتح صفحة TodoMVC وقراءة browser_snapshot.
طريقة التشغيل وأمثلة الاستخدام
1. اطلب فتح عنوان صفحة تجريبية. 2. اقرأ browser_snapshot وحدد مرجع العنصر. 3. استدع browser_click أو browser_fill_form للتفاعل. 4. افحص اللقطة التالية أو طلبات الشبكة للتحقق من النتيجة.
الاعتماديات والأذونات
التحكم في المتصفح والتصفح وملء النماذج ورفع الملفات والتعامل مع الجلسات؛ يخضع الوصول إلى الحسابات لحالة المتصفح والتصاريح.
اعتبارات الأمان
ابدأ بملف تعريف معزول وبيانات اختبار؛ تجنب استخدام جلسة مسجلة الدخول لحساب حساس دون ضرورة؛ راجع إرسال النماذج والتحميل والتنفيذ.
المجانية ورسوم التشغيل
خادم مفتوح المصدر، بلا حصة سحابية معلنة لتنفيذ الأدوات محلياً؛ استخدام موارد الجهاز وخدمات المواقع الخارجية له تكلفته المنفصلة.
القيود
يتطلب بيئة متصفح؛ قد تؤثر تغييرات واجهة الموقع وحالة الجلسة في نتائج الأتمتة. يلزم الحذر مع الإجراءات ذات الأثر الفعلي.
الخبرة المطلوبة
متوسط: إعداد بسيط نسبياً عبر npx، ويتطلب معرفة بالجوانب الأمنية وبسلوك المتصفح.
اتصال MCP وأدواته
- وسيلة اتصال MCP
- stdio
- مصادقة MCP
- دون مصادقة بحسب المصدر
- أدوات MCP المتاحة (سطر لكل أداة)
- browser_navigate: فتح عنوان ويب داخل المتصفح المُدار (تفاعل). browser_navigate_back: العودة إلى الصفحة السابقة (تفاعل). browser_snapshot: إرجاع لقطة لشجرة إمكانية الوصول (قراءة). browser_find: البحث عن نص أو تعبير ضمن لقطة الصفحة (قراءة). browser_click: النقر على عنصر في الصفحة (تفاعل). browser_hover: تحريك المؤشر فوق عنصر (تفاعل). browser_type: كتابة نص في عنصر صفحة (تفاعل). browser_fill_form: ملء حقول نموذج (تفاعل). browser_select_option: اختيار قيمة من قائمة (تفاعل). browser_press_key: محاكاة ضغط مفتاح لوحة المفاتيح (تفاعل). browser_take_screenshot: التقاط صورة من المتصفح (قراءة). browser_tabs: إدارة التبويبات وفق الإجراء المطلوب (تفاعل). browser_handle_dialog: التعامل مع مربعات الحوار (تفاعل). browser_file_upload: رفع ملف عبر نموذج في الصفحة (تفاعل). browser_console_messages: قراءة رسائل وحدة تحكم المتصفح (قراءة). browser_network_requests: استعراض طلبات الشبكة المرصودة (قراءة).
أمر التثبيت الموثق
للعرض والنسخ فقط. راجع الأمر وصلاحياته في مصدر تعليمات التثبيت قبل تنفيذه.
npx @playwright/mcp@latestالتوافق مع وكلاء البرمجة
الحالات التالية توثق ما يعلنه المصدر أو ما سجلته مراجعة مستقلة. لا تعني تجربة تشغيل إلا إذا وُسمت بذلك.
| الوكيل | الحالة | الدليل |
|---|---|---|
| OpenAI Codex | توافق معلن بالمصدر | مصدر التوافق ↗ 2026-10-30 |
| Claude Code | توافق معلن بالمصدر | مصدر التوافق ↗ 2026-10-30 |
| Cursor | توافق معلن بالمصدر | مصدر التوافق ↗ 2026-10-30 |
| GitHub Copilot | توافق معلن بالمصدر | مصدر التوافق ↗ 2026-10-30 |
| Gemini CLI | توافق معلن بالمصدر | مصدر التوافق ↗ 2026-10-30 |
| OpenCode | توافق معلن بالمصدر | مصدر التوافق ↗ 2026-10-30 |
لم يوثق المصدر بقية الوكلاء؛ غياب التوثيق لا يعني عدم الدعم.