Back to blog

أفضل مرافق ذكاء اصطناعي لـ Bitrix CMS: اربط Mia عبر MCP

ar • 7/7/2026

حوّل موقع Bitrix إلى مساحة عمل حوارية. يوضح هذا الدليل كيفية ربط Mia Handles بـ 1C-Bitrix عبر وحدة hiweb.site_mcp — التثبيت، تهيئة المصادقة بالـ bearer، وإدارة المحتوى من تلغرام.

أفضل مرافق ذكاء اصطناعي لـ Bitrix CMS: اربط Mia عبر MCP

أفضل مرافق ذكاء اصطناعي لـ Bitrix CMS: اربط Mia عبر MCP

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

بعد الربط، يمكنك أن تطلب من Mia إدارة الأخبار وـ iblocks والمستخدمين والطلبات والمزيد — من محادثة تلغرام واحدة فقط. بدون تبويبات متصفح، بدون لوحات إدارة، بدون تبديل سياق.

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

Model Context Protocol هو معيار مفتوح يتيح لوكلاء الذكاء الاصطناعي التواصل مع خدمات خارجية عبر واجهة منظمة وآمنة.

يعرض خادم MCP server قدرات نظام ما. أما عميل MCP client (Mia) فيتصل بذلك الخادم ويدعو تلك القدرات نيابةً عنك.

وبالنسبة لمالكي مواقع Bitrix، يعني ذلك أنه يمكنك القيام بأشياء مثل:

  • اطلب من Mia نشر مقالات أخبار أو تحديث إدخالات iblock
  • ابحث عن الطلبات أو العملاء أو المنتجات وفقًا لمعايير
  • أنشئ تقاريرًا عن المبيعات أو حركة المرور أو أداء المحتوى
  • أنشئ مستخدمين، وتعيّن أدوارًا، وتدير الصلاحيات
  • استعلم عن التحليلات أو استخرج مؤشرات الأداء

كل ذلك من دردشة تلغرام واحدة.

المتطلبات المسبقة

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

  • موقع 1C-Bitrix (مرخّص، مع تفعيل تثبيت الوحدات)
  • صلاحيات إدارية لتثبيت الوحدات وتكوين الإعدادات
  • حساب Mia Handles بخطة على الأقل Standard (تتطلب اتصالات MCP وصولًا إلى API)
  • شهادة SSL على موقع Bitrix الخاص بك (يلزم HTTPS لنقطة نهاية MCP)

الخطوة 1 — تثبيت وحدة hiweb.site_mcp

الوحدة الموصى بها هي hiweb.site_mcp من Bitrix Marketplace. توفر التنفيذ الرسمي لخادم MCP لـ Bitrix.

رابط Marketplace: https://marketplace.1c-bitrix.ru/hiweb.site_mcp

ملاحظة: صفحة الـ marketplace قيد الإنشاء حاليًا لكنها ستُنشر قريبًا. إذا كانت لديك الوحدة بالفعل، انتقل إلى الخطوة 2.

من لوحة إدارة Bitrix:

  1. انتقل إلى Settings → Marketplace
  2. ابحث عن hiweb.site_mcp أو استخدم الرابط المباشر أعلاه
  3. ثبّت الوحدة وفعّلها
  4. بعد التفعيل، انتقل إلى Settings → Settings of the Site → MCP Server

ستجد هناك:

  • Endpoint URL — عنوان URL العام لنقطة نهاية MCP (عادةً https://yoursite.com/api/mcp/)
  • Authentication — إعدادات رمز bearer token
  • Tools to expose — اختر/بدّل أي قدرات في Bitrix يمكن لـ Mia الوصول إليها (iblocks وnews وusers وorders وanalytics وغيرها)

الخطوة 2 — إنشاء Bearer Token

تستخدم وحدة Bitrix MCP مصادقة Bearer token للوصول الآمن إلى الـ API.

  1. انتقل إلى Settings → Settings of the Site → MCP Server
  2. انقر Generate Token أو Create New Token
  3. أعطه اسمًا، مثل Mia MCP Integration
  4. اضبط مدة انتهاء الرمز (مُوصى: لا يوجد انتهاء للاستخدام في بيئة الإنتاج)
  5. انسخ الرمز الذي تم إنشاؤه — سترى الرمز مرة واحدة فقط

يصبح هذا الرمز هو بيانات الاعتماد التي تستخدمها Mia للاتصال بموقع Bitrix الخاص بك.

الخطوة 3 — إتاحة الـ endpoint بشكل آمن

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

  • Bearer token auth — يجب أن يحمل كل طلب رأس Authorization مع bearer token
  • IP allowlist — حصر مسار MCP ضمن نطاق عناوين IP لواجهة خلفية Mia
  • Private network / VPC — لسيناريوهات المؤسسات

إذا كان موقع Bitrix الخاص بك خلف Cloudflare أو WAF آخر، فتأكد من السماح لمسار MCP عبره باستخدام طرق POST. اختبر الـ endpoint أولاً باستخدام curl (انظر الخطوة 5) قبل ربط Mia.

الخطوة 4 — ربط خادم Bitrix في Mia Handles

حان وقت الجزء الممتع. في دردشة Mia:

  1. افتح Mia miniapp (اضغط على صورة ملفك الشخصي أو استخدم القائمة)
  2. انتقل إلى Settings → Tools → MCP Servers → Add (أو عدّل خادمًا موجودًا)
  3. املأ نموذج الاتصال:
Server name:   My Bitrix Site
Endpoint URL:  https://example.com/hiweb-site-mcp/
Transport:     JSON POST (stateless)
Auth:          Bearer token
Token:         (ألصق bearer token الذي تم إنشاؤه)

مهم: اختر JSON POST (stateless) كنوع النقل (transport). لا تستخدم Streamable HTTP أو SSE — وحدة Bitrix MCP تقبل فقط طلبات POST JSON-RPC.

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

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

بعد الربط، جرّب أمرًا بسيطًا في دردشة Mia:

"List the last 5 news items on my Bitrix site"

يُفترض أن تُرجع Mia ملخصًا مستخرجًا مباشرةً من موقعك. إذا حصلت على خطأ، تحقّق من:

  • صحة bearer token وتاريخ انتهاء صلاحيته
  • أن وحدة MCP مفعلة وأن الأدوات مفعلة
  • أن عنوان URL الخاص بالـ endpoint يمكن الوصول إليه من خلال البنية الخلفية الخاصة بـ Mia (جدار الحماية، شهادة SSL)
  • أن نوع النقل مضبوط على JSON POST (stateless)

يمكنك أيضًا الاختبار يدويًا عبر curl:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' \
  "https://example.com/hiweb-site-mcp/"

يجب أن تحصل على قائمة أدوات بصيغة JSON — وهذا يعني أن الخادم يعمل.

الخطوة 6 — ما الذي يمكنك فعله بعد الإعداد؟

بعد الربط، تصبح Mia رفيقتك المساعدة لـ Bitrix. إليك أكثر الأشياء شيوعًا التي يمكنك القيام بها:

  • عمليات المحتوى — إنشاء أو تحديث أو نشر مقالات الأخبار وإدخالات iblock
  • إدارة الوسائط — عرض أو رفع أو استبدال الصور في الملفات
  • إدارة المستخدمين — إنشاء الحسابات، وإعادة تعيين كلمات المرور، وتعيين الأدوار
  • الطلبات وCRM — الاستعلام عن الطلبات أو العملاء أو الصفقات أو العملاء المحتملين
  • التحليلات — جلب تقارير حركة المرور أو مؤشرات التحويل أو ملخصات المبيعات
  • النشر المجدول — جدولة المحتوى للتواريخ المستقبلية عبر تقويم Mia

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

"Create a news post about the product launch I sent you, schedule it for Wednesday at 14:00, and add a task for the marketing team to review it."

ستتعامل Mia مع الثلاثة دفعة واحدة.

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

العرض السبب المرجح الحل
"Connection failed" تم حظر الـ endpoint أو عنوان URL غير صحيح تحقق من قواعد جدار الحماية وشهادة SSL
"No tools available" تم تعطيل الوحدة أو لم يتم تفعيل أي أدوات أعد التفعيل واختر على الأقل أداة واحدة
"Unauthorized" bearer token غير صالح أعد إنشاؤه في إعدادات MCP وحدّثه في Mia
"HTTP 404" مسار الـ endpoint غير صحيح تحقّق من عنوان URL للـ endpoint الذي تم ضبطه في الوحدة
"Transport error" نوع نقل غير صحيح استخدم JSON POST (stateless) وليس SSE أو Streamable
استجابات بطيئة تم تفعيل عدد كبير جدًا من الأدوات عطّل الأدوات غير المستخدمة، وفعل التصفح بالصفحات

WordPress وDrupal يعملان بالطريقة نفسها

إذا كنت تدير أيضًا موقع WordPress أو Drupal، فالنمط نفسه ينطبق. لكل CMS محول MCP خاص به، لكن سير الاتصال في Mia مطابق — ثبّت الوحدة، وأظهر الـ endpoint، والصق بيانات الاعتماد في Mia. يمكنك حتى ربط المنصات الثلاثة بنفس محادثة Mia، وستتعامل معها وتخاطب كل واحدة بالاسم.

للاطلاع على الأدلة الأخرى، راجع:

الخلاصة

ربط Bitrix بـ Mia عبر MCP يحوّل CMS من لوحة تحكم منفصلة إلى امتداد حواري لسير عملك اليومي. بعد الإعداد، سيعمل كل شيء ببساطة — بهدوء في الخلفية، عندما تحتاج إليه.

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