/ الدليل / الملعب / Plane MCP Server
← كل الخوادم ↗ GitHub
● رسمي makeplane 🔑 يتطلب مفتاحك

Plane MCP Server

بواسطة makeplane · makeplane/plane-mcp-server

MCP للطرف الأول في الطائرة - تحكم كامل في مساحة العمل من وكيلك: أكثر من 55 أداة عبر المشاريع وعناصر العمل والدورات والوحدات النمطية والمبادرات والمزيد.

plane-mcp-server هو خادم MCP الرسمي من Plane. باستخدام مفتاح API ومساحة العمل، يمكن للوكلاء إنشاء المشاريع وتحديثها، وإدارة عناصر العمل من البداية إلى النهاية (CRUD + بحث)، وتشغيل الدورات والوحدات النمطية، وتوجيه المبادرات على مستوى مساحة العمل، وفرز قائمة انتظار الإدخال، وتكوين خصائص عنصر العمل المخصصة، والبحث عن المستخدم الحالي. يدعم stdio (محلي) عبر uvx، وكذلك النقل عبر HTTP/عن بعد باستخدام رؤوس OAuth أو PAT للعملاء المستضافين.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

plane-mcp-server.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ],
      "env": {
        "PLANE_API_KEY": "<from Plane → Settings → API tokens>",
        "PLANE_WORKSPACE_SLUG": "your-workspace-slug",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ],
      "env": {
        "PLANE_API_KEY": "<from Plane → Settings → API tokens>",
        "PLANE_WORKSPACE_SLUG": "your-workspace-slug",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ],
      "env": {
        "PLANE_API_KEY": "<from Plane → Settings → API tokens>",
        "PLANE_WORKSPACE_SLUG": "your-workspace-slug",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ],
      "env": {
        "PLANE_API_KEY": "<from Plane → Settings → API tokens>",
        "PLANE_WORKSPACE_SLUG": "your-workspace-slug",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "plane-mcp-server",
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "plane-mcp-server": {
      "command": {
        "path": "uvx",
        "args": [
          "plane-mcp-server",
          "stdio"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add plane-mcp-server -- uvx plane-mcp-server stdio

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Plane MCP Server

فرز قائمة انتظار استقبال الطائرة من الدردشة

👤 قادة الفريق ورؤساء المشاريع الذين يقومون باستقبال الطلبات الواردة ⏱ ~15 min beginner

متى تستخدمه: الطلبات الجديدة تهبط في المدخول؛ تريد تصنيفها بشكل مجمّع وتوجيهها.

المتطلبات الأساسية
  • مفتاح API المستوي — المستوى → الإعدادات → رموز واجهة برمجة التطبيقات → إنشاء
  • سبيكة مساحة العمل — انظر إلى مقطع URL بعد /app/
الخطوات
  1. قائمة عناصر المدخول
    قم بإدراج آخر 20 عنصر عمل؛ سوف أقوم بفرزهم.✓ تم النسخ
    → صفوف تحتوي على المعرف والعنوان والمرسل والعمر
  2. تصنيف + نقل
    لكل منها: اقتراح المشروع المستهدف والتسمية؛ بعد أن أؤكد، قبول في المشروع.✓ تم النسخ
    → يقبل عناصر المسار في المشروع الصحيح؛ بقية البقاء في المدخول

النتيجة: عدد أقل من العناصر المدخولة، وتوجيه أفضل، دون فتح واجهة المستخدم.

المزالق
  • قبول بالجملة دون مراجعة — اطلب دائمًا تأكيدًا بشريًا بين التصنيف والقبول
اجمعها مع: github · linear

خطط لسباق سريع عن طريق نقل العناصر إلى الدورة التالية

👤 فرق هندسية تدير دورات الطائرة ⏱ ~30 min intermediate

متى تستخدمه: وقت تخطيط الدورة؛ تحتاج إلى سحب العناصر الصحيحة وتعيين التقديرات.

الخطوات
  1. اقتراح قائمة الدورة
    العناصر المرشحة لـ Sprint 24 في المشروع "acme-api": أي شيء يحمل علامة "جاهز" بتقدير ≥ 5.✓ تم النسخ
    → قائمة مرتبة ومحددة بالتقدير
  2. نقلهم إلى الدورة
    بعد التأكيد، أضف عناصر العمل هذه إلى Sprint 24.✓ تم النسخ
    → تحتوي الدورة الآن على المجموعة المعتمدة
  3. ضبط رابط المبادرة
    اربط الدورة بمبادرة "إعادة محاولة إعداد الفواتير".✓ تم النسخ
    → تظهر المبادرة الدورة كمساهم

النتيجة: تم تنظيم العدو في تمريرة واحدة، مع التقاط نسب المبادرة.

المزالق
  • قم بتقدير الانحراف لأن كلود خمن القيم — اطلب العناصر ذات التقديرات الموجودة؛ لا تدع الوكيل يخترع النقاط
اجمعها مع: github

إنشاء مبادرة تشمل مشاريع متعددة

👤 ينسق المهندسون بالإضافة إلى الموظفين أو مديري المشاريع عبر الفرق ⏱ ~25 min intermediate

متى تستخدمه: يتجاوز الجهد الاستراتيجي حدود المشروع وتريد عرضًا على مستوى مساحة العمل.

الخطوات
  1. إنشاء المبادرة
    إنشاء مبادرة "Ship SOC 2 Type II" للربع الثالث إلى الربع الرابع من عام 2026.✓ تم النسخ
    → تم إرجاع معرف المبادرة
  2. ربط المشاريع والعناصر المساهمة
    ربط مشروعي "المنصة" و"الفوترة"؛ اسحب 6 عناصر تحمل علامة الامتثال من كل منها.✓ تم النسخ
    → العناصر الموسومة بالمبادرة

النتيجة: لوحة معلومات المبادرة مملوءة بعمل حقيقي، وليست حاوية فارغة.

اجمعها مع: notion

إضافة خاصية "خطر" مخصصة إلى المشروع

👤 تقوم الفرق بإثراء عناصر العمل بما يتجاوز الحقول الافتراضية ⏱ ~15 min intermediate

متى تستخدمه: أنت بحاجة إلى مجال لا توفره الطائرة خارج الصندوق.

الخطوات
  1. إنشاء الخاصية
    أضف خاصية "خطر" مخصصة (التعداد: منخفض/متوسط/عالي) لمشروع "acme-api".✓ تم النسخ
    → تم تكوين الخاصية؛ مرئية في واجهة المستخدم
  2. قيم الردم
    قم بتعيين Risk=med لجميع العناصر المفتوحة المسماة "نطاق غير معروف".✓ تم النسخ
    → تم تحديث العناصر بكميات كبيرة

النتيجة: نموذج بيانات أكثر ثراءً دون فتح إعدادات المستوى يدويًا.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

plane-mcp-server + github

قم بربط الممثلين الدائمين المدمجين مرة أخرى بعنصر عمل المستوى الذي قاموا بإغلاقه

عند دمج PR #412، قم بإلحاق رابط الدمج بعنصر العمل 'ACME-221' وقم بتعيين الحالة إلى تم.✓ تم النسخ
plane-mcp-server + linear

عمل المرآة: إنشاء عناصر مستوية من المسائل الخطية، أو العكس

لكل إصدار خطي يحمل اسم "المرآة المستوية"، قم بإنشاء عنصر عمل مستوي مطابق بنفس العنوان والوصف.✓ تم النسخ
plane-mcp-server + notion

أرسل ملخصات الدورة إلى Notion لقراءات أصحاب المصلحة

في نهاية السباق، قم بتلخيص Sprint 24 في المستوى وانشره في صفحة فكرة "التحديثات الهندسية".✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
projects.* varies قائمة/إنشاء/تحديث المشاريع والأعضاء 1 API call
work_items.* varies CRUD كامل + بحث في عناصر العمل 1 API call
cycles.* varies إدارة سباقات السرعة / الدورات وعناصرها 1 API call
modules.* varies إدارة الوحدات والتحويلات 1 API call
initiatives.* varies التخطيط الاستراتيجي على مستوى مساحة العمل 1 API call
intake.* varies قبول أو رفض أو توجيه المدخول 1 API call
properties.* project_id + schema تكوين الممتلكات المخصصة 1 API call

التكلفة والحدود

تكلفة التشغيل

حصة API
مقيد بحدود واجهة برمجة التطبيقات (API) لخطة الطائرة الخاصة بك
الرموز لكل استدعاء
صغير بالنسبة لمعظم العمليات؛ كبيرة عند جلب أوصاف العناصر مع المرفقات
التكلفة المالية
مجانًا - مضمن في خطة الطائرة الخاصة بك
نصيحة
قم بإدراج مرشحات ضيقة (التسميات، الحالة، الدورة) بدلاً من جلب كل شيء وتصفيته في Claude.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: PLANE_API_KEY ينتمي إلى env vars — لا تلتزم أبدًا. قم بالتدوير من واجهة مستخدم الطائرة إذا تم تسريبها.
نقل البيانات الخارجي: تنتقل حركة المرور إلى PLANE_BASE_URL الذي تم تكوينه فقط (Plane Cloud أو المثيل المستضاف ذاتيًا).

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

401 غير مصرح به

PLANE_API_KEY مفقود/منتهية الصلاحية، أو مساحة عمل خاطئة. إعادة إنشاء الرمز المميز.

تحقق: curl -H 'X-API-Key: $PLANE_API_KEY' $PLANE_BASE_URL/api/v1/workspaces/
عدم تطابق سبيكة مساحة العمل

يجب أن يتطابق PLANE_WORKSPACE_SLUG تمامًا مع مقطع URL في /app/<slug>/.

تحقق: Open Plane in the browser; copy the slug from the URL
حد المعدل

إضافة فترات توقف بين العمليات المجمعة؛ حدود معدل واجهة API المستوية لكل مساحة عمل.

تحقق: Inspect response headers for rate-limit fields

البدائل

Plane MCP Server مقابل البدائل

البديلمتى تستخدمهاالمقايضة
linearفريقك يعيش في خطي، وليس في الطائرةأداة مختلفة، شكل مختلف
mondayفريقك موجود على موقع Monday.comنموذج بيانات مختلف
shrimp-task-managerأنت فقط تريد مدير مهام محليًا، وليس نظامًا أساسيًا كاملاً لإدارة المشاريعلا يوجد تعاون الفريق

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills