التوثيق
ربط أنظمتك (MCP)
في هذه الصفحة
المساعد الذي يتحدث فقط مفيد؛ أما المساعد الذي يستطيع تنفيذ الأشياء فهو منتج. تتيح Busymate AI لـ bro استدعاء أدواتك عبر خادم MCP الخاص بك، ليبحث في أنظمتك ويجري تغييرات نيابة عن مستخدميك وفق القواعد التي تضعها.
MCP (بروتوكول سياق النموذج) معيار مفتوح لعرض الأدوات على الذكاء الاصطناعي. إذا كانت أنظمتك تدعم MCP بالفعل، يتصل بها bro كما يتصل بأي خادم آخر، من دون شفرة ربط خاصة بالمنصة.
كيف يتعامل bro مع بيانات المستخدمين
عندما يحتاج المساعد إلى تنفيذ شيء، يستدعي أداة على خادم MCP. ويجعل أمران ذلك آمنًا:
- يخبر bro خادمك بهوية المستخدم عبر رمز قصير العمر موقّع تشفيريًا يتحقق منه خادمك. لا يمكن تزويره أو إعادة استخدامه، لذلك يعرف الخادم دائمًا المستخدم الذي يخصه الطلب بالضبط.
- يفرض خادمك النطاق. لأن MCP يعرف المستخدم، لا يعيد ولا يغيّر إلا بيانات ذلك الشخص. ولا يرى bro أكثر مما يرسله خادمك.
مستويات الأذونات
تُسند إلى كل أداة تعرضها رتبة، فلا يصل المساعد إلا إلى ما يناسب صاحب الطلب:
| المستوى | لمن | ما الذي يسمح به |
|---|---|---|
| عام | الجميع بمن فيهم الضيوف | قراءات آمنة غير شخصية — معلومات المنتج والمساعدة العامة. |
| محدد الهوية | مستخدم مسجّل | قراءات وإجراءات على بياناته الخاصة فقط. |
| مفوّض | مستخدم مسجّل للإجراءات التي تحتاج إلى إذنه | النطاق نفسه للعمليات التي تريد إذنًا صريحًا من المستخدم لتنفيذها. |
| تأكيد | أي إجراء كتابة تحدده | يجب أن يؤكد المستخدم قبل التنفيذ، ويظهر الإجراء كاملًا أولًا. |
تظل العمليات المدمرة أو الحساسة خلف التأكيد: يعرض bro ما سيفعله بالتحديد وينتظر «نعم» من إنسان. لا تحدث أي كتابة بصمت.
الإعداد
قسم التكامل في وحدة تحكم Busymate AI هو مصدر الحقيقة لهذا الإعداد. يُنشأ من التكوين الحي للمستأجر المختار، لذلك تظل عناوين URL وقيم الهوية والمقاطع وقائمة النشر محدثة، ولا توجد وثيقة تسليم منفصلة يمكن أن تختلف.
- افتح وحدة التحكم ← التكامل واختر المستأجر الذي تعدّه.
- اتبع خطوة MCP إلى الاتصالات، وأضف عنوان خادمك وربط بيانات الاعتماد، ثم شغّل الفحص.
- راجع كل أداة مكتشفة وعيّن لها عن قصد سياسات عام ومحدد الهوية ومفوّض وتأكيد.
- شغّل الفحص المسبق وانشر مراجعة المستأجر. يمنع فشل الفحص أو نقص عقد الهوية النشر بدلًا من إنشاء مساعد متصل جزئيًا.
يوفر قسم التكامل أيضًا موجز أتمتة جاهزًا للنسخ ونقطة MCP لإدارة Busymate AI للفرق التي تريد من وكيل تنفيذ مسار المستأجر نفسه. راجع البدء.
اربط Claude Code بخادم MCP الخاص بالإدارة
أمر واحد؛ يتولى المتصفح تسجيل الدخول بحسابك المعتاد (OAuth 2.1 — لا يُلصق أي شيء):
claude mcp add --transport http busymate-ai https://busymate.ai/mcpثم شغّل /mcp داخل Claude Code واختر busymate-ai → مصادقة. يتصل أي عميل HTTP-MCP آخر (Claude Desktop وCursor و…) باستخدام عنوان URL فقط https://busymate.ai/mcp — يُقدَّم اكتشاف OAuth عند نقطة النهاية وعند الأصل معًا، لذا لا حاجة لأي إعداد على جانب العميل بخلاف عنوان URL.
ربط المستخدمين حساباتهم الخاصة
تفويض OAuth لكل مستخدم متاح لموصلات العلامة البيضاء. استخدمه عندما يجب على كل مستخدم تفويض حسابه في خدمة لا تديرها. اضبط بيانات اعتماد OAuth الخاصة بالتفويض والرمز والإلغاء للموصل في الاتصالات، ثم انشر أدواته المفوضة.
تدعم أدوات الحساب المفوضة وضعين صريحين:
- رمز موقّع يمثل العميل — موصى به عندما يكون منتجك قد تحقق من الزائر بالفعل. تصدر Busymate AI لخادم MCP رمزًا قصير العمر مرتبطًا بالمستأجر والموصل، فيصبح الوصول إلى الحساب تلقائيًا ولا يرى العميل تسجيل دخول ثانٍ أو طلب موافقة آخر.
- OAuth لكل عميل مسجّل — استخدمه عندما تريد تفويضًا منفصلًا. يعرض المساعد تفويض أدوات الحساب مرة واحدة، ويستخدم مسار رمز تفويض OAuth 2.1 مع PKCE، ويربط التفويض من جهة الخادم بالمستأجر والموصل والمستخدم النهائي المتحقق منه.
يرفض كلا الوضعين بأمان عند الخطأ. يستنتج خادم MCP العميل من bearer المتحقق منه فقط، ولا يثق أبدًا بمعرف حساب وارد في معاملات الأداة. يمكن إلغاء تفويضات OAuth من قائمة الحساب؛ وتنتهي الرموز الموقّعة خلال خمس دقائق كحد أقصى وتُثبّت على موصل واحد.
التالي
- البدء — مكان ربط MCP.
- الحوكمة وسياسة النماذج — فعّل الأدوات واضبط قواعد التأكيد.
- تجربة المساعد — شاهد كيف تظهر الإجراءات للمستخدم.