خوادم MCP

ما الذي ستحققه

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

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

• خادم MCP يمكن الوصول إليه عبر الإنترنت بـ https، وعنوانه (ينتهي عادةً بـ /mcp). تعرضه الخدمة التي تريد استخدامها في إعدادات المطوّرين أو إعدادات MCP.
• المفتاح الذي يطلبه الخادم إن كان يطلب: رمز وصول أو مفتاح API. أما الخوادم التي تُسجّل دخولك عبر نافذة في المتصفح (OAuth) فلا يمكن ربطها بعد.
• يجب أن تكون مالكًا أو مسؤولًا. يستطيع الأعضاء الاطلاع على الخوادم وتجربة أدواتها، لكن لا يستطيعون تغييرها.

الإعداد خطوة بخطوة

1. افتح Tools ثم تبويب MCP servers.
2. اختر Connect server.
3. الصق Server address.
4. اختر How does it sign you in?: Access token (Authorization: Bearer) لمعظم الخوادم، أو Key in a header I choose إذا ذكرت الخدمة اسم ترويسة (ثم أدخل Header name مثل X-API-Key)، أو No key.
5. أدخل Access token أو Key. وأعطِ الخادم Name إن أردت اسمًا خاصًا بك.
6. اختر Connect. تتصل Phynxa، وتسأل الخادم عمّا يقدّمه، ثم تحفظه. وإذا تعذّر الاتصال، يشرح مربع الحوار السبب ولا يُحفظ شيء.

اختيار الأدوات

تحت الخادم، اختر Show tools. تعرض كل أداة ما تفعله وما سيملؤه الوكيل (علامة الاستفهام تعني اختياري). حدّد ما تريد ثم اختر Add tool. ستظهر الآن في Tools ثم API tools مثل أي أداة أخرى، ويمكنك تغيير اسمها ووصفها ومهلتها.

الأداة المعلَّمة بـ Can't be used by an agent تحتاج إلى شيء لا يستطيع الوكيل تقديمه، ويظهر السبب.

منح الأدوات لوكيل

افتح الوكيل، تبويب Tools، Add tool، ثم اختر MCP. اختر الخادم وحدّد أدواته ثم اختر Add tool، ثم Save للوكيل. وبالنسبة لوكيل واتساب افعل الشيء نفسه في تبويب Tools فيه (راجع إنشاء وكيل واتساب).

في المكالمة ينتظر الوكيل الجواب ما لم تفعّل Run in the background في صفحة الأداة. وعلى واتساب ينتظر دائمًا.

ملاحظة. يجيب وكيل واتساب كل عميل، فلا تمنحه إلا أدوات يناسبك أن يتسبب بها أي عميل.

إدارة الخادم

• يوقف المفتاح الخادم ويشغّله. وما دام متوقفًا لا تعمل أدواته، ويعلم الوكيل بذلك.
• Reconnect يعيد الاتصال ويعيد سرد الأدوات. استخدمه بعد أن تضيف الخدمة أدوات أو تغيّرها. تحصل الأدوات التي أضفتها سابقًا على المدخلات الجديدة، وتبقى الأسماء والأوصاف التي كتبتها.
• Edit يغيّر الاسم أو العنوان أو المفتاح. والمفتاح الذي تتركه فارغًا يبقى كما هو.
• Remove يحذف الخادم وكل أداة أُنشئت منه. ويفقدها الوكلاء الذين كانوا يستخدمونها.

يعرض شريط أحمر على الخادم آخر مشكلة وزر Reconnect. وتتغير الحالة من تلقاء نفسها أيضًا: فاستدعاء يفشل لأن الخادم متوقف يعلّمه، والاستدعاء التالي الناجح يزيل العلامة.

ما ينبغي معرفته

• مفتاحك خاص. يُخزَّن مشفّرًا، ويُرسل فقط إلى الخادم الذي يخصه، ولا يُعرض مرة أخرى، حتى لك. وبعض الخدمات تضع المفتاح في العنوان نفسه (?key=...): وهذا يُخزَّن مشفّرًا أيضًا، وتعرض الصفحة العنوان دونه.
• الخادم طرف ثالث. تُعامَل أوصافه وأجوبته معلومات للوكيل لا تعليمات أبدًا، ويُطلب من الوكيل أن يعيد قراءة التفاصيل قبل أي شيء لا يمكن التراجع عنه.
• خوادم عامة فقط. يُرفض العنوان الذي يشير إلى شبكة خاصة.
• الحدود. حتى 20 خادمًا لكل مساحة عمل. ويُقتطع الجواب عند نحو 6000 حرف، ولا تُمرَّر الصور والصوت في الجواب إلى الوكيل. والأداة التي تطلب كائنًا أو قائمة تستلمها نص JSON، يكتبه الوكيل عنك. والأداة التي تتوقف لتسأل المستخدم سؤالًا لا يستطيع الوكيل استخدامها.
• التكرار. إذا طلب الوكيل التغيير نفسه مرتين في مكالمة واحدة، يُنفَّذ مرة واحدة. أما الأدوات التي يعلّمها الخادم للقراءة فقط فلا تُمنع.

الاختبار

افتح الأداة (Tools ثم اسمها)، واملأ المدخلات تحت Test وشغّلها. تستدعي الخادم فعلًا كما يفعل الوكيل، وتعرض الجواب والزمن الذي استغرقته. ثم جرّب اختبار Chat للوكيل.

النتيجة المتوقعة

يظهر الخادم Connected مع أدواته، ويعيد Test في الأداة جواب الخادم، ويستخدم الوكيل الأداة في محادثة أو مكالمة.

استكشاف الأخطاء

أدلة ذات صلة

• نظرة عامة على الأدوات
• أدوات التطبيقات المتصلة
• اختبار الأدوات واستكشاف أخطائها