كيف تضيف WebMCP إلى WordPress وWooCommerce: دليل عملي

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

الخطوة 1: اختر الأدوات الأولى

لا تكشف كل شيء. اختر الإجراءين أو الثلاثة التي يسأل عنها العملاء أكثر، وابدأ بأدوات للقراءة فقط:

• المتاجر: search_products، وget_product (الخيارات، والتوفّر)، وget_store_policy (الشحن، والإرجاع).
• شركات الخدمات: find_service، وget_faq، وprepare_quote_request.
• الحجوزات: list_services، وfind_open_slots؛ أما تأكيد الحجز فيأتي لاحقًا ويحتاج دائمًا إلى الزائر.

الخطوة 2: إضافة جاهزة أم أدوات مخصّصة؟

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

الخطوة 3: حوّل النماذج الحالية إلى أدوات

أسرع مكسب هو الواجهة التصريحية. أضف toolname وtooldescription إلى نموذج لديك بالفعل، مثل نموذج التواصل أو طلب عرض السعر. تصبح الحقول ذات التسميات مدخلات الأداة، ويمكن لـ toolparamdescription أن يشرح الحقل أكثر:

<form toolname="request_quote" tooldescription="Prepare a quote request. The visitor reviews and sends it." action="/quote">
  <label for="qname">Name</label> <input id="qname" name="name">
  <label for="qemail">Email</label> <input id="qemail" name="email" type="email">
  <select name="service" toolparamdescription="Which service the quote is for.">
    <option>Website redesign</option>
    <option>WooCommerce store</option>
  </select>
  <button type="submit">Send</button>
</form>

من دون السمة toolautosubmit يكتفي المتصفح بتعبئة النموذج، ويبقى الزائر هو من يضغط «إرسال». أبقِ الأمر كذلك في كل ما يتواصل مع فريقك.

الخطوة 4: أداة بحث عن المنتجات عبر Store API

واجهة Store API في WooCommerce (/wp-json/wc/store/v1/products) عامة، وتعيد البيانات نفسها التي يراها المتسوّقون، وتحترم إعدادات ظهور المنتجات بالفعل. يمكن لسكربت صغير تحمّله إضافتك أن يسجّل أداة بحث فوقها:

const mc = document.modelContext || navigator.modelContext;
if (mc && mc.registerTool) {
  mc.registerTool({
    name: 'search_products',
    description: 'Search the store catalog. Returns up to 5 products with price, stock and link.',
    inputSchema: {
      type: 'object',
      properties: {
        query: { type: 'string', description: 'Keywords, e.g. running shoe' },
        max_price: { type: 'number', description: 'Highest price in the store currency' },
      },
      required: ['query'],
    },
    annotations: { readOnlyHint: true },
    execute: async ({ query, max_price }) => {
      const url = new URL('/wp-json/wc/store/v1/products', location.origin);
      url.searchParams.set('search', String(query).slice(0, 80));
      url.searchParams.set('per_page', '5');
      if (max_price) url.searchParams.set('max_price', String(Math.round(max_price * 100)));
      const items = await (await fetch(url)).json();
      return JSON.stringify(items.map((p) => ({
        name: p.name, price: p.prices.price / 10 ** p.prices.currency_minor_unit,
        in_stock: p.is_in_stock, url: p.permalink,
      })));
    },
  });
}

أدرِجه من إضافتك باستخدام wp_enqueue_script() في الصفحات المناسبة، وعادةً في المتجر كله. والتحقق من دعم الميزة في السطر الأول يعني أن المتصفحات التي لا تدعم WebMCP تتجاوزه.

الخطوة 5: بياناتك الخاصة عبر REST API

للبيانات التي لا تغطيها Store API، مثل مناطق التوصيل أو مواعيد الحجز المتاحة من إضافة حجوزات، أضف مسار REST صغيرًا للقراءة فقط. اضبط دائمًا permission_callback، وتحقّق من كل وسيط، ولا تُعِد إلا ما يحق للعميل رؤيته:

add_action('rest_api_init', function () {
  register_rest_route('mysite/v1', '/delivery', [
    'methods' => 'GET',
    'permission_callback' => '__return_true', // public, read-only data
    'args' => ['postcode' => ['required' => true, 'sanitize_callback' => 'sanitize_text_field']],
    'callback' => function ($req) {
      return ['postcode' => $req['postcode'], 'days' => mysite_delivery_days($req['postcode'])];
    },
  ]);
});

الخطوة 6: الإجراءات الحساسة تحتاج إلى المتسوّق

الإضافة إلى السلة والحجز وإرسال النماذج إجراءات تغيّر شيئًا، لذا ميّز هذه الأدوات بـ consequentialHint: true واترك المتسوّق يؤكّد. استخدم جلسة المتسوّق نفسه ورموز nonce في WordPress، ولا تستخدم أبدًا مفتاح مدير. اترك الدفع وإتمام الشراء للمتسوّق. ولا تبنِ أدوات تعرض قوائم الطلبات أو العملاء أو المستخدمين.

الخطوة 7: اختبر ثم أطلق

1. ابنِ أولًا على نسخة تجريبية (staging) من موقعك.
2. اختبر في إصدار حديث من Chrome مع تفعيل WebMCP، واستدعِ كل أداة بمدخلات صحيحة وأخرى خاطئة.
3. تأكّد من أن الزوار العاديين لا يلاحظون أي تغيير وأن سرعة الصفحة لم تتغيّر.
4. شغّل فاحص WebMCP المجاني على الصفحة المنشورة للتأكد من أن الأدوات ظاهرة من الخارج.
5. سجّل استدعاءات الأدوات من دون بيانات شخصية، وراجعها بعد الإطلاق.

تريد أن ننفّذه لك؟

نصمّم أدوات WebMCP لـ WordPress وWooCommerce ونبنيها ونختبرها، بدءًا بتقييم مجاني للجاهزية وعرض سعر ثابت. اطّلع على خدمة دمج WebMCP مع WordPress، أو اقرأ WebMCP مقابل MCP لتقرّر هل تحتاج أيضًا إلى خادم MCP.