/ الدليل / الملعب / Linear
● رسمي linear 🔑 يتطلب مفتاحك

Linear

بواسطة linear · linear/linear

اسمح لوكيلك بفرز مستودع Linear الخاص بك، ونشر تحديثات الدورة، وتسجيل الأخطاء من Sentry — بدون فتح التطبيق.

MCP البعيد الرسمي من Linear (SSE) يكشف عن المشاكل والمشاريع والدورات والفريق والتعليقات والمستخدمين. يتم التعامل مع OAuth من قبل Linear، لذلك لا توجد رموز وصول شخصية (PAT) للإدارة. يعمل بشكل أفضل في الجمع مع Sentry (تسجيل الأخطاء تلقائياً) و GitHub (ربط PRs) و Notion (التقارير الأسبوعية).

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

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

عرض مباشر

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

linear.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "linear",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "linear": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://mcp.linear.app/sse"
        ]
      }
    }
  }
}

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

claude mcp add linear -- npx -y mcp-remote https://mcp.linear.app/sse

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

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

استخدامات عملية: Linear

كيفية فرز مستودع Linear الفوضوي في 10 دقائق

👤 مديرو الهندسة وقادة الفريق التقني ⏱ ~15 min intermediate

متى تستخدمه: صباح يوم الاثنين. المستودع يحتوي على 200+ مشكلة لم يتم فرزها والتخطيط سيكون بعد ساعة.

المتطلبات الأساسية
  • الوصول إلى مساحة عمل Linear — OAuth من خلال mcp-remote — أول استدعاء أداة يفتح المتصفح لمنح الإذن
  • معرف الفريق (مثل ENG) — انظر إلى أي معرف مشكلة — البادئة هي معرف فريقك
الخطوات
  1. استخرج كل مشكلة لم يتم فرزها للفريق
    اسرد جميع مشاكل ENG في حالة 'Triage' أو بدون أولوية محددة، التي تم إنشاؤها في آخر 30 يوم. أرجع المعرف والعنوان والمراسل وطول الوصف.✓ تم النسخ
    → جدول بالمرشحين مع سياق كافٍ للتصنيف
  2. تجميع حسب الموضوع
    جمّع هذه في 4-6 مواضيع (خطأ / بنية تحتية / إدراج / أداء / إلخ). لكل مجموعة، اقترح أولوية ومشروع مقترح.✓ تم النسخ
    → مجموعات موضوعية مع المنطق
  3. تطبيق القرارات
    لكل مجموعة، حدّث المشاكل: اضبط الأولوية، أضف العلامة المطابقة، وانقل إلى حالة 'Backlog'. لا تسند أحداً.✓ تم النسخ
    → تم تحديث N من المشاكل، تم تسجيل التأكيدات

النتيجة: مستودع جاهز للتخطيط، مجمّع ومرتب حسب الأولوية، مع سجل تدقيق لكل تغيير قام به الوكيل.

المزالق
  • يسند الوكيل المشاكل بكثافة للأشخاص الخاطئين بناءً على 'من كتب رموز مماثلة' — أخبره صراحةً بعدم الإسناد — الإسناد قرار بشري ويجب أن يبقى كذلك
  • الطبقة المجانية من Linear تحدد معدل الطلبات بعد حوالي 1500 طلب/ساعة — حدّث في دفعات باستخدام issueBatchUpdate عند الحاجة؛ وإلا فاحتفظ بعمليات الفرز أقل من 500 مشكلة
اجمعها مع: sentry · github

إنشاء تقرير حالة الدورة الأسبوعية من Linear

👤 مديرو الهندسة وعملاء المنتج ⏱ ~10 min beginner

متى تستخدمه: عصر يوم الجمعة، تحتاج إلى كتابة التحديث الأسبوعي للقيادة.

المتطلبات الأساسية
  • دورة نشطة في Linear — Linear > فريقك > Cycles — لاحظ رقم الدورة الحالي
الخطوات
  1. استخرج إحصائيات الدورة
    بالنسبة لدورة ENG 47، اسرد جميع المشاكل مجمعة حسب الحالة. أدرج المكتملة هذا الأسبوع وقيد الإنجاز والمحظورة والمعرضة للخطر (لم يتم التحديث لمدة 3+ أيام).✓ تم النسخ
    → توزيع بالأعداد وعناوين المشاكل
  2. قارن مع الأسبوع الماضي
    قارن مع لقطة الأسبوع الماضي [الصق JSON السابق]. ما الذي تم شحنه، وما الذي انحدر إلى حالات سابقة، وما الذي حديثاً مُحظور؟✓ تم النسخ
    → فارق مع سرد
  3. صيغة التقرير
    اكتب تقرير Markdown بصفحة واحدة: النجاحات والعناصر قيد الإنجاز والعوائق والمساعدة المطلوبة. اجعله صادقاً — تقرأ القيادة بين السطور.✓ تم النسخ
    → تقرير جاهز للنسخ في Slack أو Notion

النتيجة: تحديث دورة مصقول في 10 دقائق بدلاً من 45 دقيقة.

المزالق
  • المشاكل المكتملة بدون PRs مدمجة تبدو وكأنها تقدم لكنها ليست كذلك — دمج مع GitHub MCP — تحقق من أن كل مشكلة 'مكتملة' لها PR مدمج مرجعي
اجمعها مع: github · notion

تسجيل أخطاء Linear تلقائياً من مشاكل Sentry الجديدة

👤 مهندسو الخدمة (على المناوبة) ⏱ ~15 min intermediate

متى تستخدمه: تريد أن تصبح ارتفاعات الأخطاء في الوقت الفعلي في Sentry أخطاء تتبع دون نسخ لصق يدوي.

المتطلبات الأساسية
  • Sentry MCP مثبت جنباً إلى جنب مع Linear — راجع دليل sentry للإعداد
  • عنوان Linear مخصص مثل from-sentry — Linear > Settings > Labels — أنشئه مرة واحدة
الخطوات
  1. ابحث عن مشاكل Sentry الجديدة فوق الحد
    ابحث عن مشاكل Sentry رُئيت للمرة الأولى في آخر 24 ساعة مع >50 حدث في مشروع web-prod.✓ تم النسخ
    → قائمة بمعرفات المشاكل وأعداد الأحداث
  2. تحقق من التكرارات في Linear
    لكل عنوان مشكلة Sentry، ابحث في Linear عن مشاكل موجودة بعناوين مماثلة أو تحتوي على عنوان Sentry. تخطّ تلك التي تم تسجيلها بالفعل.✓ تم النسخ
    → قائمة إزالة التكرار — فقط العناصر الجديدة فعلاً
  3. إنشاء أخطاء Linear
    أنشئ مشكلة Linear في فريق ENG لكل مشكلة Sentry جديدة: العنوان = عنوان Sentry والوصف = stacktrace + الرابط والأولوية = عاجلة إذا كانت >1000 حدث وإلا High والعنوان = from-sentry.✓ تم النسخ
    → تم إنشاء N من المشاكل مع إرجاع الروابط

النتيجة: تكامل خطأ Linear نظيف لا يسقط أبداً خطأ إنتاج على الأرض.

المزالق
  • يتم تسجيل نفس مشكلة Sentry مرتين لأن العناوين تنجرف قليلاً — استخدم معرف Sentry القصير (مثل WEB-3a91) في عنوان Linear وأزل التكرار على هذا السلسلة النصية
اجمعها مع: sentry

دفع المشاكل القديمة في الدورة الحالية

👤 قادة الفريق التقني ومديرو Scrum ⏱ ~5 min beginner

متى تستخدمه: فحص منتصف الدورة. المشاكل المسندة لمدة 5+ أيام بدون تغيير حالة عادة ما تكون محظورة.

الخطوات
  1. ابحث عن المشاكل القديمة
    اسرد المشاكل في دورة ENG الحالية التي كانت في 'In Progress' لمدة 5+ أيام بدون تغيير حالة أو تعليق.✓ تم النسخ
    → قائمة بالمسؤول والأيام القديمة
  2. انشر تعليق دفع لطيف
    أضف تعليق على كل واحد: 'فحص سريع — هل لا تزال على المسار الصحيح لهذه الدورة، أم أنك بحاجة إلى تقسيم هذا / الحصول على مساعدة؟' علّم المسؤول.✓ تم النسخ
    → تم نشر التعليقات وإرجاع الروابط
  3. تصعيد إذا تم تجاهله
    في غضون 48 ساعة، أعد التشغيل. إذا لم يكن هناك تحديث بعد، أرسل لي قائمة للمتابعة الفردية.✓ تم النسخ
    → قائمة التصعيد لمتابعة بشرية

النتيجة: عمل غير محظور بدون أن تكون المدير المزعج كل يوم.

المزالق
  • رسائل غير مرغوب فيها إذا قمت بتشغيل هذا كل ساعة — تحقق مما إذا كان الوكيل قد علّق بالفعل في آخر 3 أيام قبل النشر مرة أخرى

إنشاء هيكل مشروع Linear من مواصفة Notion

👤 عملاء المنتج وقادة الفريق التقني الذين يبدأون مبادرة جديدة ⏱ ~20 min intermediate

متى تستخدمه: لديك وثيقة متطلبات المنتج (PRD) مكتوبة وتحتاج إلى تقسيمها إلى مشاكل قابلة للتتبع.

المتطلبات الأساسية
  • Notion MCP مثبت — راجع دليل notion
  • عنوان صفحة PRD — انسخ من Notion
الخطوات
  1. اقرأ وخلص المواصفة
    اقرأ Notion PRD في <URL> واسرد كل منتج منفصل كوصف سطر واحد.✓ تم النسخ
    → 15-40 مشكلة مرشح
  2. مراجعة وتحسين
    جمّع هذه في 3-5 علامات فارقة. علّم أي منها تحتاج إلى تصميم أو عمل API أو DB كمشاكل منفصلة.✓ تم النسخ
    → شجرة المشاكل المنظمة
  3. أنشئ مشروع Linear والمشاكل
    أنشئ مشروع Linear باسم '<Spec title>' في فريق ENG. أنشئ كل علامة فارقة كمشكلة أب، مع الأطفال كمشاكل فرعية. اربط العودة إلى صفحة Notion في كل وصف.✓ تم النسخ
    → عنوان المشروع + عدد المشاكل

النتيجة: مشروع Linear مجهز بالكامل في 20 دقيقة بدلاً من ساعتين من كتابة التذاكر اليدوية.

المزالق
  • ينشئ الوكيل 80 مشكلة عندما كنت تريد 20 — دقيق جداً — في الخطوة 2، حدد بوضوح: 'لا يزيد عن 20 مشكلة في المجموع، ادمج أي شيء أصغر من يوم واحد من العمل'
اجمعها مع: notion

التركيبات

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

linear + sentry

حول ارتفاعات الأخطاء الإنتاجية إلى أخطاء Linear مراقبة تلقائياً

ابحث عن مشاكل Sentry web-prod الجديدة من آخر 24 ساعة مع >50 حدث. لكل واحد، أنشئ خطأ Linear في فريق ENG بعنوان 'from-sentry'، الأولوية High، مع stacktrace في الوصف.✓ تم النسخ
linear + github

ربط PRs تلقائياً بمشاكل Linear وإغلاق المشاكل عند دمج PRs

لكل PR مفتوح في مستودعي، ابحث عن معرف مشكلة Linear في العنوان أو اسم الفرع وأضف تعليق مرجعي على مشكلة Linear مع عنوان PR.✓ تم النسخ
linear + notion

نشر ملخصات الدورة الأسبوعية إلى قاعدة بيانات Notion

إنشاء حالة دورة ENG هذا الأسبوع وأنشئ صفحة في قاعدة بيانات Notion 'Engineering Weekly' مع التقرير الكامل.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_issues team?, assignee?, state?, label?, cycle?, query?, limit? البحث الأساسي — تصفية التدفق 1 API call
get_issue id استخرج السياق الكامل لمشكلة واحدة 1 API call
create_issue teamId, title, description?, priority?, labelIds?, assigneeId?, projectId? سجّل مشكلة جديدة 1 API call
update_issue id, stateId?, priority?, assigneeId?, labelIds?, title?, description? غيّر الحالة أو الأولوية أو الإسناد 1 API call
create_comment issueId, body انشر دفع أو ملاحظة حالة على مشكلة 1 API call
list_projects teamId? اكتشف المشاريع النشطة في فريق 1 API call
list_cycles teamId ابحث عن الدورات النشطة أو الحديثة لفريق 1 API call
list_teams اكتشف الفريق في مساحة العمل 1 API call

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

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

حصة API
1500 طلب/ساعة للتطبيقات OAuth، 120 طلب/دقيقة ذروة — سخي لأي سير عمل حقيقي
الرموز لكل استدعاء
300–1500 رمز لكل مشكلة بناءً على الوصف/التعليقات
التكلفة المالية
مجاني — Linear MCP مدرج في أي خطة Linear
نصيحة
استخدم list_issues مع مرشحات محددة بدلاً من سحب كل شيء ثم التصفية — يقلل تكلفة الرموز 10 مرات على المستودعات الكبيرة

الأمان

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

الحد الأدنى من الصلاحيات: read write issues:create
تخزين بيانات الاعتماد: OAuth عبر mcp-remote — الرموز المخزنة في ~/.mcp-auth/، قابلة للتحديث بدون إعادة تسجيل
نقل البيانات الخارجي: جميع الاتصالات إلى api.linear.app و mcp.linear.app
لا تمنح أبدًا: admin

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

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

OAuth browser popup doesn't open

قم بتشغيل npx -y mcp-remote https://mcp.linear.app/sse يدويًا مرة واحدة — سيطبع عنواناً يمكنك لصقه في متصفح

تحقق: بعد المصادقة، أعد تشغيل وكيلك؛ الرمز مخزن في ~/.mcp-auth/
403 on update_issue

دورك في Linear يفتقر إلى حق الوصول للكتابة إلى هذا الفريق. اطلب من مسؤول مساحة العمل ترقيتك أو نطاق الوكيل إلى فريق تملكه.

Issues returned but comments are missing

التعليقات هي استعلام منفصل — استخدم get_issue مع include-comments، أو اسرد التعليقات بشكل منفصل مع معرف المشكلة.

Can't find an issue you know exists

تحقق من مرشح الفريق — لا يتم إرجاع المشاكل في الفريق الآخر إلا إذا مررت team=null أو حددت هذا الفريق.

البدائل

Linear مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Jira MCPمنظمتك على Jira، وليس LinearAPI أثقل، المزيد من الحالات/الحقول للتفكير - وكلاء يعملون بشكل أسوأ على Jira من الصندوق
GitHub Issues (via GitHub MCP)تريد أن تكون المشاكل مرتبطة بإحكام بالرموز بدون أداة منفصلةفقدان الدورات والمشاريع وحالات سير العمل — GitHub Issues أبسط لكن أقل هيكلة

المزيد

الموارد

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

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

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