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

كيف تربط Onplana بـClaude Desktop

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

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

افتح Onplana ← الإعدادات ← الوكلاء نزّل Claude Desktop

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

  1. 1

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

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

  2. 2

    افتح إعداد Claude Desktop

    في Claude Desktop، انقر Settings ← Developer ← Edit Config. يُفتح claude_desktop_config.json في محررك الافتراضي. على macOS يوجد في ~/Library/Application Support/Claude/claude_desktop_config.json؛ وعلى Windows في %APPDATA%\Claude\claude_desktop_config.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

    أعد تشغيل Claude Desktop

    أغلق Claude Desktop كليًا (Command+Q على macOS، وإغلاق كامل على Windows) ثم افتحه من جديد. يُفترض أن تظهر أداة Onplana في منتقي الأدوات.

  5. 5

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

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

claude_desktop_config.json

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

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

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

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

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

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

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

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

هل يوجد OAuth بديلًا عن الرمز؟

نعم. Onplana مدرج في دليل Connectors في Claude: في Claude Desktop (أو على claude.ai) افتح Settings، وابحث عن Connectors، وتصفح الدليل، واختر Onplana، ووافق على الوصول في المتصفح، دون لصق أي شيء. يعمل تحته OAuth 2.1 مع PKCE، وينشر Onplana بيانات الاكتشاف وفق RFC 9728 وRFC 8414 على https://mcp.onplana.com/.well-known/oauth-protected-resource وoauth-authorization-server. المسار برمز ملصق الموصوف هنا هو لمن يريد ملف الإعداد؛ وOAuth لمن يفضّل ألا يدير رموزًا طويلة الأمد.

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

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

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

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

هل يمكنني استخدام Claude Code (سطر الأوامر) بدل Claude Desktop؟

نعم. في Claude Code دعم مدمج لـMCP. التثبيت في سطر واحد: `claude mcp add onplana --transport http https://mcp.onplana.com/mcp`. يبدأ Claude Code مسار OAuth عند أول استدعاء لأداة (لا رمز للصق)، ويفتح متصفحًا لتسجيل الدخول إلى Onplana ويكمل الموافقة؛ ومن بعدها ترى كل جلسة `claude` في ذلك المشروع كتالوج أدوات Onplana. لاستخدام رمز بدل OAuth، أضف `--header "Authorization: Bearer pat_…"` إلى الأمر. تحقق بـ`claude mcp list`. يعمل على macOS وLinux وWSL على Windows.

أين يمكنني إلغاء الاتصال؟

في Onplana، تعرض الإعدادات ← الوكلاء ← الاتصالات كل اتصال، سواء رموز الوصول الشخصية أو تسجيلات الدخول من المتصفح: اختر إلغاء على الصف. يسري ذلك فورًا؛ ويعيد استدعاء Claude التالي لأي أداة الخطأ 401 ويطلب منك Claude إعادة الربط.

وإن تسرّب رمزي؟

ألغه فورًا (انظر أعلاه) وأنشئ رمزًا جديدًا من اللوحة نفسها. يتوقف الرمز المكشوف عن العمل عند الاستدعاء التالي. وبدءًا من خطة Enterprise، يرى مالك المؤسسة أو مسؤولها كل استدعاء أجراه الرمز المسرّب في صفحة سجلات التدقيق، في علامة التبويب Agent Activity، ليتحقق مما استطاع المهاجم رؤيته أو تعديله.

هل يعمل على Linux؟

Claude Desktop متاح حاليًا لنظامي macOS وWindows فقط. على Linux، استخدم عميل MCP آخر مثل MCP Inspector الرسمي (npx @modelcontextprotocol/inspector) أو Cursor (المتوافق مع Linux)، أو أدمج اتصال Onplana في سكربت وكيل محلي باستخدام SDK العميل المكتوب بـTypeScript من Onplana.

ذو صلة