Your AI Connector Docs

توصيل خوادم MCP بالبوت الخاص بك

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

إذا كنت قد استخدمت “الوظائف المخصصة” (Custom Functions)، فهذه هي نفس الفكرة، ولكنها خطوة إضافية: الوظيفة المخصصة هي أداة واحدة تقوم بربطها بنفسك، بينما خادم MCP هو حزمة جاهزة من الأدوات التي يمكن للبوت اكتشافها واستدعاؤها من تلقاء نفسه.

تتواصل هذه الصفحة Your AI Connector مع أدوات نظام آخر: يمكن توصيل أي نظام إدارة علاقات عملاء (CRM)، أو متجر، أو نظام حجز، أو خدمة داخلية تنشر عنوان خادم MCP هنا، ويقوم البوت بقراءة البيانات المباشرة من خلاله في اللحظة التي يحتاج إليها، لذا فإن أي تغيير يتم إجراؤه يدوياً في ذلك النظام يظهر في الاستدعاء التالي. أما الاتجاه المعاكس، وهو السماح لمساعد ذكاء اصطناعي مثل Claude أو ChatGPT بالتحكم في حسابك Your AI Connector، فهو ميزة منفصلة: راجع ربط عملاء الذكاء الاصطناعي.


ما هو خادم MCP؟

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

بدلاً من وصف كل أداة للروبوت، يمكنك تزويد Your AI Connector بعنوان الخادم ومفتاح الوصول. يقوم Your AI Connector بسؤال الخادم “ما الذي يمكنك فعله؟”، ويحصل على قائمة الأدوات، ويجعلها متاحة لروبوتك. عندما يضيف الخادم أداة جديدة، يمكن لروبوتك استخدامها دون أي إعداد إضافي من جانبك.

الوظائف المخصصة مقابل خوادم MCP — أيهما تستخدم:

الدوال المخصصة خوادم MCP
ما تقوم بإعداده أداة واحدة في كل مرة، يدوياً بالكامل (URL، المدخلات، تعيين الاستجابة). عنوان خادم واحد — يقوم البوت باكتشاف جميع أدواته نيابة عنك.
الأفضل لـ استدعاء واحد محدد لنظامك الخاص. الاتصال بخدمة تدعم بروتوكول MCP بالفعل وتوفر العديد من الأدوات.
الصيانة تقوم بتحديث الدالة عند تغير الأداة. تظهر الأدوات الجديدة من الخادم تلقائياً.

يمكنك استخدام كليهما في نفس الوقت على نفس الوكيل (Agent).


كيف يعمل (النسخة البسيطة)

  1. تقوم بتسجيل خادم MCP في صفحة خوادم MCP — عنوان الويب الخاص به ورأس التفويض (عادةً ما يكون مفتاح API).
  2. يقوم Your AI Connector بالاتصال واكتشاف أدوات الخادم، ويحفظ القائمة.
  3. تقوم بتفعيل الخادم على وكيل (Agent).
  4. أثناء المحادثة، عندما يطلب العميل شيئاً يمكن لأداة ما الإجابة عليه، يقوم الروبوت باستدعاء الأداة، وقراءة النتيجة، والرد بشكل طبيعي.

لا يرى العميل الآليات أبدًا — بل يحصل فقط على إجابة مدعومة بمعلومات حقيقية ومحدثة.

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

تكلفة استدعاء أداة MCP

تتم محاسبتك على استدعاء أداة من خادم MCP تماماً مثل استدعاء دالة مخصصة، وذلك وفقاً لمستوى جودة الذكاء الاصطناعي (AI Quality tier) الخاص بوكيلك:

مستوى جودة الذكاء الاصطناعي الرصيد لكل استدعاء لأداة MCP مع ربط مفتاح Anthropic الخاص بك (BYOK)
Pro 1 رصيد 0 رصيد — يعمل باستخدام مفتاحك
Economy (موقوف) 0.5 رصيد 0 رصيد — يعمل باستخدام مفتاحك
Max 0.25 رصيد لا يزال 0.25 رصيد، يتم محاسبتك عليه حتى مع ربط مفتاحك الخاص
Mini 0.15 رصيد لا يزال 0.15 رصيد، يتم محاسبتك عليه حتى مع ربط مفتاحك الخاص

ما يتلقاه خادمك مع كل استدعاء

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

"params": {
  "name": "my_appointments",
  "arguments": { "phone": "+31612345678" },
  "_meta": {
    "youraiconnector.com/contact": {
      "id": "8DGUvqM2QiPmzaX1ljMl",
      "channel": "whatsapp",
      "phone": "+31612345678",
      "first_name": "Ana",
      "last_name": "Lopez",
      "email": "ana@example.com"
    },
    "youraiconnector.com/conversation": {
      "campaign_id": "qxJzgilcz3zJM8wYSUn0",
      "user_id": "nCrIMMj77WMhnC1XSykM7IrQQ0e2",
      "test": false
    }
  }
}
  • id هو معرف جهة الاتصال في Your AI Connector، وهو نفس المعرف الذي تستخدمه واجهة برمجة التطبيقات (API) وخطافات الويب (webhooks).
  • يتم تضمين phone و email و first_name و last_name ومعرفات المنصة (instagram_id و messenger_id و telegram_user_id) عندما تكون متوفرة لدى جهة الاتصال.
  • يعتمد مدى ثقتك في الهوية على القناة. في WhatsApp وSMS وTelegram، يكون رقم الهاتف هو الرقم الذي جاءت منه الرسالة فعلياً. أما في Instagram وMessenger، فيكون هو معرف المنصة. في أداة دردشة الويب والقنوات المخصصة، تكون جهة الاتصال هي من بدأ تلك الدردشة، لذا تعامل مع هذه التفاصيل على أنها غير موثقة.
  • يكون test عبارة عن true عندما يأتي الاستدعاء من دردشة اختبار الوكيل (Agent) داخل التطبيق.

الخادم الذي يتجاهل _meta سيستمر في العمل تماماً كما كان من قبل.


إضافة خادم MCP (خطوة بخطوة)

في الشريط الجانبي الرئيسي، تحت AI Studio، انقر على خوادم MCP. ثم انقر على + إضافة خادم.

املأ النموذج:

الحقل ما يجب إدخاله مثال
الاسم تسمية قصيرة للخادم (تُستخدم أيضاً لتسمية أدواته للبوت). Order System
عنوان URL للخادم عنوان MCP الخاص بالخادم (يُسمى أحياناً “نقطة النهاية” أو endpoint)، بدءاً بـ https://. https://tools.mystore.com/mcp
اسم رأس المصادقة الرأس الذي يتوقعه الخادم للمصادقة. اتركه كـ Authorization ما لم تنص مستندات الخادم على خلاف ذلك. Authorization
قيمة رأس المصادقة بيانات الاعتماد نفسها، بالتنسيق الذي يتوقعه الخادم. Bearer sk_live_abc123

اختيار طريقة تسجيل الدخول: مفتاح API أو OAuth

يدعم Your AI Connector طريقتين للمصادقة مع الخادم. اختر الطريقة التي تخبرك وثائق الخادم باستخدامها، وذلك باستخدام خيار المصادقة (Authentication) في أعلى النموذج:

  • مفتاح API / رأس (Header): الطريقة الأصلية الموضحة أعلاه. تقوم بلصق بيانات اعتماد ثابتة (مفتاح API أو رمز مميز) في حقل قيمة رأس المصادقة (Auth Header Value)، وسيقوم Your AI Connector بإرسالها مع كل طلب. وهي الأفضل للخوادم التي تمنحك مفتاحاً طويل الأمد.
  • OAuth (تسجيل الدخول): للخوادم التي تطلب منك تسجيل الدخول بدلاً من لصق مفتاح. مع OAuth، لا يوجد مفتاح لنسخه — أنت توافق على الوصول عن طريق تسجيل الدخول، بنفس الطريقة التي يعمل بها “تسجيل الدخول باستخدام Google” على المواقع الأخرى.

للاتصال باستخدام OAuth:

  1. اختر OAuth كطريقة للمصادقة. ستختفي حقول ترويسة المصادقة (Auth Header) ويحل محلها بطاقة اتصال (Connect) — لن تحتاج إلى مفتاح.
  1. املأ الاسم (Name) و عنوان URL للخادم (Server URL)، ثم انقر فوق حفظ (Save). تمت إضافة الخادم إلى قائمتك، ولكنه يظهر كـ غير متصل (not connected) في الوقت الحالي.
  2. انقر فوق اتصال (Connect) على الخادم. ستفتح نافذة تسجيل دخول آمنة حيث توافق على الوصول.
  3. وافق، وستغلق النافذة من تلقاء نفسها. يظهر الخادم الآن كمتصل، ويقوم Your AI Connector بتحميل أدواته.

هذا كل شيء. يحافظ Your AI Connector على الاتصال محدثاً تلقائياً في الخلفية، لذا لن تحتاج عادةً إلى لمسه مرة أخرى. إذا انقطع اتصال الخادم في أي وقت (على سبيل المثال، انتهت صلاحية تسجيل الدخول أو قام شخص ما بإلغائه من جانب الخادم)، فسيظهر كغير متصل — فقط انقر فوق إعادة الاتصال (Reconnect) وقم بتسجيل الدخول مرة أخرى.

إذا تعذر إعداد الخادم تلقائياً عند النقر على “اتصال”، فسيُطلب منك لصق بعض التفاصيل (عنوان تسجيل الدخول ومعرف العميل) التي توفرها وثائق الخادم نفسه، ثم ستكتمل عملية تسجيل الدخول.

اختبار الاتصال

قبل الحفظ، انقر فوق اختبار الاتصال (Test Connection). سيتصل Your AI Connector بالخادم ويعرض لك قائمة الأدوات التي يقدمها. هذه هي أسرع طريقة للتأكد من صحة عنوان URL والمفتاح الخاص بك — إذا فشل الاتصال، فسترى رسالة الخطأ هناك مباشرة بدلاً من اكتشافها في منتصف المحادثة.

عند نجاح الاختبار، انقر على حفظ (Save). سيظهر خادمك في القائمة مع نقطة حالة خضراء وعدد الأدوات التي يوفرها.

قراءة قائمة الخوادم

يعرض كل خادم في القائمة:

  • نقطة حالة — خضراء عندما نجح آخر اتصال، حمراء عندما فشلت المحاولة الأخيرة (مرر المؤشر فوقها لمعرفة الخطأ)، ورمادية قبل أول اتصال ناجح.
  • عنوان الخادم وعدد الأدوات التي يوفرها حالياً.
  • مفتاح تبديل تشغيل/إيقاف لتمكين أو تعطيل الخادم بالكامل بسرعة دون حذفه.

يقوم Your AI Connector بتحديث قائمة أدوات كل خادم في الخلفية مرة واحدة تقريباً في اليوم، لذا تظهر الأدوات الجديدة من تلقاء نفسها. الخادم البطيء أو الذي يتعذر الوصول إليه مؤقتاً لا يعيق المحادثة أبداً — يستخدم الروبوت ببساطة آخر قائمة أدوات معروفة، ويتراجع بسلاسة إذا تعذر إتمام الاستدعاء.

عندما تستمر أداة في الفشل أثناء المحادثات الفعلية

إذا فشلت نفس أداة MCP ثلاث مرات خلال 24 ساعة أثناء محادثة وكيل الذكاء الاصطناعي الخاص بك، فستتلقى تنبيهاً واحداً يومياً بشأن ذلك: عبر البريد الإلكتروني، أو تحت أيقونة الجرس، أو كإشعار دفع إذا قمت بتفعيله. يذكر التنبيه اسم الأداة، ويعرض الخطأ الأخير، ويوفر روابط للمحادثات المتأثرة، لأن الوكيل سيكون قد أخبر جهات الاتصال تلك بأنه واجه مشكلة تقنية. يعرض صف الخادم في الإعدادات سطراً بعنوان فاشل (Failing) مع عدد الأخطاء والخطأ الأخير حتى تعمل الأداة مرة أخرى؛ حيث يؤدي إجراء مكالمة ناجحة واحدة إلى مسح هذا التنبيه. يمكنك إيقاف هذه التنبيهات من خلال الإعدادات ← الإشعارات ← أخطاء الأداة.

اختيار الأدوات التي يمكن للبوت استخدامها

غالباً ما يوفر الخادم أدوات أكثر مما تريد أن يستخدمها البوت. يمكنك تشغيل أو إيقاف تشغيل أدوات فردية دون فصل الخادم بالكامل.

  1. انقر على أيقونة القلم (تعديل) الموجودة بجانب الخادم في القائمة.
  2. انتقل إلى قسم الأدوات (Tools) — سيتم إدراج كل أداة يوفرها الخادم، مع مفتاح تشغيل/إيقاف خاص بكل منها.
  3. قم بإيقاف تشغيل أي أداة لا تريد أن يستدعيها البوت، أو استخدم تمكين الكل (Enable all) / تعطيل الكل (Disable all) لضبطها دفعة واحدة.
  4. انقر على حفظ التغييرات (Save changes).

الأدوات التي تتركها قيد التشغيل فقط هي التي ستُعرض على البوت. الأداة التي يتم إيقاف تشغيلها تكون غير مرئية تماماً للبوت — فلا يمكنه استدعاؤها، ولن تُحتسب ضمن حد الـ 40 أداة.

أمران يستحقان المعرفة:

  • تبقى الأدوات الجديدة معطلة حتى تقوم بتفعيلها. بمجرد قيامك بتنظيم أدوات خادم ما، فإن أي أداة يضيفها الخادم لاحقاً ستصل وهي معطلة، لذا لن يصبح أي شيء جديد متاحاً للبوت حتى تقرر تفعيله. (الخوادم التي لم تقم بتنظيمها مطلقاً تبقي جميع أدواتها مفعلة، تماماً كما كان من قبل.)
  • هذا منفصل عن اختيار الوكيل (Agent) أدناه. هنا تقرر أي أدوات الخادم موجودة على مستوى الحساب بالكامل؛ أما على مستوى الوكيل، فأنت تقرر الخوادم التي يمكن لهذا الوكيل الوصول إليها — وإذا أردت، يمكنك تضييق نطاق أدواته بشكل أكبر لهذا الوكيل فقط.

تعيين حدود التنفيذ لكل أداة

بجانب مفتاح التشغيل/الإيقاف الخاص بكل أداة، ستجد عنصر تحكم الحدود (Limits). وهو يفتح نفس حدود التنفيذ التي يمكنك تعيينها على دالة مخصصة، مطبقة على تلك الأداة فقط — وهو أمر مفيد عندما تستدعي أداة الخادم خدمة خارجية مدفوعة، أو عندما يجب تشغيل أداة مرة واحدة فقط لكل محادثة. كل شيء هنا اختياري؛ اتركه فارغاً وستعمل الأداة تماماً كما كانت من قبل.

  • للقراءة فقط. تعلن بعض الخوادم لكل أداة ما إذا كانت تقرأ البيانات فقط. يثق خيار تلقائي (إعداد الخادم) بهذا الإعلان؛ يمكنك تجاوزه في أي من الاتجاهين — حدد الأداة كـ للقراءة فقط عندما تعلم أنها لا تنشئ أو تغير أي شيء (يسمح هذا للذكاء الاصطناعي بإعادة محاولة الرد المتقطع بأمان بدلاً من ترك العميل دون إجابة)، أو ليست للقراءة فقط عندما لا تثق في ادعاء الخادم.
  • تقديم نتيجة مخزنة مؤقتًا عند تكرار الاستدعاءات. عندما يستدعي الذكاء الاصطناعي الأداة مرة أخرى بنفس المدخلات، يتم إعادة استخدام النتيجة السابقة (لمدة تصل إلى 24 ساعة) بدلاً من استدعاء الخادم مرة أخرى.
  • الحد الأقصى لمرات التشغيل لكل محادثة والحد الأقصى لمرات التشغيل لكل نافذة زمنية يعملان تمامًا كما في الوظائف المخصصة: عمليات التشغيل الناجحة فقط، وعندما يتم الوصول إلى حد معين، يتم إخبار الذكاء الاصطناعي بالسبب ويجيب بالمعلومات التي لديه بالفعل — لا يتم ترك العميل معلقًا أبدًا. محادثات الاختبار معفاة من ذلك.
  • إرسال العروض أو العقود أو الفواتير على LinkedIn. يعمل تمامًا كما في الوظائف المخصصة: مع خيار تلقائي، لا يتم تشغيل الأداة التي يشير اسمها أو وصفها إلى أنها ترسل عرضًا أو عقدًا أو عرض أسعار أو فاتورة أو رابط دفع أو وصول عندما يرد الذكاء الاصطناعي على LinkedIn، بينما يسمح خيار مسموح به بتشغيلها هناك، ويقوم خيار مطلقًا على LinkedIn بحجب أداة قد يغفل عنها الفحص التلقائي. القنوات الأخرى لا تتأثر، وينطبق الإعداد أيضًا في وضع التجربة (Try Out).

ملاحظة صادقة حول الثقة: تتحكم الحدود في ما إذا كنا نستدعي الخادم وعدد مرات استدعائه — ولا يمكنها تغيير ما يفعله الخادم داخلياً بمجرد استدعائه. وتجاوز أداة خارجية إلى “للقراءة فقط” هو ادعاء أقوى مما هو عليه في دالتك المخصصة، لأنها تعود لشفرة برمجية خاصة بشخص آخر؛ لا تفعل ذلك إلا للأدوات التي تفهمها.


تفعيل خادم على وكيل (Agent)

تسجيل الخادم يجعله متاحاً؛ ولكن لا يزال عليك اختيار الوكلاء الذين يمكنهم استخدامه.

  1. افتح الوكيل وانتقل إلى علامة التبويب قدرات الذكاء الاصطناعي (AI Abilities).
  2. ابحث عن قسم خوادم MCP (MCP servers).
  3. قم بتفعيل كل خادم تريد أن يتمكن روبوت هذا الوكيل من استخدامه.
  4. انقر على حفظ التغييرات (Save changes) — لا يتم تطبيق التحديدات إلا بعد حفظها.

يمكنك تفعيل ما يصل إلى 5 خوادم لكل وكيل. فقط الخوادم التي تقوم بتفعيلها تكون متاحة لبوت هذا الوكيل، مما يبقي البوت مركزاً على الأدوات ذات الصلة.

اختيار الأدوات التي يمكن للوكيل استخدامها

بمجرد تفعيل خادم على وكيل، يمكنك أيضاً تضييق نطاق الأدوات التي يمكن لهذا الوكيل تحديداً استدعاؤها — وهو أمر مفيد عندما يجب على وكيل واحد قراءة البيانات فقط بينما قد يقوم آخر بإنشاء سجلات.

  1. في علامة التبويب قدرات الذكاء الاصطناعي، تحت الخادم المفعل، انقر على الصف “… أدوات مفعلة لهذا الوكيل” لتوسيع قائمة الأدوات.
  2. قم بإيقاف تشغيل أي أداة لا ينبغي لهذا الوكيل استخدامها، ثم انقر على حفظ التغييرات.

هناك قاعدتان تجعلان هذا الأمر متوقعاً:

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

مثال جاهز: ربط متجر Shopify

يأتي كل متجر Shopify مزوداً بخادم MCP مدمج — لا حاجة لتثبيت أي تطبيق أو إنشاء مفتاح. تستضيف Shopify هذا الخادم على عنوان الويب الخاص بالمتجر مع إضافة /api/mcp في نهايته.

ما الذي يحصل عليه البوت من هذا الخادم:

  • البحث عن المنتجات — العثور على المنتجات من خلال وصف ما يريده العميل (“سترة جري دافئة بسعر أقل من 100 دولار”)، مع توفر الأسعار المباشرة، والخيارات، وحالة المخزون.
  • تفاصيل المنتج — معلومات كاملة عن منتج معين، بما في ذلك الخيارات ومدى التوفر.
  • سياسات المتجر والأسئلة الشائعة — الإجابة على أسئلة الشحن، والإرجاع، واسترداد الأموال، والخصوصية، استناداً إلى صفحات المتجر الخاصة.
  • عربة التسوق — إنشاء عربة تسوق للعميل وتزويده برابط إتمام عملية الشراء.

لربط متجر، أضف خادماً بالبيانات التالية:

الحقل ما يجب إدخاله
الاسم Shopify Store (أو اسم المتجر)
عنوان URL للخادم عنوان الويب الخاص بالمتجر مضافاً إليه /api/mcp — على سبيل المثال https://mystore.com/api/mcp. يعمل أيضاً العنوان التقني للمتجر: https://mystore.myshopify.com/api/mcp.
المصادقة اترك خيار مفتاح API / الترويسة محدداً واترك قيمة ترويسة المصادقة فارغة — هذا الخادم لا يحتاج إلى مفتاح.

احفظ الإعدادات، وانقر على اختبار الاتصال، ثم قم بتفعيل الخادم على الوكيل الخاص بك — هذا كل ما في الأمر.

أمران يجب معرفتهما:

  • الطلبات غير موجودة على هذا الخادم. تتعمد Shopify إبقاء بيانات الطلبات خارج نقطة النهاية العامة هذه. بالنسبة لأسئلة “أين طلبي؟”، قم بإقران هذا الخادم بوظيفة مخصصة واحدة — راجع مثال حالة طلب Shopify.
  • يعمل مع أي متجر Shopify — بما في ذلك متجر العميل إذا كنت تدير حسابات للآخرين. كل ما تحتاجه هو عنوان الويب الخاص بالمتجر.

الأمان — اتصل فقط بالخوادم التي تثق بها

يمكن للبوت الخاص بك استدعاء خادم MCP الذي تتصل به، ويمكن للخادم إرجاع نص يقرؤه البوت ويتصرف بناءً عليه. تعامل معه مثل أي تكامل آخر يمتلك مفتاحاً لأنظمتك:

  • قم فقط بتسجيل الخوادم التي تتحكم فيها أو تثق بها تمامًا. يتم كتابة وصف الأداة بواسطة من يدير الخادم، ويقرأ البوت هذه الأوصاف ليقرر متى يستخدم الأداة.
  • استخدم مفتاح API مخصصًا ومحدود الصلاحيات، وليس بيانات اعتماد المسؤول. يتم تخزين مفتاحك بشكل آمن ولا يظهر أبدًا في تصدير البيانات. ينطبق الشيء نفسه على عمليات تسجيل الدخول عبر OAuth — حيث يتم تخزين رموز الوصول بشكل آمن وحجبها من أي عملية تصدير.
  • يجب أن يكون عنوان URL عنوان https:// عامًا. يتم رفض العناوين الداخلية، وعناوين localhost، وعناوين الشبكات الخاصة لأسباب أمنية.
  • قم بتعطيل الخادم في اللحظة التي تتوقف فيها عن الوثوق به — قم بإيقاف تشغيله أو حذفه، وسيختفي من كل وكيل (Agent) على الفور.

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

  • نقطة الحالة الحمراء / فشل الاتصال: أعد فتح الخادم وانقر على اختبار الاتصال (Test Connection) لمعرفة الخطأ الدقيق. الأسباب الأكثر شيوعاً هي مفتاح خاطئ أو منتهي الصلاحية، أو خطأ مطبعي في عنوان URL، أو أن الخادم يتطلب اسم ترويسة (header) غير Authorization.
  • توقف خادم OAuth عن العمل / يطلب منك إعادة الاتصال: يمكن إلغاء عمليات تسجيل الدخول عبر OAuth أو انتهاء صلاحيتها من جانب الخادم. افتح الخادم وانقر على اتصال (Connect) مرة أخرى لتسجيل الدخول مجدداً. لاحظ أن عمليات تسجيل الدخول عبر OAuth لا يتم نسخها أبداً بين الحسابات، لذا يجب إعادة توصيل خوادم الوكيل (Agent) المنسوخ في الحساب الذي نسخته إليه.
  • البوت لا يستخدم أداة: تحقق أولاً من تشغيل الأداة في قسم الأدوات (Tools) الخاص بالخادم (قم بتحرير الخادم لرؤية القائمة) — فالأداة المتوقفة تكون غير مرئية للبوت. ثم تأكد من تمكين الخادم على ذلك الوكيل (Agent) المحدد، وأن طلب العميل يتطابق بوضوح مع ما تقوم به الأداة. كما هو الحال مع الوظائف المخصصة، تساعد أسماء الأدوات وأوصافها الواضحة على جانب الخادم البوت في الاختيار بشكل صحيح.
  • أداة يوفرها الخادم لا تظهر للبوت: إذا قمت بتنظيم أدوات هذا الخادم، تذكر أن أي أداة تمت إضافتها بعد تنظيمك لها تصل وهي في حالة إيقاف التشغيل. قم بتحرير الخادم، وافتح قسم الأدوات (Tools)، وقم بتشغيلها.
  • هل يتعامل الموصل مع جلسات MCP HTTP؟ نعم. إذا أصدر خادمك ترويسة mcp-session-id عند إنشاء الاتصال، فإننا نقوم بتخزينها وإرسالها مرة أخرى في كل طلب لاحق، جنباً إلى جنب مع ترويسة MCP-Protocol-Version. تعمل الخوادم ذات الحالة (Stateful) دون أي تكوين إضافي من جانبك.
  • هل يعمل مع الخوادم التي تستخدم اتصال SSE الأقدم؟ نعم. الصق عنوان الخادم كما هو معطى، بما في ذلك النهاية مثل /sse. يستخدم Your AI Connector نوع الاتصال الأقدم تلقائياً عندما لا يدعم الخادم النوع الأحدث. تضع بعض الخوادم (مثل Baserow) المفتاح داخل العنوان نفسه؛ بالنسبة لهذه الخوادم، احتفظ بخيار مفتاح API / الترويسة (API key / header) محدداً واترك قيمة ترويسة المصادقة (Auth Header Value) فارغة.
  • تم تخطي أداة: يمكن للوكيل (Agent) استخدام 5 خوادم و40 أداة MCP كحد أقصى في وقت واحد. إذا كان الخادم يوفر عدداً كبيراً جداً من الأدوات، فقد لا يتم تحميل بعضها — قم بإيقاف تشغيل الأدوات التي لا تحتاجها في قسم الأدوات (Tools) بالخادم، أو اجعل كل خادم يركز على الأدوات التي تستخدمها فعلياً.

متطلبات الخطة

تعد خوادم MCP جزءًا من مجموعة أدوات المطورين، إلى جانب الوظائف المخصصة. إذا كنت لا ترى خوادم MCP (MCP Servers) في قسم AI Studio في الشريط الجانبي، فإن خطتك الحالية لا تتضمن ذلك — قم بالترقية إلى خطة تحتوي على أدوات المطورين لتفعيلها.


الخطوات التالية