الأدوات الخارجية (MCP)

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

يقف Pommy على جانبي هذا المعيار، ومن المفيد توضيح ذلك قبل المتابعة. هذه الصفحة هي الجانب الذي يكون فيه Pommy العميل: مساعد الدعم يستخدم خادم جهة أخرى. أما الجانب الآخر — وكيل البرمجة الخاص بك يستخدم Pommy كخادم — فهو وكلاء البرمجة، ولا يجمع بينهما سوى الاسم.

قبل أن تبدأ#

• خادم MCP يعمل ويمكن الوصول إليه من الإنترنت العام، على عنوان نقطته الكامل — مثل https://tools.example.com/mcp، مع المسار.
• Streamable HTTP. هذا هو بروتوكول النقل الذي يستخدمه Pommy: يرسل طلبًا إلى عنوانك ويقرأ الرد. الخادم المبني بأسلوب SSE الأقدم ذي النقطتين لن يتصل، أيًا كان الخيار الذي تحدده في القائمة.
• ما يحتاجه خادمك ليثق بالمتصل — عمليًا رمز (token) ترسله في رأس.
• مساحة في خطتك. عدد خوادم MCP المسموح بها للمشروع حد مرتبط بالخطة، والخطة المجانية لا تتضمن أيًا منها. عند تجاوز الحد، تفشل الإضافة برسالة تذكر الحد.

إضافة خادم#

1. افتح API Connections

   API Connections (اتصالات API) من القائمة اليسرى، ثم Add MCP Server (إضافة خادم MCP).

2. سمّه والصق العنوان

   الاسم لك وحدك — «API الطلبات» يكفي. Server URL (رابط الخادم) هو النقطة التي يوثّقها خادمك، بمسارها الكامل. اترك Transport (بروتوكول النقل) على Streamable HTTP.

3. أضف الرؤوس التي يحتاجها

   يقبل Custom Headers (رؤوس مخصّصة) أي عدد من أزواج الاسم/القيمة، ويرسلها Pommy مع كل طلب — والحالة المعتادة رأس Authorization يحمل bearer token. لا يوجد حقل منفصل للرمز؛ الرأس هو وسيلة المصادقة. القيم مخفية، وأيقونة العين تُظهرها.

4. أضف واكتشف الأدوات

   يتصل Pommy فورًا ويسأل الخادم عمّا يستطيع فعله. افتح الصف الجديد لترى الأدوات التي وجدها، ولكل منها الوصف الذي أعطاه خادمك. القائمة الفارغة تعني أنه تعذّر الوصول إلى الخادم، أو أنه لا يعرض أي أدوات.

5. أعطه لمساعد

   الخادم الجديد غير مرتبط بأي مساعد بعد، لذا لم يتغير شيء لعملائك. القسم التالي يتولى هذا الجزء.

تفعيل الأدوات لمساعد#

تُفعَّل الأدوات لكل خادم ولكل مساعد. افتح AI Agent، وعدّل المساعد، وانتقل إلى خطوة MCP Tools (أدوات MCP): تعرض خوادم المشروع مع مؤشر الحالة وعدد الأدوات. حدد ما يُسمح لهذا المساعد باستخدامه، ثم احفظ.

تحديد خادم يمنح المساعد كل الأدوات الموجودة عليه — لا يوجد مفتاح لكل أداة. إذا كان يجب ألا يصل المساعد إلا إلى بعض أدواتك، فاعرضها على خادم ثانٍ واربطه بدلًا من الأول.

يجب أن يكون مفتاحان مفعّلين لتصل الأداة إلى المحادثة: مفتاح Active الخاص بالخادم في API Connections (زر الإيقاف المؤقت في صفه)، والتحديد في تلك الخطوة. الإيقاف المؤقت للخادم يسحب أدواته من كل المساعدين دفعة واحدة، ويحتفظ بالتعيينات لحين إعادة تشغيله.

ما الذي يُقال للمساعد#

لكل أداة يحصل المساعد على الاسم والوصف وقائمة المعاملات تمامًا كما يعرضها خادمك — لا يضيف Pommy أي شرح من عنده. لذا فالوصف على خادمك هو كل التعليمات التي يتلقاها المساعد عن متى يستخدم الأداة. اكتبه كجملة تصف الموقف («يعيد الحالة الحالية لطلب، بناءً على رقم الطلب»)، لا كمرجع API.

ما يعود يذهب إلى المساعد لا إلى العميل: يقرأ النتيجة ويكتب الرد بكلماته. ويرى فريقك الاستدعاء ونتيجته والمدة التي استغرقها في وحدة تحكم الموظفين (Agent console) أثناء المحادثة.

يجب أن تكون الأسماء مميزة. الأداة التي تحمل اسمًا مطابقًا لإحدى أدوات Pommy — search_knowledge_base وbook_calendar_appointment وtransfer_to_human وغيرها — تُستبعد دون أي تنبيه، وإذا عرض خادمان مربوطان الاسم نفسه لأداة فلن يستطيع المساعد التمييز بينهما. أضف بادئة لأسماء أدواتك إن لم تكن متأكدًا.

مراقبته#

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

• Refresh Tools (تحديث الأدوات) — يسأل الخادم مجددًا عمّا يستطيع فعله ويستبدل القائمة المحفوظة. هذا هو الشيء الوحيد الذي يحدّثها: لا يوجد اكتشاف دوري، لذا فالأداة التي تضيفها من جهتك تبقى غير مرئية لـ Pommy حتى تضغط هذا الزر.
• Health Check (فحص الحالة) — اختبار سريع لمعرفة «هل يستجيب الخادم». لا يخبرك بشيء عن عمل كل أداة على حدة.
• Pause (إيقاف مؤقت) — يُخرج أدوات الخادم من كل المحادثات دون حذف أي شيء.
• Delete (حذف) — يزيل الخادم ويحرر مكانه في خطتك.

Healthy (سليم) تعني أن آخر فحص وصل إلى خادمك ووجد أدوات. Unhealthy (غير سليم) تعني أنه عاد فارغًا أو فشل. Unknown (غير معروف) تعني أنه لم يُفحص شيء بعد. ولا تكون الحالة أكثر تفصيلًا من ذلك أبدًا — عندما يكون هناك خطأ، فالسبب من جهة خادمك، في سجلاته الخاصة.

عندما لا يعمل شيء ما#