Playwright MCP: إكمال أول تنقّل للمتصفح داخل العميل

لمن هذا الدليل

هذا الدليل موجّه لمن يستخدم بالفعل عميل MCP ويستعد لتشغيل متصفح على هذا الجهاز لأتمتة الصفحات. القرار هو هل تربط Playwright MCP بالعميل الحالي الآن، وليس هل تقرأ مقدمة طويلة أولًا. الشرط الأكثر صرامة هو أن يكون Node.js على الجهاز بإصدار 18 أو أحدث؛ إذا كان الإصدار أقدم فلا تواصل كتابة الإعداد. يصف المستودع الأمر بأنه خادم MCP يوفّر أتمتة المتصفح ويفهم الصفحة عبر لقطات إمكانية الوصول لا عبر لقطات الشاشة. يجب أن تقبل أمرين: ستظهر على هذا الجهاز عمليات مرتبطة بالمتصفح، وستُجرى زيارات حقيقية إلى العناوين التي تحددها. إذا كنت تريد فقط تصفّح المستودع ولا تنوي أن ينفّذ العميل أي إجراء متصفح، فهذا المسار لا يناسبك. الأدلة لا تذكر قطاعًا أو وظيفة أو حجم فريق، ولن نُكمل هنا صور مستخدمين متخيّلة.

إكمال أول محاولة في 3 دقائق

استخدم فقط مسار إعداد MCP الرسمي القياسي. افتح موضع إعداد الخوادم في عميل MCP الذي تستخدمه الآن — الأدلة لا تعطي اسم ملف محدد، لذا يكفي مدخل إعدادات MCP لذلك العميل — وأضف خدمة باسم playwright، الأمر npx، والمعامل @playwright/mcp@latest. لا تضع إلى جانبها طريقة تثبيت رئيسية ثانية.

أكّد أولًا أن الجهاز يستوفي Node.js 18 أو أحدث، ثم اكتب كتلة JSON التالية في الإعداد كما هي، متطابقة بايتًا بايتًا، دون تغيير أسماء المفاتيح ودون تغيير المسافات:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

احفظ ثم أعد تشغيل ذلك العميل أو أعد تحميله. إشارة النجاح هي ظهور الاسمين browser_navigate و browser_navigate_back في قائمة الأدوات. لا يُعدّ الاتصال مكتملًا إلا عندما تظهر هذه الأسماء؛ لا تعتبر ظهور نافذة المتصفح أو فتح صفحة دليلًا على اكتمال التثبيت.

بعد الاتصال، نفّذ استدعاءً استكشافيًا واحدًا فقط: استخدم browser_navigate. الأدلة سجّلت اسم الأداة فقط — بلا جدول معاملات، بلا عنوان URL نموذجي، وبلا مسار تراجع — لذلك يجب أن يتبع ما تملؤه وصف الأداة الذي يعرضه العميل في تلك اللحظة. لا تخترع معاملات أو نقاط نهاية. هذا الاستدعاء سيجعل متصفح الجهاز يزور العنوان الذي تقدّمه، ويُنشئ طلبات شبكة وتحميل صفحة، ويترك عمليات مرتبطة بالمتصفح على الجهاز. ليس عملية للقراءة فقط، وليست بلا مخاطر. قبل الاستدعاء يجب أن تؤكد أنك أنت من حدّد العنوان وأن العنوان يقبل أن يُزار. بعد الاستدعاء، نقطة التأكيد هي ما إذا كان هذا الاستدعاء قد أعاد نتيجة. إذا استخدمت بعد ذلك browser_navigate_back فسيتغيّر كذلك الصفحة الحالية للمتصفح وقد يُنشئ طلب شبكة آخر. قبل ذلك الاستدعاء أكّد أن الجلسة الحالية فيها سجل تصفّح يمكن الرجوع إليه.

حالات الاستخدام

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

الحالة الثانية: استخدم browser_navigate_back للعودة إلى الصفحة السابقة. التوقيت هو اكتمال تنقّل للتو في جلسة التصفّح نفسها. الأدلة تعطي كذلك اسم الأداة هذا فقط — بلا واجهة لقائمة التاريخ وبلا مسار تراجع أو undo. إذا لم ينجح تنقّل أمامي بعد، قد يفشل الرجوع أو يصل إلى صفحة لم تتوقعها؛ الأدلة لا تصف الحالة بعد الفشل. هذا الاستدعاء سيغيّر الصفحة الحالية أيضًا وقد يطلب الشبكة مجددًا. قبل الاستدعاء أكّد أنك تنقّلت فعلًا؛ نقطة التأكيد تبقى ما إذا كان هذا الاستدعاء قد أعاد نتيجة.

حدود الاستخدام

الحد الأدنى للتشغيل هو Node.js 18 أو أحدث؛ لا تُجبر إصدارًا أقدم. تتوقف القدرة عند أتمتة المتصفح، والوصف يستخدم لقطات إمكانية الوصول لا لقطات الشاشة. لا تظهر في الأدلة أدوات من نوع لقطة الشاشة، ولا أوامر لإغلاق المتصفح أو تنظيف الجلسة أو إلغاء التثبيت أو undo. لا تفترض غياب الشبكة أو غياب القراءة المحلية أو غياب حد للخصوصية: بمجرد التنقّل ستُزار الموقع المستهدف، وقد يدخل محتوى الصفحة سياق العميل، وستظهر عمليات متصفح على الجهاز. إذا فشلت المحاولة الأولى، راجع أولًا إصدار Node وما إذا كان JSON مطابقًا للقطعة الرسمية بايتًا بايتًا، ثم انظر هل ظهر اسما الأداتين. لا تنتقل إلى طريقة تثبيت لم تظهر في الأدلة. لا تعامل القدرات غير المسماة في الأدلة على أنها مدعومة أصلًا.