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

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

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

ما هو خادم MCP؟ #

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. اختر OAuth كطريقة للمصادقة. ستختفي حقول ترويسة المصادقة (Auth Header) ويحل محلها بطاقة اتصال (Connect) — لن تحتاج إلى مفتاح.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• للقراءة فقط (Read-only). تعلن بعض الخوادم لكل أداة ما إذا كانت تقرأ البيانات فقط. خيار تلقائي (إعداد الخادم) يثق في ذلك الإعلان؛ يمكنك تجاوزه في أي من الاتجاهين — حدد الأداة كـ للقراءة فقط عندما تعلم أنها لا تنشئ أو تغير أي شيء (هذا يسمح للذكاء الاصطناعي بإعادة محاولة الرد المتقطع بأمان بدلاً من ترك العميل بدون إجابة)، أو ليست للقراءة فقط عندما لا تثق في ادعاء الخادم.
• تقديم نتيجة مخزنة مؤقتاً عند التكرار (Serve cached result on repeat calls). عندما يستدعي الذكاء الاصطناعي الأداة مرة أخرى بنفس المدخلات، يتم إعادة استخدام النتيجة السابقة (لمدة تصل إلى 24 ساعة) بدلاً من استدعاء الخادم مرة أخرى.
• الحد الأقصى لمرات التشغيل لكل محادثة و الحد الأقصى لمرات التشغيل لكل نافذة زمنية تعمل تماماً كما هو الحال في الدوال المخصصة: عمليات التشغيل الناجحة فقط، وعندما يتم تفعيل حد ما، يتم إخبار الذكاء الاصطناعي بالسبب ويجيب بالمعلومات التي لديه بالفعل — لا يتم ترك العميل معلقاً أبداً. محادثات الاختبار معفاة من هذه القيود.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• الطلبات غير موجودة على هذا الخادم. تتعمد 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) دون أي تكوين إضافي من جانبك.
• تم تخطي أداة: يمكن للوكيل (Agent) استخدام 5 خوادم و40 أداة MCP كحد أقصى في المرة الواحدة. إذا كان الخادم يوفر عدداً كبيراً جداً من الأدوات، فقد لا يتم تحميل بعضها — قم بإيقاف تشغيل الأدوات التي لا تحتاجها في قسم الأدوات (Tools) بالخادم، أو اجعل كل خادم يركز على الأدوات التي تستخدمها فعلياً.

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

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

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

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