دليل · نحو 5 دقائق

كيف تربط Onplana بـCursor

خمس خطوات. أنشئ رمزًا، والصق مقتطف mcpServers، وأعد تحميل Cursor، وتحقق باستدعاء أداة. نحو 5 دقائق.

بعدها يمكنك أن تطلب من Agent في Cursor أشياء مثل "أنشئ خطة مشروع لإطلاق Q3 مع معالم أسبوعية" أو "لخّص مخاطر هذا الأسبوع في كل المشاريع النشطة"، فيقوم Cursor بالعمل مباشرة في Onplana دون مغادرة المحرر.

افتح Onplana ← الإعدادات ← الوكلاء توثيق MCP في Cursor

الخطوات الخمس

  1. 1

    أنشئ رمز اتصال من Onplana

    سجّل الدخول إلى Onplana على app.onplana.com. اذهب إلى الإعدادات ← الوكلاء ← ربط وكيل، واختر مربع Cursor (أو Custom MCP client)، ثم رمز وصول شخصي، ثم إنشاء رمز وعرض مقتطف الارتباط. انسخ رمز الوصول الشخصي (يبدأ بـpat_). للرمز نطاق MCP_AGENT وحده: يستطيع استدعاء أدوات MCP، لكنه لا يستطيع إنشاء رموز أخرى ولا تغيير الفوترة ولا لمس أي شيء خارج نطاق MCP.

  2. 2

    افتح إعداد MCP في Cursor

    في Cursor، افتح Settings (Command+Shift+J على macOS، وCtrl+Shift+J على Windows أو Linux)، واذهب إلى Tools & MCP واختر New MCP Server. يقرأ Cursor أيضًا إعداد JSON مباشرة: للمشروع في .cursor/mcp.json في جذر المستودع، أو عامًا في ~/.cursor/mcp.json. تعديل JSON يعطي النتيجة نفسها التي تعطيها الواجهة.

  3. 3

    الصق إعداد خادم MCP من Onplana

    أضف إدخالًا باسم "onplana" تحت المفتاح "mcpServers". الإعداد الكامل: {"mcpServers": {"onplana": {"url": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}. استبدل pat_paste-your-token-here برمز الخطوة 1. احفظ الملف.

  4. 4

    أعد تحميل Cursor

    أعد تحميل نافذة Cursor (Command+Shift+P أو Ctrl+Shift+P، ثم "Reload Window")، أو أوقف خادم onplana وشغّله من جديد في Settings، ثم Tools & MCP. تظهر أدوات Onplana في قائمة أدوات Agent بنقطة حالة خضراء بمجرد نجاح المصافحة.

  5. 5

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

    في محادثة Agent في Cursor، اطلب: "اعرض مشاريعي في Onplana". يستدعي Cursor أداة list_projects من Onplana ويعرض النتيجة. إن رأيت خطأ، فتحقق من الرمز ومن أن ملف الإعداد JSON صالح.

.cursor/mcp.json (المشروع) أو ~/.cursor/mcp.json (عام)

{
  "mcpServers": {
    "onplana": {
      "url": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      }
    }
  }
}

كيف تتحقق من أنه يعمل

افتح محادثة Agent في Cursor وجرّب أحد هذه:

  • "اعرض مشاريعي في Onplana."
  • "ما المتأخر في حسابي على Onplana؟"
  • "أنشئ مهمة في Onplana في المشروع X باسم 'نقل Postgres إلى Aurora'."
  • "أنشئ تقرير حالة للمشروع Y."

يعرض Cursor استدعاء الأداة قبل تنفيذه، فتتحقق من البيانات التي ستُقرأ أو تُكتب. تُطبَّق التعديلات في جميع الخطط؛ وفي Free لبعض إجراءات الكتابة حد شهري (ولا حد بدءًا من خطة Professional)، ويمكن للوكيل طلب معاينة لا تثبّت شيئًا عبر خياره dryRun.

الأسئلة الشائعة

أي خطة من Onplana تتضمن MCP؟

MCP متاح في جميع الخطط، بما فيها الخطة المجانية. ويزداد عدد اتصالات الوكلاء المتزامنة مع الخطة (Free 2، Professional 3، Business 5، Enterprise 10، Enterprise+ بلا حدود)، ورصيدك من رموز الذكاء الاصطناعي (مخصص شهري في الخطط المدفوعة، ومنحة لمرة واحدة في Free، إضافة إلى الرصيد الذي تشتريه) هو ما يحد الاستخدام الفعلي للذكاء الاصطناعي. يمكنك تغيير خطتك متى شئت على app.onplana.com/billing.

هل دعم MCP في Cursor مستقر؟

نعم، MCP ميزة صادرة ومستقرة في Cursor. اتصال Onplana مرتبط بالموفر CURSOR ويتلقى كل أدوات القراءة والإنشاء والتحديث. ومع ذلك، قد تتغير أماكن الإعدادات في Cursor بين إصدار وآخر؛ وإن حدث ذلك، فتحقق من المكان الحالي على docs.cursor.com واحتفظ بإدخال خادم onplana نفسه.

إعداد للمشروع أم عام؟

كلاهما مناسب. ملف .cursor/mcp.json في جذر مستودع يقصر الاتصال على ذلك المشروع (مفيد حين تقابل مستودعات مختلفة مؤسسات مختلفة في Onplana برموز منفصلة). وملف ~/.cursor/mcp.json يطبّق الاتصال على كل نوافذ Cursor. وإن عرّف كلاهما خادمًا باسم "onplana"، فإعداد المشروع هو الغالب.

ما الأدوات التي يصل إليها Cursor؟

إلى الكتالوج نفسه الذي يراه أي عميل MCP، وفيه 351 من الأدوات: القراءة (list_projects وget_project وlist_tasks وlist_my_tasks وlist_overdue وlist_risks وsearch_org_knowledge وsummarize_project وgenerate_status_report)، والكتابة (create_project وcreate_task وupdate_task وassign_task وcreate_milestone وcreate_comment وbulk_update_tasks وcreate_sprint_with_tasks وlink_dependency)، ومجالات الحوكمة، وضبط التغيير، والامتثال، والمستندات، وسير العمل. تتيح الخطة بعض الأدوات؛ والكتالوج الكامل على onplana.com/mcp.

هل يستطيع Cursor حذف المشاريع أو المهام عبر MCP؟

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

هل يوجد OAuth بدل لصق رمز؟

ينشر Onplana بيانات اكتشاف OAuth 2.1 (RFC 9728 وRFC 8414) على mcp.onplana.com/.well-known/. أما استخدام Cursor لها تلقائيًا فيعتمد على دعم مصادقة MCP في إصدارك من Cursor؛ والمسار بالرمز في الترويسة الموصوف هنا يعمل في كل الإصدارات المتوافقة مع خوادم MCP البعيدة.

أين ألغي الاتصال؟

في Onplana، في الإعدادات، ثم الوكلاء، ثم الاتصالات، ثم إلغاء على صف الرمز. يسري ذلك فورًا؛ ويعيد استدعاء Cursor التالي لأي أداة الخطأ 401. وبدءًا من خطة Enterprise، يرى مالك المؤسسة أو مسؤولها كل استدعاء أجراه الرمز في صفحة سجلات التدقيق، في علامة التبويب Agent Activity.

ذو صلة