نظرة عامة على MCP
يتيح خادم MCP من UserJot لأدوات الذكاء الاصطناعي الاتصال مباشرةً بمساحة عملك في UserJot عبر HTTP عن بُعد، من دون الحاجة إلى تثبيت حزمة محلية أو عملية وسيطة.
عنوان URL للخادم
يوفّر UserJot نقطة نهاية واحدة لـ MCP عن بُعد:
https://api.userjot.com/v1/mcpالمصادقة
تدعم معظم عملاء MCP الحديثة تسجيل الدخول عبر OAuth مباشرةً. الصق عنوان URL للخادم (أو استخدم زر التثبيت بنقرة واحدة أو الأمر في الإعدادات → MCP & API؛ يوجد VS Code وGemini CLI ضمن قائمة المزيد)، ثم سجّل الدخول إلى UserJot، واختر مساحة العمل، وانقر على سماح.
العميل | طريقة المصادقة الموصى بها | دليل الإعداد |
|---|---|---|
Claude (الويب، سطح المكتب، الهاتف المحمول) | OAuth (بنقرة واحدة من الإعدادات → MCP & API) | |
Claude Code | OAuth (أو رمز API) | |
Cursor | OAuth (بنقرة واحدة من الإعدادات → MCP & API) أو رمز API | |
Codex | OAuth (أو رمز API) | |
ChatGPT | OAuth (أو رمز API على سطح المكتب) | |
VS Code (Copilot) | OAuth (ضمن المزيد في الإعدادات → MCP & API) | |
Gemini CLI | OAuth (ضمن المزيد في الإعدادات → MCP & API) | |
Windsurf وأدوات التشغيل دون واجهة/التكامل المستمر (CI) | ترويسة رمز API |
تظهر التطبيقات المتصلة عبر OAuth ضمن التطبيقات المتصلة في الإعدادات → MCP & API، مع عرض الشخص الذي ربط كل تطبيق. استخدم اضغط مطولًا للإلغاء لإيقاف وصول التطبيق عند طلبه التالي.
يمكن لمالكي مساحة العمل والمشرفين فقط ربط تطبيق OAuth، ويظل التطبيق المتصل يعمل ما دام الشخص الذي ربطه مالكًا أو مشرفًا.
بالنسبة إلى العملاء الذين يتطلبون ترويسة ثابتة أو البرامج النصية المؤتمتة، أنشئ رمز API في الإعدادات → MCP & API، وأرسل:
Authorization: Bearer YOUR_USERJOT_API_TOKENما الذي يمكن لخادم MCP فعله
يوفر خادم MCP البعيد 98 أداة تغطي بيانات مساحة العمل وسير العمل فيها (عمليتا REST، وهما الرفع متعدد الأجزاء createAsset ومحو البيانات وفقًا للائحة GDPR deleteMember، متاحتان عبر REST فقط):
مساحة العمل واللوحات: استعراض بيانات مساحة العمل الوصفية وإنشاء اللوحات أو عرضها أو تحديثها أو حذفها.
الطلبات والتعليقات والتصويتات والوسوم: عرض الطلبات أو إنشاؤها أو تحديثها أو نقلها أو دمجها أو إلغاء دمجها، والعثور على طلبات مشابهة، وإدارة الاشتراكات، ونشر التعليقات أو تثبيتها، وإضافة التصويتات أو إزالتها، وإدارة الوسوم، وإرفاق الصور.
سجل التغييرات: عرض الإدخالات أو إنشاؤها أو تحديثها أو حذفها، وإدارة الطلبات المرتبطة والمؤلفين والوسوم.
المحادثات: اعرض المحادثات واقرأها وابدأ محادثات صادرة (
createConversationيتطلب خطة مدفوعة: 5 يوميًا في Starter، و15 يوميًا في Professional)، واطّلع على الجداول الزمنية، وانشر الردود والملاحظات الداخلية، وحدّث الحالة أو الشخص المسؤول.الأعضاء والشركات: البحث عن الأعضاء والشركات وعرضها ومزامنتها وتحديثها، وإدارة عضويات الشركات.
مركز المساعدة: إنشاء المجموعات والمقالات وتحديثها وحذفها ونشرها وإلغاء نشرها والبحث فيها.
الأصول: استورد الصور من مصادر بعيدة أو أنشئ عمليات رفع موقّعة مسبقًا لاستخدامها في سجلات التغييرات ومقالات المساعدة.
تتمتع جميع أدوات الكتابة والحذف بأذونات كاملة في مساحة العمل، وهي موضّحة على أنها أدوات مدمّرة كي تطلب البرامج تأكيدًا قبل تغيير البيانات.
حدود المعدل وإمكانية الوصول بحسب الخطة
يتوفر MCP في جميع الخطط، بما فيها الخطة المجانية. تشترك استدعاءات الأدوات في حدود معدل REST API الخاصة بمساحة عملك: 10 طلبات/دقيقة (150/ساعة) في الخطة المجانية، و60 طلبًا/دقيقة (1,500/ساعة) في خطة Starter، و120 طلبًا/دقيقة (5,000/ساعة) في خطة Professional. وقد تصل جلسات الوكلاء المكثفة إلى حد الخطة المجانية بسرعة.
MCP مقابل REST API
استخدم MCP عند ربط مساعد ذكاء اصطناعي أو أداة برمجة تدعم بروتوكول Model Context Protocol. استخدم REST API عند إنشاء تكامل خلفي أو برنامج نصي أو كود تطبيق خاص بك.
التعامل مع الرموز
إذا استخدمت رمز API بدلًا من OAuth، فتعامل معه كأي سر آخر:
لا تضعه مباشرةً في ملفات الإعدادات التي تودعها في مستودع الكود.
استخدم متغيرات البيئة أو مدير أسرار محليًا.
استخدم رموزًا منفصلة للبيئات المختلفة أو لأعضاء الفريق.
ألغِ الرموز غير المستخدمة من الإعدادات → MCP & API باستخدام اضغط مطولًا للإلغاء.
الخطوات التالية
اتبع الإعداد الشائع لاستخدام OAuth أو Claude على الويب/سطح المكتب أو VS Code أو Gemini CLI أو إعداد JSON عام.
انتقل مباشرةً إلى Claude Code أو Cursor أو Codex أو ChatGPT أو Windsurf.