عمليات ربط MCP للوكلاء المخصصين

تتيح عمليات ربط MCP (بروتوكول سياق النموذج) لوكيلك المخصَّص الاتصال بشكل آمن بالتطبيقات الخارجية. باستخدام عمليات ربط MCP، يمكن لوكيلك قراءة المعلومات واتخاذ إجراءات باستخدام عمليات ربط مكونة مسبقاً مع تطبيقات مثل Linear وRamp وFigma وغيرها—أو الاتصال بأي تطبيق عن طريق إعداد عمليات ربط MCP مخصَّصة.

ملاحظة: عمليات ربط MCP متاحة فقط في خطط الأعمال و الخطة المؤسسية.

تتيح عمليات ربط MCP للوكلاء المخصَّصين التفاعل مع الأدوات والخدمات الخارجية من خلال بروتوكول سياق النموذج (MCP). تعمل أدوات MCP مع جميع أنواع المشغلات، بما في ذلك عمليات التشغيل المجدولة، وعمليات التشغيل التي يتم تشغيلها بناءً على أحداث Notion أو Slack، والتشغيل اليدوي من الدردشة أو الإشارات (@mentions).

الميزات الرئيسية:

• خوادم مكونة مسبقاً: اتصل بسرعة بالتطبيقات الشائعة دون أي تهيئة إضافية.

• خوادم مخصصة: اتصل بأي أداة تدعم خادم MCP مستضاف باستخدام عناوين URL المتاحة للجمهور.

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

كل عملية ربط MCP فريدة لوكيل مخصَّص واحد وتستخدم بيانات اعتماد الشخص الذي قام بمصادقته. لا تتم مشاركة عمليات الربط بين الوكلاء، حتى لو كانوا يتصلون بنفس الخدمة.

هذا يعني:

• إذا قمت بإعداد عملية ربط Figma للوكيل (أ)، فسيحتاج الوكيل (ب) إلى عملية ربط Figma منفصلة خاصة به.

• يجب عليك تسجيل الدخول إلى كل خادم MCP لكل وكيل مخصَّص تقوم بتهيئته.

• إلغاء عملية ربط في وكيل مخصَّص واحد لا يؤثر على الوكلاء المخصَّصين الآخرين.

يمكنك الاتصال بالتطبيقات التالية دون أي تهيئة إضافية:

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. افتح إعدادات الوكيل المخصص الخاص بك.

2. انتقل إلى الأدوات والوصول.

3. انقر على إضافة ربط → إضافة.

4. اختر خادماً مُعداً مسبقاً.

5. اتبع مطالبات المصادقة لربط حسابك.

6. حدد الأدوات التي تريد من وكيلك المخصَّص استخدامها من الخادم. ستختلف هذه الأدوات بناءً على الخادم الذي تختاره.

7. انقر على ربط.

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

للسماح بخوادم MCP المخصصة:

1. بصفتك مسؤول مساحة عمل، انتقل إلى الإعدادات → الاتصالات.

2. في علامة التبويب إدارة، قم بتفعيل تمكين خوادم MCP المخصصة.

لاختيار ما إذا كان بإمكان الأعضاء تثبيت أي ربط أو فقط الروابط المعتمدة من قبل المسؤول:

1. بصفتك مسؤول مساحة عمل، انتقل إلى الإعدادات → الاتصالات.

2. في علامة التبويب Manage، ابحث عن قسم Manage permissions.

3. بجانب Limit which connections members can install، اختر واحداً مما يلي:

   • Approved & recommended: الموافقة تلقائياً على جميع عمليات الربط التي توصي بها Notion.

   • Approved only: تحديد كل عملية ربط يمكن للأعضاء تثبيتها يدوياً.

4. حدد Approved connections لمراجعة ما يمكن للأعضاء تثبيته.

5. حدد Add approved connection، ثم اختر ما تريد السماح به:

   • Connections: ابحث عن ربط بالاسم أو المعرف (ID) وأضفه إلى القائمة المعتمدة.

   • Custom MCP server: أضف عنوان URL خاصاً بخادم MCP مخصص تريد السماح به.

6. انقر على Save.

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

لإضافة خادم MCP مخصَّص إلى وكيل مخصَّص:

1. افتح Settings الخاصة بوكيلك المخصَّص.

2. انتقل إلى الأدوات والوصول.

3. انقر على إضافة ربط → خادم MCP مخصَّص.

4. ستحتاج إلى إدخال عنوان URL الخاص بخادم MCP من الأداة أو المزود الذي تتصل به (على سبيل المثال: فريق الأدوات الداخلية في شركتك).

5. قدّم اسماً للعرض خاصاً بعملية الربط (اختياري).

6. أضف أي تفاصيل مصادقة مطلوبة.

7. انقر على ربط.

قد تدعم خوادم MCP المخصصة إحدى طريقتي تسجيل الدخول التاليتين أو كلتيهما:

• OAuth

• المصادقة المستندة إلى الرأس (Header-based authentication)

  (على سبيل المثال، مفاتيح API أو رموز الحامل "bearer tokens")

لا تدعم بعض خوادم OAuth تسجيل العميل الديناميكي (DCR). وهذا يعني أنه يجب على Notion تسجيل تطبيق عميل مسبقاً لدى خدمة الطرف الثالث قبل أن يتمكن تسجيل الدخول عبر OAuth من العمل. إذا كان الخادم الذي تريد استخدامه لا يدعم DCR، فراجع وثائقه لمعرفة ما إذا كان بإمكانك استخدام مفتاح API أو رمز حامل (bearer token) بدلاً من ذلك. إذا لم يكن أي من الخيارين متاحاً، فلا يمكن استخدام خادم MCP مع الوكلاء المخصَّصين (Custom Agents).

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

أدوات قراءة وكتابة

• أدوات القراءة (مثل: البحث، الجلب، القائمة، العرض) تسمح للوكيل المخصَّص باسترجاع المعلومات أو عرضها دون إجراء تغييرات على الأنظمة الخارجية.

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

التشغيل تلقائياً أو السؤال دائماً

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

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

• السماح دائماً يوافق بشكل دائم على جميع الأدوات من خادم ما ويزيل مطالبات التأكيد المستقبلية.

لإزالة ربط MCP

1. افتح إعدادات الوكيل الخاص بك.

2. انتقل إلى الأدوات والوصول.

3. ابحث عن ربط MCP وانقر على قطع الربط.

4. انقر على قطع الربط للتأكيد.

5. اختبر وكيلك دائماً بعد إجراء التغييرات. يمكنك إعادة الربط في أي وقت عن طريق المصادقة مرة أخرى.

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

تحترم عمليات ربط MCP مستويات أذونات المستخدم المحددة في وكيلك المخصص. إليك ما يمكن لكل مستوى إذن فعله باستخدام الأدوات المتصلة بـ MCP.

يمكن للمستخدمين الذين لديهم أذونات الوصول الكامل والقدرة على التحرير لوكيل مخصص القيام بما يلي:

• أضف عمليات ربط MCP جديدة إلى الوكيل المخصص.

• الدردشة مع الوكيل واستخدام جميع الأدوات المتصلة، حتى لو لم يكن لديهم حق الوصول إلى الأداة خارج الوكيل.

• عرض سجِل نشاط الوكيل واستخدام أداة MCP.

• إزالة عمليات ربط MCP الحالية.

• إعادة ربط أو تحديث بيانات اعتماد خادم MCP.

وبالنسبة لعمليات ربط MCP التي يقومون بإعدادها، يمكن للمستخدمين الذين لديهم أذونات "وصول كامل" و"يمكنه التحرير":

• تكوين الأدوات المُمكَّنة أو المُعطَّلة وتغيير إعدادات تنفيذ الأداة (التشغيل تلقائياً مقابل السؤال دائماً)

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

يمكن للمستخدمين الذين لديهم أذونات العرض والتفاعل للوكيل المخصص القيام بما يلي:

• الدردشة مع الوكيل المخصص واستخدام جميع الأدوات المتصلة، حتى لو لم يكن لديهم حق الوصول إلى الأدوات خارج الوكيل المخصص.

• تنفيذ إجراءات القراءة والكتابة من خلال الوكيل.

• الموافقة على إجراءات الكتابة أو إلغاؤها عند طلب التأكيد.

• عرض خوادم MCP المتصلة (في إعدادات الوكيل المخصص).

لا يمكن للمستخدمين الذين لديهم أذونات "يمكنه العرض والتفاعل" ما يلي:

• إضافة أو إزالة عمليات ربط MCP.

• تغيير الأدوات المُمكَّنة.

• تعديل إعدادات تنفيذ الأداة.

• عرض سجل النشاط الكامل للوكيل.

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

إذا لم تظهر الأدوات بعد الربط:

• قم بتحديث صفحة إعدادات الوكيل.

• تحقق من نجاح مصادقة خادم MCP (ابحث عن علامة اختيار خضراء أو حالة "متصل").

• تحقق من أن الخادم متصل بالإنترنت ويعيد البيانات الوصفية للأداة.

• حاول إعادة توصيل الخادم، أو قطع الربط وإعادة إضافته.

إذا فشلت عمليات التشغيل للوكيل المخصص مع أخطاء MCP:

• تحقق من علامة التبويب النشاط للحصول على رسائل خطأ محددة.

• تحقق من أن ربطك لا يزال صالحاً (قد تكون الرموز المميزة قد انتهت صلاحيتها).

• تأكد من أن الربط لا يزال مُمكّناً في إعدادات الوكيل.

• حاول إعادة توصيل خادم MCP لتحديث بيانات الاعتماد.

• حدّث تعليمات الوكيل المخصَّص لذكر اسم الخادم أو الأداة التي تتطلع إلى استخدامها. على سبيل المثال: "استخدم Linear MCP لاسترداد البيانات الوصفية لهذا النموذج."