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

كيف تربط Onplana بـWindsurf

خمس خطوات. أنشئ رمزًا، والصق مقتطف mcpServers (يستخدم Windsurf المفتاح serverUrl)، وحدّث Cascade، وتحقق باستدعاء أداة. نحو 5 دقائق.

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

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

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

  1. 1

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

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

  2. 2

    افتح إعداد MCP في Windsurf Cascade

    في Windsurf، افتح لوحة Plugins (MCP) واختر "View raw config". يُفتح mcp_config.json. على macOS وLinux يوجد في ~/.codeium/windsurf/mcp_config.json؛ وعلى Windows، في المجلد .codeium\windsurf في ملف المستخدم الخاص بك. إن كان الملف فارغًا، فابدأه بـ{}.

  3. 3

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

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

  4. 4

    حدّث Cascade

    في لوحة Plugins (MCP)، انقر "Refresh" (السهم الدائري) ليعيد Cascade قراءة الإعداد ويجري مصافحة MCP. يُفترض أن يُظهر خادم onplana حالة خضراء وعدد الأدوات المتاحة. يُبقي Cascade 100 أداة MCP مفعّلة على الأكثر ويعرض Onplana 351 أداة، فإن نقصت أدوات من Onplana، فأوقف خوادم أو أدوات أخرى لا تحتاج إليها.

  5. 5

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

    في Cascade، اطلب: "اعرض مشاريعي في Onplana". يستدعي Windsurf أداة list_projects من Onplana ويعرض النتيجة. إن رأيت خطأ، فتحقق من الرمز، ومن أن المفتاح "serverUrl" (لا "url")، ومن أن JSON صالح.

~/.codeium/windsurf/mcp_config.json

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

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

افتح Cascade وجرّب أحد هذه:

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

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

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

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

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

لماذا يستخدم Windsurf المفتاح "serverUrl" بدل "url"؟

هذا مخطط إعداد Windsurf لخوادم MCP البعيدة عبر HTTP. يستخدم Claude Desktop وCursor المفتاح "url"؛ ويستخدم Windsurf Cascade المفتاح "serverUrl". وباقي الإدخال (اسم الخادم onplana وترويسة Authorization) مطابق. واستخدام "url" خطأً هو السبب الأشيع لعدم ظهور اتصال Windsurf دون أي رسالة خطأ.

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

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

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

إلى الكتالوج نفسه الذي يراه أي عميل 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.

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

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

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

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

ذو صلة