إجراءات MCP

MCP (Model Context Protocol) معيار مفتوح يتيح لـ AI استخدام أدوات خدمة أخرى مباشرة. بدلًا من وصف نقطة ومعلماتها يدويًا، ينشر خادم MCP أدواته ويكتشفها وكيل AI ويستخدمها.

يستغرق الربط نقرة واحدة لمعظم الخدمات. انتقل إلى الإجراءات وMCP واضغط + إضافة إجراء واختر MCP.

تحقق من اتصال MCP نموذجي بنقطة وثائق Cloudflare أو Microsoft Learn. ينفذ الفحص طلبات التهيئة وقائمة الأدوات فقط، دون تسجيل دخول أو تشغيل أداة.

أدوات إعداد اختيارية

• عاين تعيينات ذاكرة MCP. طبّق قواعد ذاكرة مقدمة على نتيجة أداة MCP نموذجية دون استدعاء أداة أو تغيير ذاكرة المحادثة.

• قارن قوائم أدوات MCP. قارن قائمتي أدوات وإعدادات تفعيل معلنة لاكتشاف تغييرات التعريف ونقاط المراجعة. لا يتصل ذلك بخادم أو يثبت التوافق.

• تحقق من اتجاه اتصال MCP. أعدّ تفاصيل إعداد من نقطة عامة وغرض مختار. لا يقبل ذلك بيانات اعتماد أو يتصل بخادم أو يغير حسابك.

الربط من الكتالوج

تفتح شاشة MCP كتالوجًا قابلًا للبحث لخدمات معروفة مجمعة حسب الفئة (شائعة ودعم العملاء وCRM والمبيعات والجدولة والتجارة الإلكترونية والمدفوعات والفوترة والتسويق والبريد والتواصل والإنتاجية والبيانات والتحليلات والبحث والويب والسفر والحجز والتصميم والتطوير والبنية التحتية).

1. ابحث عن الخدمة بالتصفح أو مربع البحث.
2. اضغط بطاقتها. يفحص Quickchat الخادم ويكتشف الأدوات التي يوفرها.
3. إذا تطلبت الخدمة الدخول، تظهر لوحة يلزم التفويض. اضغط الاتصال بـ <service> ووافق على الوصول في النافذة المنبثقة، فتتحول اللوحة إلى متصلة.
4. يُنشأ الإجراء ويُفعّل وتُسرد أدواته. يستطيع وكيل AI استخدامها من الرسالة التالية.

ملاحظة

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

نصيحة

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

ربط خادم غير موجود في الكتالوج

اضغط إدخال رابط يدويًا أسفل الكتالوج، ثم:

1. الصق رابط خادم MCP (يجب أن يبدأ بـ https://).
2. إذا صادق الخادم برمز ثابت بدلًا من تسجيل الدخول، افتح رؤوس الاتصال (اختياري) وأضف الرأس الذي يتوقعه، مثل Authorization: Bearer <your-token>.
3. اضغط اتصال.

استخدم تصفح الكتالوج للعودة إلى البطاقات. إذا غابت خدمة تحتاجها، يفتح هل ينقصك تكامل؟ اقترح واحدًا بريدًا مُعدًا مسبقًا لفريقنا.

اختيار الأدوات التي يستطيع AI استخدامها

بعد الربط، يسرد الإجراء كل أدوات الخادم مع مفتاح لكل منها. عطّل ما لا تريد أن يستدعيه AI؛ يمكنك إبقاء عمليات البحث للقراءة فقط في خادم الحجز مفعلة وأداة الإلغاء معطلة.

يحدد التفعيل الافتراضي للأدوات ما يحدث إذا أضاف الخادم أداة جديدة لاحقًا: عند التشغيل تتاح فورًا، وعند الإيقاف تفعّل كل أداة بنفسك.

تحمل بعض عناصر الكتالوج علامة مضبوط بواسطة Quickchat. اختبرت Quickchat هذه الخوادم بالكامل وتقدم مجموعة أدوات مركزة وقواعد الذاكرة اللازمة ورسالة تفكير لكل منها. اختر استخدام الموصى به لرؤية ما سيغيره الإعداد المختبر: يسرد مربع تطبيق الإعداد الموصى به؟ الأدوات التي يفعّلها ويعطلها وقواعد الذاكرة التي يضبطها، ويحذّر إذا سيستبدل قواعد عدلتها. لا يُحفظ شيء حتى تحفظ الإجراء، ويمكنك تعديل كل أداة لاحقًا.

نصيحة

اسم إجراء MCP ووصف إجراء MCP تسميتان لك ولفريقك لتعريف الإجراء في القائمة، ولا يقرأهما AI. ما يوجه AI هو أوصاف أدوات خادم MCP نفسه مع التعليمات الرئيسية لوكيلك. لتوجيهه، حدد الحالات التي ينبغي استخدام أدوات الخادم فيها (“أجب عن كل سؤال مشروع بأدوات Linear”) وثبّت القيم التي سيضطر النموذج لتخمينها (“ابحث دائمًا في مساحة acme-eng”). عند ربط الخادم مرتين، سمّ كل اتصال بحسب وظيفته (“مركز مساعدة Notion” و”طلبات دعم Notion”) بدلًا من المزود.

حجز المواعيد باستخدام Calendly

عندما يتصل إجراء واحد بخادم Calendly https://mcp.calendly.com ويفعّل الأداتين أدناه، يمنحهما Quickchat مدخلات بالتوقيت المحلي. تبقى الأسماء كما هي ولا تُضاف أدوات تحويل. إذا فُعّلت أداة واحدة فقط، تحتفظ بمدخلات Calendly الأصلية.

• التوفر: تأخذ event_types-list_event_type_available_times القيم local_start_time وlocal_end_time ومنطقة IANA timezone مثل Europe/London. قدم تواريخ وأوقاتًا محلية بصيغة YYYY-MM-DDTHH:MM:SS. يحول Quickchat النطاق إلى UTC وفق قواعد المنطقة لتلك التواريخ، بما فيها أيام تغيير الساعة من 23 و25 ساعة.
• الحجز: تأخذ meetings-create_invitee القيمتين local_start_time وbooking_timezone للخيار المحدد داخل post_invitee_request. تبقى invitee.timezone منطقة العميل، وقد تختلف عن منطقة الموعد. مثلًا، يستطيع مدعو في America/New_York حجز وقت معبر عنه بـ Europe/London.

انسخ الوقت المحلي والمنطقة المعادين مع خيار التوفر. إذا تضمن الوقت إزاحة UTC، فاحتفظ بها: تميز الإزاحة الأوقات المحلية المتكررة عند تأخير الساعة. تُرفض الأوقات المحلية غير الصالحة أو غير الموجودة، والأوقات الملتبسة دون إزاحة، والإزاحات التي تخالف المنطقة المسماة.

عرض وقت لا يحجزه. قبل إنشاء الموعد، يتحقق Quickchat مجددًا من التوفر الحالي ويمرر الطابع الزمني المطابق للمزود دون تغيير إلى Calendly. إذا لم يعد الوقت متاحًا، لا تُحاول عملية الحجز. تتضمن النتيجة وقت عرض محليًا لتأكيد الوكيل؛ وتبقى حقول المزود المستخدمة في الحفظ في الذاكرة، مثل $.resource.event، متاحة.

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

حفظ نتيجة أداة MCP في الذاكرة

وسّع الأداة واستخدم الحفظ في الذاكرة عندما تحتاج قيمة من نتيجتها لاحقًا في المحادثة. أضف تعبير JSONPath للقيمة ومفتاح الذاكرة لتعريفها. يمكنك حفظ حتى 10 قيم من أداة واحدة.

تُشارك مفاتيح الذاكرة مع إجراءات API للوكيل. إذا كان إجراء API يحفظ في المفتاح نفسه، يبلغ حقل مفتاح الذاكرة عن التعارض عند الحفظ، فاختر مفتاحًا مختلفًا.

تصبح القيمة المحفوظة جزءًا من بيانات المحادثة التي يستطيع AI قراءتها في الأدوار التالية. مثلًا، تحفظ أداة الحجز URI للحدث لتعرف أداة الإلغاء الاجتماع المطلوب بدقة. لا تستخدم أدوات MCP العنصر النائب {{metadata_<key>}} الموضح لإجراءات API، لأن AI يقدم وسيطاتها مباشرة.

تحافظ تغييرات تفعيل الكل وتعطيل الكل الجماعية على قواعد الذاكرة. تحافظ إعادة الاتصال أيضًا على اختيارات الأدوات وقواعد الذاكرة أثناء تحديث قائمة أدوات الخادم.

ما يراه الزوار

أثناء تشغيل أداة، يعرض Widget الدردشة سطر حالة قصيرًا يصف ما يفعله AI. لكل أداة حقل رسالة تفكير في لوحة الأدوات: اتركه فارغًا ليُشتق السطر من اسم الأداة (تعرض search_flights عبارة “جارٍ البحث عن رحلات…”)، أو اكتب نصك (“جارٍ البحث في مركز المساعدة”). تأتي الخوادم المضبوطة بهذه الحقول مملوءة للأدوات الموصى بها. يمنح السطر الزائر معلومة مفيدة أثناء التوقف بدلًا من مؤشر كتابة فقط.

إعادة الاتصال وقطعه

• إعادة الاتصال: تعيد التفويض. استخدمها إذا انتهى الاتصال، أو أردت حسابًا آخر، أو تغيرت قائمة الأدوات وأردت جلب الجديدة.
• قطع الاتصال: تلغي التفويض المخزن وتوقف الإجراء. يبقى الإجراء في قائمتك لتعيد ربطه لاحقًا دون إعداده من البداية.

يؤدي تغيير رابط خادم MCP في إجراء متصل إلى مسح تفويضه وإيقافه، لأن بيانات اعتماد خادم لا تُستخدم مع آخر. فوّض مجددًا لإعادته للعمل.

استكشاف المشكلات

ما تراه	ما يعنيه
لم يكتمل التفويض	اضغط حاول مجددًا. إذا رفضت الوصول، وافق في المحاولة التالية. لأي فشل آخر، تواصل مع الدعم وأرفق رمز الخطأ المعروض.
متصل، لكن تحميل الأدوات فشل	نجح التفويض ولم تُحمّل قائمة الأدوات. اضغط إعادة الاتصال.
لم يُعثر على أدوات في هذا الخادم. حاول إعادة الاتصال.	فُوّض الخادم لكنه لم ينشر أدوات. تحقق من أن الحساب الموافق عليه يملك الوصول إلى البيانات المتوقعة.
أدخل رابطًا صالحًا يبدأ بـ https://	تعذر قراءة الرابط. استخدم عنوان الخادم الكامل https://. يتصل Quickchat دائمًا عبر https فلا تُرسل بيانات الاعتماد دون تشفير.
تعطّل الإجراء تلقائيًا	انتهى تفويضه أو ألغاه المزود. افتح الإجراء واضغط إعادة الاتصال.

ملاحظة

تُحتسب إجراءات MCP ضمن حصة الإجراءات المخصصة لخطة اشتراكك، مثل إجراءات API.