كيف تعمل Mia مع Drupal — دليل الإعداد (خادم MCP)

كيف تعمل Mia مع Drupal: دليل إعداد عملي

يُعد Drupal أحد أكثر منصات إدارة المحتوى (CMS) مرونة على الويب، وبفضل بروتوكول سياق النموذج (Model Context Protocol - MCP)، يمكنه الآن العمل جنبًا إلى جنب مع Mia، سكرتيرتك الشخصية التي تعمل بالذكاء الاصطناعي. في هذا الدليل، سنأخذك في رحلة الإعداد الكاملة: بدءاً من تثبيت وحدة خادم Drupal MCP وصولاً إلى ربطها بمحادثة Mia الخاصة بك.

بحلول نهاية هذا الدليل، ستكون Mia قادرة على قراءة المحتوى وإنشائه وتحديثه وإدارته في Drupal مباشرة من محادثة Telegram الخاصة بك — دون الحاجة إلى لوحات تحكم أو التبديل بين التطبيقات.

ما هو MCP ولماذا يجب أن تهتم به؟

بروتوكول سياق النموذج (MCP) هو معيار مفتوح (تم تقديمه في الأصل بواسطة Anthropic وتدعمه الآن OpenAI و Google) يسمح لوكلاء الذكاء الاصطناعي بالتحدث إلى خدمات خارجية من خلال واجهة مهيكلة وآمنة.

يقوم خادم (Server) الـ MCP بعرض الأدوات والبيانات من نظام معين (Drupal في حالتنا هذه). ويتصل عميل (Client) الـ MCP (وهو Mia) بذلك الخادم ويستخدم تلك الأدوات نيابة عنك.

بالنسبة لأصحاب مواقع Drupal، هذا يعني أنه يمكنك القيام بأمور مثل:

الطلب من Mia إنشاء أو تحديث منشور مدونة
البحث عن مسودات المحتوى غير المنشورة
سرد مصطلحات التصنيف (Taxonomy)، أو المستخدمين، أو طرق العرض (Views)
تشغيل سير العمل (الإشراف، النشر، الجدولة)
سحب تقارير حالة وصحة الموقع

كل ذلك من محادثة Telegram واحدة.

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

قبل البدء، تأكد من أن لديك:

موقع Drupal 10.x أو 11 (مع إصدار PHP 8.1+، وإعداد Composer قياسي)
وصول إداري لتثبيت الوحدات (Modules)
حساب Mia Handles مع خطة Standard على الأقل (تتطلب اتصالات MCP وصولاً إلى واجهة برمجة التطبيقات)
مجموعة تطوير برمجيات PHP MCP SDK مثبتة عالمياً أو متاحة عبر Composer

الخطوة 1 — تثبيت وحدة خادم Drupal MCP

الوحدة الموصى بها هي mcp_server من موقع Drupal.org، وهي مبنية على modelcontextprotocol/php-sdk الرسمي (تعاون بين مؤسسة PHP وSymfony).

من المجلد الرئيسي لموقعك، قم بتشغيل:

composer require drupal/mcp_server

ثم قم بتفعيلها عبر Drush أو واجهة المستخدم:

drush en mcp_server -y
drush cr

بدلاً من ذلك، انتقل إلى Extend → Install new module، ثم ارفع الأرشيف وقم بتفعيله.

بعد التفعيل، انتقل إلى Configuration → Web services → MCP Server (/admin/config/services/mcp_server). ستجد هناك:

Endpoint URL — الرابط العام لنقطة نهاية MCP (غالباً https://yoursite.com/mcp)
Authentication — المصادقة الأساسية (Basic auth)، أو الرمز المميز (Token)، أو OAuth (الموصى به: الرمز المميز)
Tools and resources — تفعيل إمكانيات Drupal التي تريد عرضها (Nodes، المستخدمون، التصنيف، Views، إلخ)

قم بإنشاء رمز API مميز وآمن واحفظه — ستحتاجه في Mia.

الخطوة 2 — عرض نقطة النهاية بشكل آمن

يجب أن تكون نقطة نهاية MCP قابلة للوصول فقط من قبل الخدمات التي تثق بها. خياراتك المعتادة هي:

IP allowlist — تقييد الوصول بعنوان IP الخاص بخادم Mia
Token-based auth — يجب أن يحمل كل طلب الرمز المميز في الرأس (Header)
Private network / VPC — لإعدادات الشركات والمؤسسات

إذا كان موقع Drupal الخاص بك خلف Cloudflare أو أي جدار حماية آخر (WAF)، تأكد من السماح بمسار /mcp عبر طريقتي POST و GET، بالإضافة إلى SSE إذا كنت تستخدم خاصية البث (Streaming).

الخطوة 3 — ربط خادم Drupal في Mia Handles

الآن الجزء الممتع. في محادثة Mia الخاصة بك:

افتح Mia miniapp (اضغط على صورة ملفك الشخصي أو استخدم القائمة)
اذهب إلى Settings → Integrations → Add MCP server
املأ نموذج الاتصال:

اسم الخادم:   My Drupal Site
Endpoint URL:  https://yoursite.com/mcp
Transport:     Streamable HTTP
Auth:          Bearer token
Token:         (الصق رمز Drupal MCP الخاص بك)

اضغط على Connect. ستقوم Mia بالتحقق من نقطة النهاية، وعرض الأدوات المتاحة، وإضافة الخادم إلى محادثتك.

يمكنك أيضاً الاتصال باستخدام بروتوكول SSE أو JSON POST — حيث تدعم Mia الطرق الثلاث.

الخطوة 4 — اختبار الاتصال

بمجرد الاتصال، جرب أمراً بسيطاً في محادثة Mia:

"سرد آخر 5 مقالات غير منشورة على موقع Drupal الخاص بي"

يجب أن تعيد Mia ملخصاً مسحوباً مباشرة من موقع Drupal الخاص بك. إذا ظهر خطأ، تحقق من:

صلاحية الرمز المميز في إعدادات Drupal MCP
إمكانية الوصول إلى الرابط من خلال خادم Mia (جدار الحماية، شهادة SSL)
تفعيل الأدوات المطلوبة من جانب Drupal

ماذا يمكنك أن تفعل بعد الإعداد

إليك بعض الأشياء التي يمكن لـ Mia القيام بها بمجرد الاتصال:

عمليات المحتوى — إنشاء مسودات، نشر/إلغاء نشر، تعديل الحقول بالجملة
التصنيف والمراجع — إضافة مصطلحات، إعادة تنظيم المفردات
إدارة المستخدمين — إنشاء حسابات، إعادة تعيين كلمات المرور، تعيين الأدوار
استعلامات Views — جلب تقارير مهيكلة بصيغة Markdown أو JSON
مشغلات سير العمل — نقل المحتوى عبر حالات الإشراف
النشر المجدول — جدولة المقالات لتواريخ مستقبلية عبر مهام Mia أو التقويم

ولأن Mia تعرف بالفعل تقويمك ومهامك وملفاتك، يمكنها تنسيق عمل Drupal إلى جانب بقية يومك — على سبيل المثال:

"انشر المقابلة التي انتهيت من تسجيلها هذا الصباح كمقال على موقع Drupal الخاص بي، وذكّر المحرر بمراجعتها غداً في الساعة 10:00."

ستقوم Mia بكلتا المهمتين في وقت واحد.

استكشاف الأخطاء وإصلاحها

العرض	السبب المحتمل	الحل
"Connection failed"	نقطة النهاية محجوبة أو الرابط خطأ	تحقق من قواعد جدار الحماية وشهادة SSL
"No tools available"	وحدة MCP معطلة أو لم يتم تفعيل أدوات	أعد التفعيل واختر أداة واحدة على الأقل
"Unauthorized"	رمز غير صالح	أعد إنشاء الرمز من لوحة تحكم Drupal وحدثه في Mia
استجابات بطيئة	تصدير كيانات كبيرة الحجم	عطل الأدوات غير المستخدمة، وفعل الترقيم (Pagination)

قراءة ذات صلة

يعمل نمط MCP نفسه مع منصات CMS أخرى. تحقق من أدلتنا المصاحبة:

كيف تعمل Mia مع WordPress: دليل إعداد عملي — يغطي إضافة mcp-adapter وكلمات مرور التطبيقات وحالات استخدام WordPress الخاصة.
أفضل رفيق ذكاء اصطناعي لـ Bitrix CMS: اربط Mia عبر MCP — يغطي وحدة hiweb.site_mcp والمصادقة بالرموز واستخدامات Bitrix الخاصة.

يمكنك ربط جميع المنصات الثلاث بنفس محادثة Mia، وستقوم هي بالتعامل مع كل منها باسمه.

ختاماً

تحويل Drupal إلى Mia عبر MCP يحول نظام إدارة المحتوى الخاص بك من لوحة تحكم مستقلة إلى امتداد محادثي لسير عملك اليومي. بمجرد إعداده، فإنه يعمل ببساطة — بهدوء، في الخلفية، وقتما تحتاج إليه.

إذا كانت لديك أسئلة أو كنت بحاجة إلى مساعدة في الإعداد، فقط اسأل Mia مباشرة في المحادثة. فهي تعرف البروتوكول بالفعل.