Skip to content

Vercel × وكيل برمجة بالذكاء الاصطناعي: ثلاثية Plugin و Skills و MCP ​

الهدف في جملة واحدة: باستخدام ثلاثة أوامر رسمية، ثبّت ثلاثية Plugin و Skills و MCP من Vercel في وكيل البرمجة بالذكاء الاصطناعي لديك، ليتولى إدارة مشاريع Vercel الخاصة بك مباشرة، ويوفر عليك عناء التبديل ذهابًا وإيابًا بين الطرفية ونافذة المحادثة.

التحضير ​

قبل البدء، تأكد من ثلاثة أمور:

  1. أن npx يعمل في الطرفية (ما يعني أن Node.js مثبت بالفعل)؛ وإذا ظهرت رسالة command not found، فثبّت Node.js أولًا قبل المتابعة.
  2. بعد قراءة الدليل المتقدم: اجعل الذكاء الاصطناعي يفهم مشروعك أكثر، يكون وكيل البرمجة بالذكاء الاصطناعي مهيأ بالفعل في المشروع (مثل Claude Code).
  3. يُنصح بالاطلاع أولًا على النشر على Vercel: نشر بأمر واحد عبر وكيل برمجة بالذكاء الاصطناعي لفهم الأساسيات المتعلقة بنشر الوكيل على Vercel.

كل عنصر من الثلاثية مسؤول عن جزء: Plugin يمنح الوكيل القدرات الرسمية من Vercel، و Skills يوفر الممارسات القياسية التي جمعتها الجهة الرسمية، و MCP يتولى ربط الوكيل بمشاريع Vercel الخاصة بك. الأوامر الثلاثة كلها من Vercel الرسمية وتكتب الإعدادات تلقائيًا، فلا حاجة لتعديل الملفات يدويًا؛ نفّذها بالترتيب في الدليل الجذري للمشروع.

اتبع الخطوات معي ​

الخطوة 1: تثبيت Vercel Plugin ​

نفّذ في الدليل الجذري للمشروع:

bash
npx plugins add vercel/vercel-plugin

في المرة الأولى سيتم تنزيل الحزمة أولًا ثم تثبيتها، فانتظر قليلًا. النتيجة المتوقعة: ينتهي الأمر دون أخطاء، وتدخل حزمة الإضافة vercel/vercel-plugin في إعدادات الوكيل، ويصبح الوكيل قادرًا في المحادثات اللاحقة على التعرف على المهام المتعلقة بـ Vercel.

الخطوة 2: إضافة Agent Skills ​

ثم نفّذ:

bash
npx skills add vercel-labs/agent-skills

سيضع هذا حزمة المهارات التي تديرها Vercel رسميًا vercel-labs/agent-skills تحت تصرف الوكيل. وفقًا للتوثيق الرسمي، هذا الأمر موجه أساسًا للوكلاء غير المدرجين في قائمة دعم Plugin؛ أما الوكلاء المدرجون في القائمة (Claude Code و Codex و Cursor و GitHub Copilot وغيرها) فقد حصلوا بالفعل، بعد تثبيت Plugin في الخطوة 1، على مهارات النشر وأفضل ممارسات الأطر. النتيجة المتوقعة: تُضاف المهارات بنجاح، ويصبح لدى الوكيل مرجع رسمي عند التعامل مع المهام الشائعة في مشاريع Vercel، بدلًا من الاعتماد كليًا على ذاكرة النموذج والاجتهاد الحر.

الخطوة 3: الاتصال بخادم Vercel MCP ​

أخيرًا نفّذ:

bash
npx -y add-mcp https://mcp.vercel.com -g

يسجل هذا الأمر خادم MCP الرسمي من Vercel (Model Context Protocol) https://mcp.vercel.com في الوكيل؛ يجعل -y npx يتخطى تأكيد التنزيل فيمكن نسخ الأمر كما هو، ويعني -g أن التسجيل يسري عالميًا، فتتمكن جميع المشاريع بعده من الاتصال به. @@I18N_KEEP_000009@@النتيجة المتوقعة: يُظهر الأمر رسالة نجاح الإضافة، ويظهر mcp.vercel.com في قائمة خوادم الوكيل.

التحقق ​

افتح جلسة وكيل جديدة (الإعدادات الجديدة لا تُحمّل تلقائيًا)، وأصدر الأمر مباشرة:

ألقِ نظرة على حالة المشاريع على Vercel، ثم انشر المشروع الحالي عليها.

إذا بدأ الوكيل في استدعاء الأدوات المتعلقة بـ Vercel بدلًا من إلقاء أمر إليك لتشغيله بنفسك، فثلاثية Vercel MCP قد ضُبطت بنجاح؛ وبعد اكتمال النشر اطلب منه إرسال الرابط الإلكتروني إليك، وافتحه للتأكد من أن الصفحة تعمل بشكل سليم. إذا كنت تستخدم Claude Code، يمكنك أيضًا إدخال /mcp لعرض حالة اتصال الخادم. @@I18N_KEEP_000010@@

إذا قال الوكيل إنه لا يجد الأدوات ذات الصلة، فارجع إلى الخطوة 3 للتأكد من نجاح تنفيذ الأمر، ثم افتح جلسة جديدة وحاول مرة أخرى.

المزالق الشائعة ​

  • الدليل الخاطئ: يجب تنفيذ الأوامر الثلاثة في الدليل الجذري للمشروع، ولا تُشغّلها في دليل فرعي أو في مشروع آخر.
  • توقف npx عند رسالة التأكيد: الأمر الثالث يتضمن -y للتأكيد التلقائي؛ أما الأمران الأولان، فإذا سألا عن تثبيت الحزمة، اكتفِ بالتأكيد حسب الرسالة الظاهرة.
  • لا يتغير الوكيل بعد التثبيت: لا يحمّل الوكيل الإعدادات الجديدة تلقائيًا، فافتح جلسة جديدة وحاول مجددًا.
  • فشل الاتصال بـ MCP: قد يطلب الاتصال الأول بـ mcp.vercel.com إكمال تفويض حساب Vercel، فاتبع التعليمات التي يعرضها الوكيل لإكمال العملية ثم أعد المحاولة. @@I18N_KEEP_000011@@
  • تثبيت عنصر أو عنصرين فقط: في التوثيق الرسمي يُختار بين Plugin و Skills حسب الوكيل (Plugin للوكلاء المدرجين في قائمة الدعم، و Skills لغير المدرجين)، فلا حاجة لتثبيت كليهما؛ أما MCP فيتولى بشكل مستقل ربط الوكيل بمشاريع Vercel الخاصة بك، ويُنصح بإعداده.

الدرس التالي ​

في هذه المرحلة، أصبح الوكيل قادرًا على إدارة Vercel نيابة عنك مباشرة. في الدرس التالي النطاق المخصص: من github.io إلى نطاقك الخاص، ستستبدل العنوان المؤقت الناتج عن النشر بنطاقك الخاص. وإذا أردت تعزيز فهم الوكيل لهذا المشروع أكثر، يمكنك استخدامه مع AGENTS.md و CLAUDE.md: اترك للذكاء الاصطناعي دليلًا للمشروع.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.