جدول المحتويات

"أنجز Claude Code الإصلاح — والآن أنفّذ push يدويًا وأفتح لوحة Vercel في المتصفح…" لتقليل هذا الذهاب والإياب، تقدّم Vercel رسميًا ثلاث أدوات: Vercel MCP (خادم يتيح لأدوات الذكاء الاصطناعي العمل على مشاريعك وعمليات النشر والسجلات في Vercel)، وVercel Plugin (إضافة تمنح Claude Code وCursor وغيرهما معرفة بـ Vercel وأوامر مائلة)، وAgent Skills (حزم تعليمات تُثبَّت بالأمر npx skills add). الأسماء متشابهة والأدوار تبدو متداخلة، لذلك تنتشر شروح مختلطة مثل "اربط Agent Skills عبر MCP".

الخلاصة أولًا: من المفيد التفكير في النشر من وكيل ذكاء اصطناعي إلى Vercel على أنه ثلاث مقاربات. ① تكامل Git (‏git push ← نشر تلقائي) يكفي لمعظم العمل الفردي. ② مباشرة من المحرر (Vercel MCP وVercel Plugin) لمن يريد أن يتولى الذكاء الاصطناعي أيضًا ما يحيط بالنشر: قراءة السجلات والتعامل مع متغيرات البيئة. ③ GitHub Actions مع Claude Code Action للفرق التي تريد أن يُصلح @claude الكود من تعليقات طلب الدمج (PR)، وألا يُنشر شيء إلا بعد اجتياز الاختبارات أو الموافقات. لا يوجد "أفضل" مطلق: الحسم في مقدار ما تسلّمه للذكاء الاصطناعي وأين يوقفه الإنسان.

كُتبت هذه المقالة بعد إعادة قراءة الوثائق الأصلية لـ Vercel وAnthropic في 30 سبتمبر 2026. أمثلة الإعداد والأوامر وشروط الخطط كما كانت في ذلك التاريخ (كلاهما يتغير بسرعة، فتحقق من الصفحات المرتبطة قبل الاعتماد عليها). ومن القراءات المكمّلة: الذكاء الاصطناعي يوصي بـ Vercel وما هو Cursor وهل يستطيع الذكاء الاصطناعي إدارة البنية التحتية؟.

AI AGENT × VERCEL

ثلاثة سير عمل — فردي / تشغيل يومي / فريق

— كم تسلّم للذكاء الاصطناعي، وأين يوقفه الإنسان

المقاربة 1 · الحد الأدنى
تكامل Git
تنفّذ push فتبني Vercel. رابط معاينة لكل PR
المقاربة 2 · التشغيل اليومي
MCP / Plugin
يتولى الذكاء الاصطناعي النشر والسجلات وenv. تسجيل الدخول عبر OAuth
المقاربة 3 · الفريق
Actions
‏@claude يُصلح ← الفحوص تجيز النشر. يندمج مع ثقافة المراجعة

أيًّا كانت المقاربة، القاعدة الأساسية هي الأتمتة حتى المعاينة، والإنتاج يوافق عليه إنسان.
وثائق MCP الخاصة بـ Vercel نفسها تنصح بتفعيل التأكيد البشري دائمًا.

1. ‏"Agent Skills" و"MCP" و"Plugin" أشياء مختلفة

حتى لو كتب الذكاء الاصطناعي الكود، فإن التحقق من النشر يجري على شاشة أخرى: العودة إلى الطرفية لتنفيذ git add . && git commit -m "fix" && git push، ثم فتح لوحة Vercel في المتصفح، ونسخ رابط المعاينة ولصقه في Slack. أضافت Vercel تدريجيًا مداخل مصمَّمة للذكاء الاصطناعي لتقليل هذا التنقل.

ترتيبها زمنيًا يزيل الالتباس. في 4 أغسطس 2025 دخل Vercel MCP مرحلة التجربة العامة (إعلان Vercel)، وهو خادم MCP بعيد يعتمد مصادقة OAuth على العنوان https://mcp.vercel.com. وفي الشهر نفسه، أغسطس 2025، وصلت Claude Code GitHub Action من Anthropic إلى الإصدار 1.0 (وسم v1.0.0 مؤرخ في 2025-08-25). وفي 17 مارس 2026 صدر Vercel Plugin (الإعلان)، ومنذ 23 يوليو 2026 صار Vercel MCP قادرًا على نشر الكود مباشرة (الإعلان).

ثم إن Agent Skills ليست MCP. تصفها صفحة Agent Skills لدى Vercel بأنها قدرات مُحزَّمة تُثبَّت بالأمر npx skills add <owner/repo> لتعليم الوكيل طريقة عمل محددة، وتعمل في أكثر من 18 وكيلًا منها Claude Code وGitHub Copilot وCursor. إذا كان MCP وسيلة التنفيذ على حسابك، فإن Skills هي المعرفة بكيفية العمل. انظر أيضًا ما هو MCP وClaude Agent SDK.

2. مداخل Vercel الخمسة — ماذا يفعل كل منها وكيف يُصادَق عليه

هذه هي الطرق التي يصل بها وكيل الذكاء الاصطناعي إلى Vercel كما تصفها الوثائق الرسمية (حتى 30 سبتمبر 2026). عمود المصادقة — أي ما تسلّمه للذكاء الاصطناعي — هو ما يحدد حجم الضرر عند وقوع خطأ.

المدخلماذا يفعلطريقة الإضافةالمصادقةالشروط والتنبيهات
تكامل Git (Vercel for GitHub وغيره)بناء ونشر مع كل push. روابط معاينة في طلبات الدمج، وتراجع للإنتاجاستيراد المستودع من اللوحةتطبيق GitHub (لا يُسلَّم شيء للذكاء الاصطناعي)في المستودعات الخاصة يجب أن يملك كاتب الـ commit صلاحية على جانب Vercel
Vercel CLIكل شيء، بما في ذلك vercel deploy وvercel env وvercel rollbacknpm i -g vercelتسجيل دخول تفاعلي؛ وفي CI يُستخدم VERCEL_TOKENالرموز قوية الصلاحية. احفظها في أسرار CI
Vercel MCPيستدعي أدوات لإنشاء عمليات النشر وسردها، وقراءة سجلات البناء والتشغيل، وإدارة متغيرات البيئة، والتراجع وغير ذلكتسجيل https://mcp.vercel.com في العميلOAuth (تسجيل الدخول في المتصفح واختيار الفرق المسموح بها)تجريبي. لا يتصل إلا العملاء الذين راجعتهم Vercel ووافقت عليهم. يحصل على صلاحيات حسابك في Vercel نفسها
Vercel Pluginمعرفة بـ Vercel (28 skill)، و3 وكلاء متخصصين، و5 أوامر مائلةnpx plugins add vercel/vercel-pluginيعمل عبر Vercel CLI المحلي لديكيتطلب Node.js 18 أو أحدث وBun. يدعم Claude Code وCursor وCodex CLI وVS Code وغيرها
Agent Skillsتعليمات لمهام محددة (مثل vercel-deploy وvercel-cli)npx skills add vercel-labs/agent-skillsلا تحمل Skills بيانات اعتماد خاصة بهاالتنفيذ الفعلي يقوم به CLI أو MCP

المصادر: Vercel MCP، مرجع أدوات MCP، Vercel Plugin، Agent Skills، لماذا لا تُطلق الـ commits النشر (قاعدة معارف Vercel).

كيف تقرأ الجدول: إن كان كل ما تحتاجه هو "أن يُنشر"، فتكامل Git يكفي. تظهر قيمة MCP وPlugin حين تريد أن تشمل المحادثة ما يحيط بالنشر: أن يقرأ الذكاء الاصطناعي السجلات ليعرف سبب فشل البناء، وعرض الفروق في متغيرات البيئة، وإرجاع الإنتاج خطوة إلى الوراء.

3. المقاربات الثلاث في لمحة

إليك المقاربات الثلاث وفق ما يُسلَّم للذكاء الاصطناعي × عمق الأتمتة × أين يوقفه الإنسان.

المقاربةما يحصل عليه الذكاء الاصطناعيالأتمتةأين يوقفه الإنسانالأنسب لـ
1. تكامل Gitصلاحية push في git فقط★★☆☆☆عند الدمج في mainالعمل الفردي والفرق الصغيرة
2. MCP / Pluginصلاحيات حسابك في Vercel (‏OAuth) أو تسجيل دخولك في CLI★★★★☆عند تأكيد كل استدعاء أداةمن يريد أن يتولى الذكاء الاصطناعي تحليل السجلات وإدارة env
3. Actionsأسرار المستودع (مفتاح API، ومعه VERCEL_TOKEN عند الحاجة)★★★★★عند مراجعة طلب الدمج وبوابات الفحصالفرق التي تعدّ مراجعة طلبات الدمج روتينًا

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

4. المقاربة 1: تكامل Git (نشر تلقائي عند git push)

أبسط إعداد. اربط Vercel بـ GitHub، فتبني Vercel مع كل git push وتنشر عند انتهاء البناء. عمل الذكاء الاصطناعي يقتصر على كتابة الكود وكتابة رسالة الـ commit وتنفيذ push. ويقول دليل GitHub Actions من Vercel نفسه إنه لأن تكامل Git يتولى بالفعل روابط المعاينة والنشر غير القابل للتعديل والتراجع الفوري، فإن معظم الفرق لا تحتاج إلى خط أنابيب أصلًا.

# الإعداد (مرة واحدة)
1. Vercel dashboard → Add New → Project
2. اختر مستودع GitHub → Import
3. Framework Preset: اكتشاف تلقائي (Next.js وغيره)
4. Environment Variables: أضف ما تحتاجه
5. Deploy

# سير العمل اليومي (داخل Cursor / Claude Code)
> اجعل هذا الزر أحمر. عند الانتهاء نفّذ push إلى فرع feature/red-button.

# الأوامر التي ينفذها الذكاء الاصطناعي
git switch -c feature/red-button
git add app/components/Button.tsx
git commit -m "feat: change primary button to red"
git push -u origin feature/red-button

# تبني Vercel معاينة ← يحصل طلب الدمج على رابط معاينة

القيمة الحقيقية هنا أن كل فرع يحصل تلقائيًا على رابط معاينة. روابط المعاينة في Vercel نوعان: رابط الفرع الذي يشير دائمًا إلى أحدث ما فيه، ورابط الـ commit الذي يشير إلى ذلك النشر بعينه (Environments). إذا كان الدمج في main وحده ما يذهب إلى الإنتاج، فيمكن للذكاء الاصطناعي تنفيذ push بقدر ما يشاء ويبقى كل شيء عند المعاينة.

تنبيه: خطة Hobby مقصورة على الاستخدام الشخصي غير التجاري (خطة Hobby). يمكن إنشاء 100 عملية نشر يوميًا في Hobby و6,000 في Pro، وتنفّذ Hobby عملية بناء واحدة في كل مرة (Limits). إذا ترك الذكاء الاصطناعي ينفّذ push بخطوات صغيرة جدًا، فستصطدم بهذه الحدود أولًا. ولفخاخ الأسعار راجع القسم 5 من الذكاء الاصطناعي يوصي بـ Vercel.

5. المقاربة 2: مباشرة من المحرر (Vercel MCP وVercel Plugin)

لكي يتولى الذكاء الاصطناعي ما يحيط بالنشر، استخدم Vercel MCP أو Vercel Plugin. لا يتطلب أي منهما كتابة رمز في ملف.

إعداد Vercel MCP (‏Cursor): وفق التعليمات الرسمية يكفي وضع رابط واحد في .cursor/mcp.json (على مستوى المشروع أو على مستوى الجهاز).

{
  "mcpServers": {
    "vercel": {
      "url": "https://mcp.vercel.com"
    }
  }
}

بعد الإضافة يحاول Cursor الاتصال ويعرض Needs login. انقر عليه لتسجيل الدخول إلى Vercel في المتصفح واختيار الفرق التي يُسمح لـ Cursor باستخدامها. وفي Claude Code يكفي سطران:

claude mcp add --transport http vercel https://mcp.vercel.com
# ثم شغّل claude وصادِق عبر /mcp

تذكر الوثائق أيضًا npx add-mcp https://mcp.vercel.com الذي يسجّل الخادم في عدة عملاء دفعة واحدة. انتبه: إضافة الخادم لا تُكمل التفويض. إلى أن تسجّل الدخول وتمنح الوصول إلى فريق ما، لا يرى الذكاء الاصطناعي عمليات نشره ولا سجلاته (مرجع الأدوات).

يوفّر MCP أدوات، لا أوامر مائلة. تطلب مثلًا "افحص أخطاء آخر عملية نشر"، فيختار الذكاء الاصطناعي أدوات كهذه ويستدعيها (مقتطف من القائمة حتى 30 سبتمبر 2026):

ما تريدهأداة Vercel MCP
إنشاء عملية نشر (دون target تكون معاينة)create_deployment
سرد عمليات النشر ومعرفة حالتهاlist_deployments، get_deployment
مخرجات البناء وسجلات التشغيل وأخطاؤهlist_deployment_events، get_runtime_logs، get_runtime_errors
إضافة متغيرات البيئة وتعديلها وسردهاcreate_project_env، edit_project_env، filter_project_envs
إعادة الإنتاج إلى نشر سابقrequest_rollback
رابط مشاركة لمعاينة محميةget_access_to_vercel_url

أما Vercel Plugin (npx plugins add vercel/vercel-plugin) فيضيف معرفة بـ Vercel وخمسة أوامر مائلة ذات مساحة أسماء: /vercel-plugin:deploy (أضف prod للإنتاج)، و/vercel-plugin:env (‏list وpull وadd وremove وdiff)، و/vercel-plugin:status، و/vercel-plugin:bootstrap، و/vercel-plugin:marketplace (Vercel Plugin). وبقراءة تعريف الأمر deploy يتبيّن أنه يشغّل Vercel CLI المحلي لديك (vercel وvercel --prod)، وينشئ معاينة افتراضيًا وينتظر "نعم" صريحة قبل الإنتاج. لا توجد أوامر مثل /logs أو /rollback؛ فالسجلات والتراجع تتم عبر أدوات MCP أو CLI (vercel rollback).

المكسب الحقيقي أن كل شيء يبقى داخل المحادثة. اطلب "أضف هذه الـ API، وانشرها على المعاينة، وإن ظهر خطأ فاقرأ السجلات وأصلحه"، وسيمضي الذكاء الاصطناعي في تعديل الكود ← النشر ← فحص سجل البناء ← الإصلاح ← إعادة النشر. وبمصطلحات هل يستطيع الذكاء الاصطناعي إدارة البنية التحتية؟ فهذه منطقة "قادر لكن خطر". تنص Vercel صراحة على أن اتصال MCP يمنح الذكاء الاصطناعي صلاحيات حساب المستخدم في Vercel نفسها، وتوصي بتفعيل التأكيد البشري دائمًا. لا تجعل استدعاءات الأدوات تُعتمد تلقائيًا.

6. المقاربة 3: GitHub Actions (‏@claude وبوابات الفحص)

إعداد الفرق. مع Claude Code GitHub Actions تذكر @claude في تعليق على issue أو طلب دمج، فيُجري Claude الإصلاح في commit ويرد في النقاش نفسه. أما نشر المعاينة فيبقى من مهمة تكامل Git في المقاربة 1: عندما ينفّذ Claude push إلى فرع طلب الدمج، تعيد Vercel بناء المعاينة.

# الإعداد
1. شغّل /install-github-app داخل Claude Code (لمستودعات github.com فقط)
2. ثبّت Claude GitHub App، واحفظ ANTHROPIC_API_KEY (أو CLAUDE_CODE_OAUTH_TOKEN) في Secrets
3. يصل ملف .github/workflows/claude.yml في صورة pull request

# .github/workflows/claude.yml (مثال من الوثائق الرسمية)
name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    timeout-minutes: 30          # إيقاف المهام الخارجة عن السيطرة (توصية الوثائق)
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write            # مطلوب للمصادقة الافتراضية عبر GitHub App
      actions: read              # قراءة نتائج CI في طلبات الدمج
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          claude_args: "--max-turns 10"   # حد لعدد الأدوار في كل تشغيل

أُضيف timeout-minutes و--max-turns على سبيل المثال، وهما الإجراءان اللذان يوصي بهما قسم "Manage costs" في الوثائق (اضبط القيم بحسب مشروعك). لا يُطبَّق أي حد لعدد الأدوار افتراضيًا، فضعه بنفسك.

إن أردت أن ينشر GitHub Actions أيضًا — فقط حين تحتاج قبل النشر إلى اختبارات أو فحوص أمنية أو ميزانيات أداء أو موافقة بشرية — فاتبع الدليل الرسمي من Vercel. تحتاج إلى ثلاثة أسرار: VERCEL_TOKEN وVERCEL_ORG_ID وVERCEL_PROJECT_ID (الأخيران موجودان في ملف .vercel/project.json الذي ينشئه vercel link).

# .github/workflows/vercel-preview.yml (الصيغة الواردة في قاعدة معارف Vercel)
name: Vercel Preview Deployment
env:
  VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
  VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
on:
  push:
    branches-ignore:
      - main
jobs:
  Deploy-Preview:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm install --global vercel@latest
      - run: vercel pull --yes --environment=preview --token=${{ secrets.VERCEL_TOKEN }}
      # ضع الاختبارات والفحوص هنا
      - run: vercel build --token=${{ secrets.VERCEL_TOKEN }}
      - run: vercel deploy --prebuilt --token=${{ secrets.VERCEL_TOKEN }}

# vercel.json — أوقف النشر الذي يطلقه Git حتى لا يحدث نشر مزدوج
{ "git": { "deploymentEnabled": false } }

يعدّد الدليل نفسه الفخاخ: إذا بقي تكامل Git مفعّلًا بينما ينشر Actions أيضًا، ينطلق الاثنان على الـ commit نفسه؛ ومن دون --prebuilt تبني Vercel الشيء نفسه مرة ثانية. وبالعكس، إن كنت تريد تشغيل الاختبارات فقط، فالأخف أن تُبقي تكامل Git، وتشغّل الاختبارات على المعاينة عند حدث deployment_status، وتستخدم Deployment Checks لحجز الترقية إلى الإنتاج.

# كيف يبدو ذلك عمليًا
# مطوّر يفتح PR ← تكامل Git يبني معاينة
[Bot] Vercel Preview: https://<preview-url>

# مراجِع يعلّق على الـ PR
@claude اجعل هذا الزر يتغير لونه أيضًا عند مرور المؤشر

# يضيف Claude commit ويرد ← تعيد Vercel بناء المعاينة
# المراجِع يتحقق ← approve ← merge ← نشر الإنتاج

تنبيه: في المستودعات الخاصة يجب أن يكون كاتب الـ commit عضوًا في فريق Vercel (وفي Hobby المالك نفسه)، وإلا فلن يُنشر شيء (قاعدة معارف Vercel). إذا لم تُنتج الـ commits المُنشأة داخل Actions معاينة، فافحص أولًا تعليق Vercel Bot وكاتب الـ commit.

بهذا الإعداد يصبح سيناريو "لا يلمس إنسان الكود حتى يكتمل طلب الدمج" واقعيًا. وكما ورد في المخضرمون مقابل المبتدئين وهل سيقضي الذكاء الاصطناعي على الوظائف المكتبية؟، يتفرغ الفريق للمراجعة بينما يتولى الذكاء الاصطناعي التنفيذ.

7. استخدام بيئات المعاينة — فرع ← رابط ← مشاركة

ما يؤتي ثماره في المقاربات الثلاث هو الاستفادة القصوى من بيئات المعاينة. تنشئ Vercel تلقائيًا عمليات نشر معاينة للفروع غير الإنتاجية ولطلبات الدمج، لذلك يمكنك وضع عدة نسخ من التغيير نفسه جنبًا إلى جنب دون إعداد إضافي.

PREVIEW STRATEGY

ثلاثة أنماط لاستخدام بيئات المعاينة

النمط 1 · مقارنة A/B
اصنع نسخة "زر أحمر" ونسخة "زر أزرق" على فرعين، ثم قرّر بمقارنة الرابطين. اطلب من الذكاء الاصطناعي "نسختين، كل منهما على فرعها".
النمط 2 · بيئة staging
استخدم فرعًا مثل develop بيئة staging دائمة. افصل متغيرات بيئة المعاينة حتى لا تمس قاعدة بيانات الإنتاج أبدًا. هذا متاح في كل الخطط بما فيها Hobby.
النمط 3 · مراجعة العميل
احمِ المعاينات بـ Deployment Protection واعرضها على أطراف خارجية برابط مشاركة. الحماية بكلمة مرور غير متاحة في Hobby، وفي Pro تكلّف 20 دولارًا شهريًا لكل مشروع.

يمكن فصل متغيرات البيئة بين Development وPreview وProduction — لا تُدخل قيم staging في الإنتاج.
في Hobby لديك رابط مشاركة واحد فقط للحساب كله.

المصادر: Environments (خيارات staging والخطط)، Password Protection (السعر)، Sharable Links (رابط واحد في Hobby)، وكلها حتى 30 سبتمبر 2026. الحماية الافتراضية دون كلمة مرور هي Vercel Authentication (لا يرى المعاينة إلا أعضاء الفريق)، وتصفها Vercel بأنها الطريقة الموصى بها.

8. أربعة فخاخ — تسرب env، الحدود والتكلفة، التعارضات، التراجع

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

4 PITFALLS

أربعة فخاخ في تشغيل وكلاء الذكاء الاصطناعي

الفخ 1 · تسرب env
الذكاء الاصطناعي يضيف .env إلى git. وعبر MCP تستطيع بعض الأدوات قراءة القيم المفكوكة لمتغيرات البيئة.
العلاج: .env* في .gitignore، وGitHub Push Protection، وإبلاغ الذكاء الاصطناعي "لا تستخدم git add . أبدًا"، وتأكيد كل استدعاء أداة.
الفخ 2 · الحدود والتكلفة
إذا نفّذ الذكاء الاصطناعي push لكل إصلاح صغير، يطلق كل منها عملية بناء. وتتوقف Hobby عند 100 عملية نشر يوميًا.
العلاج: Spend Management في Pro، وإبلاغ الذكاء الاصطناعي "نفّذ push مرة واحدة في النهاية"، وإيقاف النشر التلقائي للفروع غير الضرورية عبر git.deploymentEnabled.
الفخ 3 · تعارضات PR
عدة وكلاء ذكاء اصطناعي يعدّلون الملف نفسه في الوقت نفسه ← تعارضات دمج.
العلاج: طلب دمج واحد = issue واحدة = وكيل واحد، وقواعد لتسمية الفروع، وCODEOWNERS لتعيين مراجعين إلزاميين.
الفخ 4 · نسيان التراجع
الذكاء الاصطناعي ينشر خطأً في الإنتاج ← لا أحد يعرف كيف يتراجع.
العلاج: حدّد مسبقًا إجراء Instant Rollback (في Hobby يعود إلى النشر السابق، وفي Pro وما فوق يمكن اختيار أي نشر إنتاج سابق)، ومراقبة الأخطاء، وموافقة بشرية على الإنتاج.

الحماية الثلاثية: Spend Management (Pro) + Deployment Checks + مراقبة الأخطاء.
جهّز مسبقًا وضعًا "لا يُحدث فيه حتى ذكاء اصطناعي خارج عن السيطرة ضررًا قاتلًا".

المصادر: أدوات MCP لمتغيرات البيئة (تُعيد get_project_env القيمة مفكوكة)، Spend Management (دون تكلفة إضافية في Pro وبعض خطط Enterprise؛ يُفحص الاستهلاك كل بضع دقائق، لذا يأتي الإيقاف المؤقت متأخرًا قليلًا)، Instant Rollback، إعدادات Git.

النصيحة الشائعة "ضع وسيط Cloudflare أمام Vercel" لا نوصي بها وسيلةً للحماية. ففي مقالة رسمية في قاعدة المعارف تقول Vercel إنها لا توصي بوضع وسيط خارجي في المقدمة، لأن Vercel Firewall يفقد الرؤية الكاملة لحركة المرور ويتراجع الأداء.

تنبيه إضافي: لا نوصي بأتمتة النشر إلى الإنتاج بالذكاء الاصطناعي بالكامل. حتى في المقاربتين ② و③، أبقِ الموافقة النهائية على الإنتاج بيد إنسان. وكما ورد في ما لا ينبغي إعطاؤه للذكاء الاصطناعي، قد يكسر الذكاء الاصطناعي الإنتاج بـأخطاء لا سوء نية فيها. أتمِت حتى المعاينة وstaging، واشترط موافقة بشرية للإنتاج — أي بوابة من مرحلتين.

الخلاصة

عند التفكير في النشر إلى Vercel من Claude Code أو Cursor، ميّز أولًا بين تكامل Git وCLI وVercel MCP وVercel Plugin وAgent Skills. فـ MCP هو وسيلة التنفيذ ويتصل عبر OAuth، وPlugin يجلب أوامر /vercel-plugin:* والمعرفة، وSkills تعليمات. أما النشر ذاته فيكفيه تكامل Git في معظم الحالات.

يتوقف الاختيار على مقدار ما تسلّمه للذكاء الاصطناعي وأين يوقفه الإنسان: ① عمل فردي ← تكامل Git؛ ② تريد أن يتولى الذكاء الاصطناعي تحليل السجلات وإدارة env ← Vercel MCP / Plugin (لا رموز في الملفات، بل تسجيل دخول عبر OAuth)؛ ③ فرق تعدّ مراجعة طلبات الدمج روتينًا ← GitHub Actions (‏@claude يُصلح، والنشر يأتي من تكامل Git، أو من Actions مع CLI حين تلزم بوابات فحص). استخدم المعاينات في مقارنة A/B وstaging ومراجعة العميل، وواجه الفخاخ الأربعة بـتأكيد استدعاءات الأدوات، وضبط الحدود والإنفاق، وإجراء للتراجع، وموافقة بشرية على الإنتاج.

مقالات ذات صلة: الذكاء الاصطناعي يوصي بـ Vercel، Vercel AI SDK، v0 مقابل Bolt مقابل Lovable، ما هو Cursor، هل يستطيع الذكاء الاصطناعي إدارة البنية التحتية؟.

الأسئلة الشائعة

س. هل يمكن فعل الشيء نفسه مع استضافات أخرى (Cloudflare وNetlify)؟
ج. نعم. كلتاهما تنشر خوادم MCP رسمية. تدير Cloudflare مجموعة من خوادم MCP البعيدة التي يُتصل بها عبر OAuth، منها خادم لعمليات بناء Workers (خوادم MCP من Cloudflare). ولدى Netlify خادم Netlify MCP Server. اختر بحسب ملاءمة إطار العمل والسعر، لا بحسب وجود تكامل مع الوكلاء. وانظر أيضًا معايير الذكاء الاصطناعي يوصي بـ Vercel.

س. أيهما أنسب للنشر إلى Vercel: Claude Code أم Cursor؟
ج. كلاهما مدعوم في Vercel MCP وVercel Plugin، لذا فما يمكن فعله على جانب Vercel متقارب جدًا. الفرق في أسلوب العمل: Claude Code يتمحور حول الطرفية وله تكامل رسمي مع GitHub Actions، وCursor يتمحور حول المحرر ويضيف MCP بنقرة واحدة. إن كنت تعيش في VS Code فـ Cursor أقرب إليك، وإن كنت تعيش في الطرفية فـ Claude Code.

س. هل يمكن ترك الذكاء الاصطناعي يؤتمت النشر إلى الإنتاج بالكامل؟
ج. لا يُنصح بذلك. أتمِت حتى المعاينة وstaging، لكن أبقِ دائمًا الموافقة النهائية على الإنتاج بيد إنسان. والسبب أن الذكاء الاصطناعي قد يكسر الإنتاج دون أي سوء نية، وأن المسؤولية تصبح غامضة عند وقوع حادث. استخدم GitHub Branch Protection لمنع push المباشر إلى main واشتراط طلبات دمج معتمدة.

س. هل يمكن إضافة .cursor/mcp.json إلى git؟
ج. مع الإعداد الرسمي لـ Vercel MCP لا يحتوي الملف على أي أسرار. ففيه الرابط https://mcp.vercel.com فقط، والمصادقة تتم عبر OAuth وتبقى في جانب المتصفح، لذا لا بأس بإضافته إلى المستودع لمشاركته مع الفريق. يختلف الأمر إن كتبت مفتاح API لخادم MCP آخر مباشرة في ترويسة؛ فذلك الملف لا يدخل git. واحفظ VERCEL_TOKEN المستخدم في CI ضمن GitHub Secrets، لا في ملف سير العمل.

س. أنا قلق من تكلفة GitHub Actions.
ج. بحسب الوثائق الرسمية تأتي التكلفة من أمرين: دقائق GitHub Actions ورموز Claude API (إذا صادقت برمز OAuth من اشتراك، تستهلك عمليات التشغيل اشتراكك في Claude بدل فوترة API). ويتوقف المبلغ لكل تشغيل على طول الموجّه وتعقيد المهمة وحجم الكود. ومن طرق خفضها التي تذكرها الوثائق: تحديد عدد الأدوار بـ --max-turns في claude_args، وضبط مهلة لسير العمل، وكتابة طلبات محددة لـ @claude، وإبقاء CLAUDE.md موجزًا. لا يوجد حد للأدوار افتراضيًا، فضعه بنفسك.