نظرة عامة على MCP

Shayan Taslimتم التحديث

يتيح خادم MCP من UserJot لأدوات الذكاء الاصطناعي الاتصال مباشرةً بمساحة عملك في UserJot عبر HTTP عن بُعد، من دون الحاجة إلى تثبيت حزمة محلية أو عملية وسيطة.

عنوان URL للخادم

يوفّر UserJot نقطة نهاية واحدة لـ MCP عن بُعد:

text
https://api.userjot.com/v1/mcp

المصادقة

تدعم معظم عملاء MCP الحديثة تسجيل الدخول عبر OAuth مباشرةً. الصق عنوان URL للخادم (أو استخدم زر التثبيت بنقرة واحدة أو الأمر في الإعدادات → MCP & API؛ يوجد VS Code وGemini CLI ضمن قائمة المزيد)، ثم سجّل الدخول إلى UserJot، واختر مساحة العمل، وانقر على سماح.

العميل

طريقة المصادقة الموصى بها

دليل الإعداد

Claude (الويب، سطح المكتب، الهاتف المحمول)

OAuth (بنقرة واحدة من الإعدادات → MCP & API)

الإعداد الشائع

Claude Code

OAuth (أو رمز API)

Claude Code

Cursor

OAuth (بنقرة واحدة من الإعدادات → MCP & API) أو رمز API

Cursor

Codex

OAuth (أو رمز API)

Codex

ChatGPT

OAuth (أو رمز API على سطح المكتب)

ChatGPT

VS Code (Copilot)

OAuth (ضمن المزيد في الإعدادات → MCP & API)

الإعداد الشائع

Gemini CLI

OAuth (ضمن المزيد في الإعدادات → MCP & API)

الإعداد الشائع

Windsurf وأدوات التشغيل دون واجهة/التكامل المستمر (CI)

ترويسة رمز API

Windsurf / الإعداد الشائع

تظهر التطبيقات المتصلة عبر OAuth ضمن التطبيقات المتصلة في الإعدادات → MCP & API، مع عرض الشخص الذي ربط كل تطبيق. استخدم اضغط مطولًا للإلغاء لإيقاف وصول التطبيق عند طلبه التالي.

Note

يمكن لمالكي مساحة العمل والمشرفين فقط ربط تطبيق OAuth، ويظل التطبيق المتصل يعمل ما دام الشخص الذي ربطه مالكًا أو مشرفًا.

بالنسبة إلى العملاء الذين يتطلبون ترويسة ثابتة أو البرامج النصية المؤتمتة، أنشئ رمز API في الإعدادات → MCP & API، وأرسل:

text
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 باستخدام اضغط مطولًا للإلغاء.

الخطوات التالية

هل أجاب هذا عن سؤالك؟