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

Shayan Taslimتم التحديث

لا يتطلب UserJot تثبيت حزمة MCP محليًا. وصّل عميلك مباشرةً بعنوان URL لخادم UserJot MCP البعيد، ثم سجّل الدخول باستخدام OAuth أو أدخل رمز API.

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

سجّل الدخول باستخدام OAuth (موصى به)

افتح الإعدادات → MCP وamp; API في لوحة تحكم UserJot للوصول إلى أزرار التثبيت بنقرة واحدة والأوامر التي يمكنك نسخها. عندما يطلب منك عميلك تسجيل الدخول، سيفتح متصفحك UserJot لتختار مساحة عمل وتنقر على سماح.

  • Claude (الويب وسطح المكتب والهاتف المحمول): اختر Claude من الإعدادات → MCP وamp; API وانقر على إضافة إلى Claude. سيفتح Claude مع إعداد الموصل مسبقًا؛ أكّد بالنقر على إضافة ثم سجّل الدخول.

  • VS Code (وضع وكيل Copilot): افتح المزيد ← VS Code ضمن الإعدادات ← MCP & API، وانقر على إضافة إلى VS Code، ثم أكّد التثبيت وسجّل الدخول.

  • Gemini CLI: افتح المزيد ← Gemini CLI ضمن الإعدادات ← MCP & API، أو شغّل هذا الأمر في الطرفية، ثم شغّل /mcp auth userjot داخل Gemini CLI لتسجيل الدخول:

Bash
gemini mcp add --transport http --scope user userjot https://api.userjot.com/v1/mcp

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

استخدام رمز API

بالنسبة إلى العملاء الذين يتطلبون ترويسة مخصّصة (مثل Windsurf) أو البيئات التي لا تتضمن واجهة مستخدم، أنشئ رمزًا في الإعدادات → MCP وamp; API وأرسِل:

text
Server URL:    https://api.userjot.com/v1/mcp
Authorization: Bearer YOUR_USERJOT_API_TOKEN

تقبل معظم عملاء MCP عبر HTTP البعيد إعدادًا بصيغة JSON مثل هذا (في عملاء OAuth، احذف كتلة headers):

JSON
{
  "mcpServers": {
    "userjot": {
      "type": "http",
      "url": "https://api.userjot.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_USERJOT_API_TOKEN"
      }
    }
  }
}

التحقق من الاتصال

بعد الاتصال، اطلب من عميلك فحص الخادم userjot أو استدعاء getWorkspace. إذا نجح الاتصال، فسيعرض عميلك تفاصيل مساحة العمل والأدوات المتاحة دون الحاجة إلى أي إعداد محلي.

استكشاف الأخطاء وإصلاحها

إذا تعذر الاتصال، فتحقق أولًا من العناصر التالية:

  • إذا سجّلت الدخول باستخدام OAuth، فتأكد من أن التطبيق لا يزال مدرجًا ضمن التطبيقات المتصلة في الإعدادات → MCP وamp; API، وأنك لا تزال مالكًا أو مسؤولًا في مساحة العمل.

  • إذا كنت تستخدم رمز API، فتأكد من عدم إلغاء الرمز وأن ترويسة Authorization تبدأ بـ Bearer .

  • تأكد من أن عميلك يدعم خوادم MCP عبر HTTP البعيد (Streamable HTTP).

  • تأكد من وجود ملف الإعداد في الموقع الصحيح، ثم أعد تشغيل العميل بعد تعديله.

  • تحقق مما إذا كنت قد تجاوزت حد معدل طلبات API في خطتك.

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

  • راجع جميع الأدوات الـ98 المتاحة وتفاصيل الأمان في نظرة عامة على MCP.

  • استخدم REST API إذا كنت تكتب تعليمات برمجية مباشرةً للواجهة الخلفية.

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