/ الدليل / الملعب / Webiny MCP
← كل الخوادم ↗ GitHub
● رسمي webiny 🔑 يتطلب مفتاحك

Webiny MCP

بواسطة webiny · webiny/webiny-js

تحدَّث إلى نظام إدارة المحتوى Webiny من Claude — أنشئ نماذج المحتوى وعدِّل المدخلات بشكل مجمَّع وابنِ الصفحات دون النقر في واجهة المشرف.

Webiny هو نظام إدارة محتوى headless بدون خادم على AWS، ويعرض خادم MCP الخاص به واجهة GraphQL للمشرف كأدوات لوكلاء الذكاء الاصطناعي. بدلاً من تعليم Claude كيفية كتابة GraphQL الخاص بـ Webiny يدوياً، تحصل على أدوات مُكتَّبة لنماذج المحتوى والمدخلات وصفحات Page Builder ومدير الملفات وسير عمل النشر APW — كلها مدعومة بـ token المصادقة الخاص بك.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

webiny-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "webiny-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@webiny/mcp-server",
        "--api-url",
        "https://your-project.cloudfront.net/cms/manage/en-US",
        "--token",
        "${WEBINY_TOKEN}"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "webiny-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@webiny/mcp-server",
        "--api-url",
        "https://your-project.cloudfront.net/cms/manage/en-US",
        "--token",
        "${WEBINY_TOKEN}"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "webiny-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@webiny/mcp-server",
        "--api-url",
        "https://your-project.cloudfront.net/cms/manage/en-US",
        "--token",
        "${WEBINY_TOKEN}"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "webiny-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@webiny/mcp-server",
        "--api-url",
        "https://your-project.cloudfront.net/cms/manage/en-US",
        "--token",
        "${WEBINY_TOKEN}"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "webiny-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@webiny/mcp-server",
        "--api-url",
        "https://your-project.cloudfront.net/cms/manage/en-US",
        "--token",
        "${WEBINY_TOKEN}"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "webiny-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@webiny/mcp-server",
          "--api-url",
          "https://your-project.cloudfront.net/cms/manage/en-US",
          "--token",
          "${WEBINY_TOKEN}"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add webiny-mcp -- npx -y @webiny/mcp-server --api-url https://your-project.cloudfront.net/cms/manage/en-US --token ${WEBINY_TOKEN}

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

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

استخدامات عملية: Webiny MCP

بناء نموذج محتوى جديد من وصف

👤 مطورو Webiny / مهندسو المحتوى ⏱ ~25 min intermediate

متى تستخدمه: يقول مدير المنتج 'نحتاج قسم دراسات حالة بهذه الحقول'. تريد من Claude ترجمة ذلك إلى نموذج Webiny.

المتطلبات الأساسية
  • مشروع Webiny يعمل — npx create-webiny-project منشور على AWS
  • token الوصول الشخصي — أنشئه في Admin → Settings → Personal Access Tokens
الخطوات
  1. توصيل MCP
    Add Webiny MCP using the manage API URL for dev environment. Verify it can list existing models.✓ تم النسخ
    → يُعيد list_models على الأقل النماذج المدمجة
  2. بناء النموذج
    Create a CaseStudy content model with fields: title (text, required), client (text), summary (rich text), heroImage (file ref), publishedAt (datetime), tags (text, multi). Singular Case Study, plural Case Studies.✓ تم النسخ
    → استدعاء create_content_model مرة واحدة؛ معرِّفات الحقول تستخدم camelCase باتساق
  3. إضافة مدخلات تجريبية
    Now add 3 placeholder entries so the editorial team has something to look at.✓ تم النسخ
    → 3 مدخلات مُنشأة عبر create_entry بمحتوى تجريبي واقعي

النتيجة: نموذج يعمل + بيانات تجريبية جاهزة لفريق التحرير في دقائق بدلاً من النقر في واجهة المشرف.

المزالق
  • معرِّفات الحقول تحتوي مصادفةً على مسافات — يرفضها Webiny؛ يُطبِّع MCP لكن راجع دائماً قبل الحفظ
  • اللغة الخاطئة في URL — يحمل URL المسار /en-US/ — طابق لغتك الافتراضية
اجمعها مع: filesystem

التحديث المجمَّع للمدخلات لإصلاح خطأ إملائي في 200 دراسة حالة

👤 فريق عمليات المحتوى ⏱ ~30 min intermediate

متى تستخدمه: أشار الفريق القانوني إلى اسم شركة خاطئ في المدخلات القديمة؛ لا تريد النقر 200 مرة.

الخطوات
  1. البحث عن المدخلات المتأثرة
    Webiny: search CaseStudy entries containing 'Acme Corp' in summary. List IDs.✓ تم النسخ
    → يُعيد search_entries جميع المعرِّفات المطابقة
  2. تجربة الاستبدال
    For each, propose the new summary replacing 'Acme Corp' with 'Acme Inc.' Show me 3 examples first.✓ تم النسخ
    → 3 فروق معروضة قبل أي عملية كتابة
  3. التطبيق
    Looks right. Apply the change to all matching entries and republish.✓ تم النسخ
    → استدعاء update_entry + publish_entry لكل مدخل مع عداد تقدم

النتيجة: إصلاح ونشر مئات المدخلات في محادثة واحدة مع سجل تدقيق.

المزالق
  • النشر التلقائي يتخطى المراجعة — استخدم مسودة + سير عمل APW — لا تنشر تلقائياً التحريرات المجمَّعة على الإنتاج

إنشاء صفحة هبوط في Page Builder من ملخص

👤 مطورو التسويق ⏱ ~20 min intermediate

متى تستخدمه: لديك نسخة تسويقية وتريد ربطها بـ Page Builder في Webiny دون سحب الكتل.

المتطلبات الأساسية
  • قوالب كتل موجودة — احرص على تعريف كتل Hero وFeatures وCTA على الأقل
الخطوات
  1. تأليف الصفحة
    Create a Page Builder page titled 'Q2 Launch' using Hero + 3 Features + CTA blocks. Fill content from /briefs/q2.md.✓ تم النسخ
    → يُعيد create_page رابط مسودة
  2. المعاينة والنشر
    Open the draft URL. Once approved, publish it.✓ تم النسخ
    → ينجح publish_page؛ الصفحة تعيش

النتيجة: صفحة هبوط تسويقية مُجمَّعة ومنشورة في ~10 دقائق.

المزالق
  • انجراف مخطط الكتل — شغِّل list_block_templates أولاً دائماً للتأكد من المتغيرات المتاحة
اجمعها مع: filesystem

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

webiny-mcp + filesystem

سحب ملخص من Markdown المحلي ودفعه إلى Webiny كمحتوى صفحة

Read /briefs/q2.md, then create a Webiny Page using Hero + Features + CTA with content from the brief.✓ تم النسخ
webiny-mcp + github

فتح PR بتغييرات النموذج بعد أن يصممها Claude

Webiny: create CaseStudy model. GitHub: open a PR adding the model to the seed config.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_content_models (none) الاستكشاف 1 GraphQL call
create_content_model name, fields[] بناء قسم جديد 1 call
search_entries model, query, filter? البحث عن العناصر المتأثرة 1 call
create_entry model, data كتابة عنصر واحد 1 call
update_entry id, data تعديل عنصر موجود 1 call
publish_entry id رفع المسودة إلى النسخة الحية 1 call
list_block_templates (none) قبل تأليف الصفحات 1 call
create_page title, blocks[] تأليف في Page Builder 1 call

التكلفة والحدود

تكلفة التشغيل

حصة API
مقيَّد بحدود حساب AWS الخاص بك (Lambda concurrency، DynamoDB throughput)
الرموز لكل استدعاء
200–3000 حسب حجم المدخل
التكلفة المالية
Webiny مجاني مفتوح المصدر؛ فاتورة AWS تُطبَّق
نصيحة
العمليات المجمَّعة تتفرع — اضبط حدود Lambda concurrency إذا لم ترد ارتفاع التكاليف

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: personal-access-token with content read/write
تخزين بيانات الاعتماد: Token في متغير بيئة؛ دوِّر عبر Admin UI
نقل البيانات الخارجي: نقطة نهاية CloudFront/API Gateway الخاصة بك فقط
لا تمنح أبدًا: delete-environment tenant-admin

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

401 Unauthorized

انتهت صلاحية token أو بيئة خاطئة. أنشئ PAT جديداً في المشرف

تحقق: curl -H 'Authorization: Bearer $TOKEN' $URL
Field validation failed

يجب أن تتطابق أنواع الحقول تماماً — text مقابل rich-text مقابل long-text. استخدم list_content_models لفحص المخطط

Lambda timeout on bulk operation

اعمل على دفعات من 50؛ لا يُرقِّم MCP عمليات الكتابة تلقائياً

البدائل

Webiny MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Strapi MCPأنت على Strapi وليس Webinyنظام CMS مختلف؛ قصة نشر مختلفة (containers مقابل serverless)
Contentful MCPCMS SaaS بدلاً من الاستضافة الذاتيةارتباط بالبائع؛ ليس مفتوح المصدر

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills