أدواتك الخاصة (MCP)

الربط والاكتشاف#

افتح Agent ← الإجراءات ← أدواتك (MCP). اربط خادمك البعيد باستخدام تدفّق OAuth أو بيانات اعتماد من نوع bearer، أو استخدم اتصال MCP موجودًا. اختر اكتشاف لقراءة كتالوج الأدوات. راجع وصف كل أداة ومعاملاتها وتعليقاتها التوضيحية (annotations) قبل تفعيلها. لا ينفّذ الاكتشاف أي أداة؛ وتكون الأدوات المكتشَفة حديثًا معطّلة.

يمكنك إعداد ثلاثة خوادم للأدوات وتفعيل 20 أداة في المجموع. تبقى بيانات الاعتماد على جانب الخادم. إزالة ربط أداة توقف هذا الربط فقط، لكنها لا تلغي اتصال المعرفة المشترك ولا صلاحية OAuth الممنوحة له؛ أدِر هذا الاتصال بشكل منفصل. لا يمكن عرض خادم MCP الخاص بإدارة المالك في Make Agent Fast كخادم أدوات للعملاء. لإدارة الـ agents الخاصة بك من Claude، راجع استخدام Claude وChatGPT.

اختيار القراءة أو الكتابة#

تتوفر القراءة فقط إذا أعلن الخادم readOnlyHint: true ولم يعلن destructiveHint: true، وأبقيتَ تصنيف الأداة على أنها قراءة. وإلا فتعامل معها على أنها كتابة. راجع ما يفعله الخادم فعليًا؛ فالتعليقات التوضيحية (annotations) ليست نظام تفويض.

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

ربط العميل المسجَّل الدخول#

تتطلب الأدوات عميلًا موثَّقًا افتراضيًا. استخدم هوية العميل الموقَّعة على موقعك؛ فالمعرّف الذي يُكتب في المحادثة ليس تحقّقًا. بالنسبة إلى السجلات الخاصة بكل عميل، اختر معامل النص (string) في الأداة الذي يعرّف العميل. يملأ الخادم هذا المعامل من معرّف العميل الموثَّق ويزيله من مدخلات النموذج. لا يمكن استخدام معاملات enum لهذا الربط.

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

الحدود والنتائج غير المؤكدة#

المخططات المدعومة هي كائنات مسطّحة تضم حتى عشرة معاملات من نوع string أو number أو integer أو boolean أو enum. تبقى الكائنات المتداخلة والمصفوفات وقواعد المخطط غير المدعومة غير متاحة. تُقيَّد النصوص بحد أقصى 200 حرف؛ ولكل استدعاء بعيد مهلة 10 ثوانٍ، وتُقتطع النتائج المرئية للنموذج عند 4 كيلوبايت. محتوى النتيجة بيانات وليس تعليمات للـ agent.

لا يوفّر MCP ضمانًا عامًا لخاصية idempotency. يُستدعى إجراء الكتابة مرة واحدة بعد التأكيد أو الموافقة. وإذا كانت نتيجته غير معروفة، فلا يعيد Make Agent Fast المحاولة تلقائيًا ويُخطر المالك. تحقّق من النظام البعيد قبل إنشاء مقترح آخر. تغيير إعداد الأداة الذي تمت مراجعته يُبطل أي مقترح أقدم.

اختبر كل عملية قراءة وكتابة تنوي استخدامها مع خادمك قبل أن يستخدمها العملاء.