تحدث إلى متجرك وكأنه مساعد الذكاء الاصطناعي الخاص بك

هذا هو الجزء الأول من سلسلة مكونة من ثلاثة أجزاء على WooCommerce MCP. يغطي هذا المنشور ماهية MCP، وكيف يعمل، وكيفية البدء باستخدام القدرات المضمنة. يغطي الجزء الثاني بناء قدراتك المخصصة الأولى. يتعمق الجزء الثالث في العروض التوضيحية المتقدمة واعتبارات الإنتاج.

لقد قمت بالتعمق في شيء مثير حقًا في WooCommerce: تكامل بروتوكول السياق النموذجي (MCP). تم شحن MCP لأول مرة كنسخة تجريبية في الإصدار 10.3 وتم نضجه عبر الإصدارات. الآن، مع WooCommerce 10.7 وWordPress 6.9+، أصبحت الحزمة قوية بما يكفي لبناء بعض الأشياء المفيدة جدًا فوقها. لذلك، تقدمت وفعلت ذلك بالضبط.

تصور هذا: نحن نتحدث مع مساعد الذكاء الاصطناعي، ونقول شيئًا مثل “أرني منتجاتي منخفضة المخزون” أو “قم بإنشاء منتج يسمى Winter Hoodie مقابل 39.99 دولارًا.” يستجيب متجر WooCommerce الخاص بنا، ويقوم بالعمل، ويقدم النتائج. لا داعي للنقر خلال لوحة تحكم WordPress، ولا توجد مكالمات REST API اليدوية. مجرد محادثة طبيعية تتحول إلى إجراءات متجر حقيقية.

وهذا ما يتيحه MCP. خلال هذا المنشور، سأستخدم Claude Code كمساعد الذكاء الاصطناعي، لكن MCP يعمل مع أي عميل متوافق: Cursor، أو VS Code، أو أي شيء آخر يتحدث بروتوكول MCP. استخدم ما يناسبك بشكل أفضل.

دعونا استكشاف ذلك معا!

فكر في MCP كمترجم عالمي بين أدوات الذكاء الاصطناعي ومتجر WooCommerce الخاص بنا. عادةً، إذا أردنا أن يتفاعل الذكاء الاصطناعي مع متجرنا، فسنحتاج إلى:

• إنشاء عمليات تكامل REST API مخصصة.
• التعامل مع المصادقة بأنفسنا.
• اكتب مجموعة من التعليمات البرمجية لتحليل الاستجابات.

يغير MCP كل ذلك. إنه معيار مفتوح المصدر يتيح لمساعدي الذكاء الاصطناعي مثل Claude أو Cursor أو VS Code التحدث مباشرة إلى أنظمة مثل WooCommerce باستخدام اللغة الطبيعية.

مع MCP:

• يستطيع الذكاء الاصطناعي اكتشاف ما يمكن أن يفعله متجرنا.
• يمكن للذكاء الاصطناعي تنفيذ هذه الإجراءات بأمان.
• كل شيء يعمل ضمن الأذونات الموجودة لدينا.

لذلك عندما نقول “قم بإدراج جميع المنتجات التي تقل قيمتها عن 20 دولارًا USD”، يترجم MCP ذلك إلى شيء يفهمه WooCommerce، ويديره بشكل آمن، ويعيد النتائج.

تعمل ثلاث قطع معًا لتحقيق ذلك، وتعتمد جميعها على أمان WooCommerce الحالي.

اللبنات الأساسية

واجهة برمجة تطبيقات قدرات ووردبريس

تعد واجهة برمجة تطبيقات WordPress Abilities API وسيلة لمكونات WordPress الإضافية لتسجيل “القدرات”، وهي في الأساس الأشياء التي يمكنهم القيام بها. فكر في الأمر كقائمة: يخبر WooCommerce WordPress، “هذا كل ما يمكنني فعله”، ويمكن لمساعدي الذكاء الاصطناعي قراءة تلك القائمة واختيار ما يحتاجون إليه. كل قدرة لها اسم مثل:

• woocommerce/products-list: قائمة بجميع المنتجات
• woocommerce/orders-create: إنشاء أمر جديد

يتم شحن واجهة برمجة التطبيقات الخاصة بالقدرات في WordPress 6.9 كميزة أساسية. فهو يوفر سجلاً موحدًا يمكن لأي مكون إضافي الاتصال به، لذلك لم تعد WooCommerce بحاجة إلى تجميعه بشكل منفصل. بالنسبة لأولئك الذين يقومون ببناء قدرات مخصصة، يتم تسجيلهم في wp_abilities_api_init ربط (المزيد عن هذا في الجزء الثاني من السلسلة).

محول ووردبريس MCP

محول MCP هو المترجم. يأخذ رسائل MCP من مساعدي الذكاء الاصطناعي ويحولها إلى شيء يفهمه WordPress. فكر في الأمر باعتباره الوسيط الذي يتحدث كلاً من “بروتوكول الذكاء الاصطناعي” و”WordPress”.

واجهة برمجة تطبيقات WooCommerce REST

جسر MCP Abilities الحالي إلى نقاط نهاية REST API الحالية. وهذا يعني أن أذونات REST API الحالية لا تزال تتحكم في كل شيء، ويظل الأمان كما هو تمامًا.

في المستقبل، قد تتجاوز القدرات REST وتفعل أشياء أكثر قوة. لكن في الوقت الحالي، يمنحنا هذا أساسًا متينًا وآمنًا.

تدفق الاتصالات

عندما نكتب “قائمة بجميع المنتجات” في Claude Code، إليك ما يحدث خطوة بخطوة:

AI Client (Claude, etc.)

    ↓ (MCP protocol over stdio/JSON-RPC)

Local MCP Proxy (mcp-wordpress-remote)

    ↓ (HTTP/HTTPS requests with authentication)

Remote WordPress MCP Server (mcp-adapter)

    ↓ (WordPress Abilities API)

WooCommerce Abilities

    ↓ (REST API calls or direct operations)

WooCommerce Core

بعبارات واضحة، يرسل كلود كود رسالة إلى أداة وكيل صغيرة تعمل على أجهزتنا. يقوم الوكيل بتحويله إلى طلب ويب آمن ويرسله إلى نقطة نهاية MCP لموقع WordPress الخاص بنا. يبحث محول MCP عن القدرة التي سيتم تشغيلها، ويتم تنفيذ رد الاتصال الخاص بالقدرة (الاستعلام عن الأوامر والمنتجات وما إلى ذلك)، وتتدفق النتيجة مرة أخرى بنفس الطريقة.

الوكيل المحلي (@automattic/mcp-wordpress-remote) هي أداة Node.js صغيرة نقوم بتثبيتها مرة واحدة أثناء الإعداد ثم ننساها. وتتمثل مهمتها في الترجمة بين طريقة تواصل عملاء الذكاء الاصطناعي (stdio) وطريقة عمل WordPress (HTTP).

وصل MCP كإصدار تجريبي في WooCommerce 10.3 مع قدرات المنتج والطلب. كان التحديث منذ ذلك الحين هو ترحيل MCP Adaptor v0.3.0 في الإصدار 10.4، والذي قام بتحديث طبقة النقل. منذ ذلك الحين، ظل سطح MCP مستقرًا خلال 10.5 و10.6 و10.6.1 و10.7، وهو ما نبني عليه.

MCP لا يزال في معاينة المطور، وبالتالي فإن القدرات المضمنة تقتصر على المنتج والطلب CRUD (إنشاء، قراءة، تحديث، حذف). لكن الأساس متين، وهنا يأتي دور القدرات المخصصة.

يأتي WooCommerce خارج الصندوق مزودًا بتسع قدرات MCP:

منتجات:

• woocommerce/products-list
• products-get
• products-create
• products-update
• products-delete

طلبات:

• woocommerce/orders-list
• orders-get
• orders-create
• orders-update

وهذا بالفعل قوي بما يكفي لإنشاء بعض مسارات العمل الرائعة حقًا. ولكن حيث يصبح الأمر مثيرًا للاهتمام حقًا القدرات المخصصة، وهذا ما سنتعمق فيه في الجزء الثاني من هذه السلسلة.

المتطلبات الأساسية

• موقع مرحلي (WooCommerce MCP قيد معاينة المطور)
• ووكومرس 10.7 (أو 10.3+)
• WordPress 6.9+ (لواجهة برمجة تطبيقات القدرات الأساسية)
• Node.js 22+ (مطلوب بواسطة الأحدث mcp-wordpress-remote)
• مفتاح REST API مع أذونات القراءة والكتابة
• عميل MCP (سأستخدم Claude Code). ملاحظة: يتطلب Claude Code خطة Claude Pro أو Max (20 دولارًا شهريًا +) أو أرصدة Anthropic API. إنه غير متوفر في الطبقة المجانية.

تمكين MCP

الخيار 1: رئيس لأكثر من مسؤول الفسفور الأبيض > ووكومرس > إعدادات > متقدم > سمات وتمكين ووكومرس MCP.

الخيار 2: تمكين عبر الفسفور الأبيض-CLI

wp option update woocommerce_feature_mcp_integration_enabled yes

إعداد الاتصال

قم بإنشاء مفتاح API

• في لوحة تحكم WP Admin الخاصة بمتجرك، انتقل إلى ووكومرس > إعدادات > متقدم > واجهة برمجة تطبيقات REST.
• انقر إضافة مفتاح.
• قم بتعيين الأذونات على القراءة/الكتابة.
• يحفظ مفتاح المستهلك والسر.

تكوين كود كلود

افتح المحطة وقم بتشغيل:

claude mcp add woocommerce_mcp \

  --env WP_API_URL=https://yourstore.com/wp-json/woocommerce/mcp \

  --env CUSTOM_HEADERS='{"X-MCP-API-Key": "YOUR_CONSUMER_KEY:YOUR_CONSUMER_SECRET"}' \

  -- npx -y @automattic/mcp-wordpress-remote@latest

مهم:

• يستبدل yourstore.com باستخدام عنوان URL الفعلي لموقع التدريج.
• استبدل YOUR_CONSUMER_KEY:YOUR_CONSUMER_SECRET جزء مع بيانات اعتماد API الفعلية.
• أعد تشغيل Claude Code لتحميل التكوين الجديد.

للتطوير المحلي باستخدام HTTP: للاختبار محليًا بدون HTTPS، أضف هذا الفلتر:

add_filter( 'woocommerce_mcp_allow_insecure_transport', '__return_true' );

دعنا نستكشف القدرات الافتراضية التي تأتي مع WooCommerce. تعمل هذه على الفور بدون أي كود مخصص.

قائمة بجميع المنتجات

اسأل عميل الذكاء الاصطناعي: “قائمة بجميع المنتجات الموجودة في المتجر“.

ماذا يحدث خلف الكواليس:

• يستدعي MCP القدرة: woocommerce/products-list
• إرجاع بيانات المنتج بالأسماء والأسعار وحالة المخزون وما إلى ذلك.

إنشاء منتج

جرب هذا: “أنشئ منتجًا باسم “Demo Hoodie” بسعر 29.99 دولارًا“.

مكالمات MCP:

• قدرة: woocommerce/products-create
• النتيجة: ظهور منتج جديد في المتجر!

تحديث منتج

يقول: “قم بتحديث سعر القميص التجريبي إلى 39.99 دولارًا“.

مكالمات MCP:

• قدرة: woocommerce/products-update
• يتغير السعر على الفور!

إنشاء أمر

يحاول: “قم بإنشاء أمر لمعرف المنتج 56 بالكمية 2“.

مكالمات MCP:

• قدرة: woocommerce/orders-create
• يتم إنشاء أمر جديد!

مذهل جدًا، أليس كذلك؟ هذه القدرات المضمنة تجعل إدارة المتجر بمساعدة الذكاء الاصطناعي تبدو طبيعية. وهذه مجرد البداية!

في الجزء الثاني، سنتجاوز العناصر المضمنة وننشئ قدرات مخصصة من البداية – بما في ذلك لوحة معلومات تحليلات مبيعات اليوم، وتنبيه انخفاض المخزون، وأداة البحث عن العملاء. نراكم هناك!

كامليش هو مهندس السعادة في WooCommerce. إنه يحب مساعدة العملاء على تحقيق أقصى استفادة من WordPress وWooCommerce – كلما رأى ما هو ممكن بالنسبة لهم، زاد حماسه. خارج Woo، ستجده يستكشف تقنية أو أداة جديدة، أو يسافر بدون خطط ثابتة، أو يشاهد لعبة الكريكيت بكثافة غير معقولة.