Knowledge Base — MCP Sources قاعدة المعرفة — مصادر MCP
Connect live external data sources to your bot: REST APIs, remote databases, SSH servers, SOAP services, and more. اربط مصادر بيانات حية ببوتك: REST APIs، قواعد بيانات بعيدة، خوادم SSH، خدمات SOAP، والمزيد.
MCP (Model Context Protocol) sources let your bot query live data at the moment a user asks a question — not just from static uploaded content. This means your bot can answer questions about real-time inventory, live order status, or server logs.
What's the Difference from Uploading a Document?
- Uploaded document — static snapshot. Changes in the source won't be reflected until you re-upload.
- MCP source — live connection. Every time a user asks a question, Mugib fetches fresh data from the source.
Use MCP when your data changes frequently or is too large to upload as a document (e.g., a live product catalog or server logs).
Sources You Can Create Yourself
From Knowledge Base → MCP Sources → Add Source, you can configure these types directly:
- 🌐 REST API — any HTTP endpoint with a
{query}URL template - 🕷️ Web Scraper — scrape any public webpage
- 📰 RSS Feed — pull news or blog posts from a feed URL
- 📊 Google Sheets — search a public spreadsheet
- 🖥️ SSH Server — run a shell command on your remote Linux server
- 📂 SFTP — browse and read files on a remote SFTP server
- 🐬 Remote MySQL / MariaDB — run a custom SELECT on your MySQL database
- 🐘 Remote PostgreSQL — run a custom SELECT on your PostgreSQL instance
- 🔌 SOAP / XML — call a legacy enterprise SOAP web service
Sources Enabled by Your Admin
Your Mugib admin can set up shared enterprise sources. With our new Auto-Routing intelligence, a single connection handles multiple data types simultaneously (e.g., one Shopify source manages Orders, Products, and Customers). You just enable them per project:
- 🏢 Odoo ERP, 🛍️ Shopify, 🛒 WooCommerce
- 📝 Notion, 🎫 Zendesk, 💬 Freshdesk
- 🍃 MongoDB, 📧 Email (IMAP), 🦁 Scrapling
Adding an MCP Source
Adding an MCP source uses a simple 2-step visual wizard:
- Inside your project, go to Knowledge Base → MCP Sources and click Connect Data Source.
- Step 1: Choose a Category: Select from beautifully categorized cards (e.g., E-Commerce & ERP, Customer Support, Databases, Web & API).
- Step 2: Configuration & Credentials: Fill in the required fields. Advanced options (like timeouts or max results) are hidden by default to keep things simple.
- Auto-suggested Keywords: For platforms like Shopify or Zendesk, Mugib will automatically suggest the best Arabic and English trigger words (e.g., order, منتج, شكوى). You can accept these or write your own.
- Click Create Source.
The source will appear in your MCP list. It's instantly active and ready to route queries!
How Mugib Routes Queries to MCP Sources
When a user sends a message, Mugib's router picks the best source automatically:
- Keyword match — if the message contains a keyword you configured, that source is used instantly (free, no AI cost)
- Semantic match — if no keyword matches, the router uses embedding similarity against source descriptions
- AI routing — falls back to the AI router prompt if still uncertain
- KB fallback — if no MCP source applies, the answer comes from your static knowledge base
Example:
- User: "What's the status of order #4821?"
- Keyword "order" → routes to Remote MySQL → "Your order is processing, ships March 25."
Enable/Disable Sources Per Project
Every MCP source has an Active toggle. Admin-managed sources (Shopify, Notion, etc.) that your admin set up can be enabled directly from your project's MCP list — just flip the toggle, no reconfiguration needed.
Use documents for policies, FAQs, and anything that rarely changes.
Use MCP for real-time data: inventory, orders, tickets, live pricing, server status.
مصادر MCP (Model Context Protocol) تتيح لبوتك الاستعلام عن بيانات حية في لحظة يطرح فيها المستخدم سؤالاً — ليس فقط من محتوى ثابت مرفوع. هذا يعني أن بوتك يستطيع الإجابة عن أسئلة تخص المخزون الفوري، حالة الطلب الحية، أو سجلات الخادم.
ما الفرق عن رفع مستند؟
- المستند المرفوع — لقطة ثابتة. التغييرات في المصدر لن تنعكس حتى تُعيد الرفع.
- مصدر MCP — اتصال حي. في كل مرة يطرح مستخدم سؤالاً، يجلب مجيب بيانات محدّثة من المصدر.
استخدم MCP عندما تتغير بياناتك بشكل متكرر أو تكون كبيرة جداً للرفع كمستند (مثل كتالوج منتجات حي أو سجلات الخادم).
المصادر التي تضيفها بنفسك
من قاعدة المعرفة ← مصادر MCP ← إضافة مصدر، يمكنك إعداد هذه الأنواع مباشرة:
- 🌐 REST API — أي نقطة نهاية HTTP مع قالب URL يحتوي على
{query} - 🕷️ كاشط الويب — كشط أي صفحة عامة
- 📰 موجز RSS — سحب الأخبار والمقالات من رابط RSS
- 📊 Google Sheets — البحث في جدول بيانات عام
- 🖥️ خادم SSH — تشغيل أمر shell على خادم Linux البعيد
- 📂 SFTP — تصفح وقراءة ملفات على خادم SFTP البعيد
- 🐬 MySQL / MariaDB البعيد — تشغيل SELECT مخصص على قاعدة MySQL الخاصة بك
- 🐘 PostgreSQL البعيد — تشغيل SELECT مخصص على قاعدة PostgreSQL الخاصة بك
- 🔌 SOAP / XML — استدعاء خدمة ويب SOAP للمؤسسات
المصادر التي يفعّلها الأدمن
يمكن للأدمن إعداد مصادر مؤسسية مشتركة. بفضل ميزة التوجيه التلقائي (Auto-Routing) الجديدة، رَبطة واحدة تكفي للتعامل مع أنواع بيانات مختلفة بذكاء (مثلاً: رَبط Shopify واحد يدير الطلبات والمنتجات والعملاء معاً). يمكنك تفعيلها بضغطة زر لمشروعك:
- 🏢 Odoo ERP، 🛍️ Shopify، 🛒 WooCommerce
- 📝 Notion، 🎫 Zendesk، 💬 Freshdesk
- 🍃 MongoDB، 📧 بريد إلكتروني (IMAP)، 🦁 Scrapling
إضافة مصدر MCP
تتم إضافة مصادر البيانات عبر معالج بصري (Wizard) من خطوتين:
- داخل مشروعك، اذهب لـ قاعدة المعرفة ← مصادر MCP وانقر ربط مصدر بيانات.
- الخطوة 1: اختيار الفئة: اختر من بين بطاقات تفاعلية مصنفة بدقة (مثل: التجارة الإلكترونية، خدمة العملاء، قواعد البيانات).
- الخطوة 2: الإعدادات والبيانات السرية: أدخل الحقول المطلوبة الكترونياً. الإعدادات المتقدمة (مثل مهلة الاتصال) تكون مخفية افتراضياً لتسهيل التجربة.
- اقتراح الكلمات المفتاحية ذكياً: للأنظمة مثل Shopify أو Odoo، سيقترح "مجيب" الكلمات المفتاحية المناسبة باللغتين تلقائياً (مثل طلب، منتج، order).
- انقر إنشاء المصدر.
سيظهر المصدر في القائمة وسيكون جاهزاً ومفعّلاً للرد الآلي فوراً!
كيف يوجّه مجيب الاستعلامات لمصادر MCP
عندما يرسل مستخدم رسالة، يختار موجّه مجيب أفضل مصدر تلقائياً:
- مطابقة الكلمات المفتاحية — إذا احتوت الرسالة على كلمة مفتاحية حددتها، يُستخدم ذلك المصدر فوراً (مجاني، بدون تكلفة AI)
- المطابقة الدلالية — إذا لم تتطابق كلمة مفتاحية، يستخدم الموجّه التشابه الدلالي مع وصف المصدر
- توجيه AI — الرجوع إلى موجّه AI إذا ظل الأمر غير محدد
- الرجوع لقاعدة المعرفة — إذا لم يتطابق أي مصدر MCP، تأتي الإجابة من قاعدة المعرفة الثابتة
مثال:
- المستخدم: "ما حالة طلبي رقم #4821؟"
- كلمة "طلب" → توجيه لـ MySQL البعيد → "طلبك قيد المعالجة، موعد الشحن 25 مارس."
تفعيل/تعطيل المصادر لكل مشروع
لكل مصدر MCP زر تفعيل. المصادر التي أعدّها الأدمن (Shopify، Notion، إلخ) يمكن تفعيلها مباشرة من قائمة MCP الخاصة بمشروعك — فقط قلّب الزر دون أي إعادة إعداد.
استخدم المستندات للسياسات والأسئلة الشائعة وأي شيء نادراً ما يتغير.
استخدم MCP للبيانات الحية: المخزون، الطلبات، التذاكر، الأسعار الفورية، حالة الخادم.
Ready to build your AI agent?
Start your free trial and put what you've learned into practice.
Start Free Trial