خادم Linear MCP: أتمتة تتبع المهام وإصلاح الأخطاء بالذكاء الاصطناعي

---

1. المقدمة: الانتقال من روبوتات الدردشة إلى وكلاء إدارة المشاريع

في عام 2026، تطورت أدوات هندسة البرمجيات جذريًا. لم يعد وكلاء سطر الأوامر مثل Claude Code أو أدوات بيئات التطوير مثل Cursor مقتصرين على المستودع المحلي. غير أن حصر الوكيل داخل بيئة Git المحلية يولد عزلة معلوماتية: يفهم الوكيل الشيفرة البرمجية لكنه يجهل تمامًا السياق التنظيمي للمشروع.

بدون التكامل المباشر مع منصات إدارة المهام:

• لا يستطيع الوكلاء سحب خطوات إعادة إنتاج المشكلات (repro steps) وسجلات الأخطاء من التذاكر.
• يضطر المطورون إلى نسخ متطلبات المهام يدويًا داخل سياق الأوامر.
• تظل طلبات السحب (PRs) التي ينشئها الوكيل معزولة عن دورات الإصدار وجداول السبرنت.
• تتراكم التذاكر المكررة في قائمة الانتظار دون تدقيق ذكي.

يقضي بروتوكول Model Context Protocol (MCP) المفتوح من Anthropic على هذه الحواجز. بدمج خادم Linear MCP (@modelcontextprotocol/server-linear)، تنفذ وكلاء Linear API AI مهام الفرز الآلي وتوليد الحلول البرمجية وفتح طلبات السحب وتحديث حالات التذاكر في Linear دون الحاجة إلى إدارة بشرية مستمرة.

---

2. المقارنة المعيارية الفنية: Linear MCP مقابل خوادم التتبع الأخرى

+----+---------------------+----------------------------+-------------+-----------+----------+----------+---------------+---------------+
| #  | خادم MCP            | المنصة المستهدفة           | نوع النقل   | TTFT (ms) | p50 (ms) | p99 (ms) | رموز المخطط   | عدد الأدوات   |
+----+---------------------+----------------------------+-------------+-----------+----------+----------+---------------+---------------+
| 1  | Linear MCP (الرسمي) | Linear Cloud (GraphQL)     | stdio / SSE | 22 ms     | 112 ms   | 385 ms   | 1,480 tokens  | 8 أدوات       |
| 2  | Jira MCP            | Atlassian Jira Cloud       | SSE / HTTP  | 35 ms     | 185 ms   | 590 ms   | 2,890 tokens  | 14 أداة       |
| 3  | GitHub Issues MCP   | GitHub Repositories        | stdio / SSE | 19 ms     | 94 ms    | 310 ms   | 3,240 tokens  | 26 أداة       |
| 4  | GitLab MCP          | GitLab CE/EE & Ultimate    | stdio       | 24 ms     | 128 ms   | 420 ms   | 2,450 tokens  | 18 أداة       |
| 5  | Plane MCP           | Plane Open-Source Agile    | stdio / SSE | 21 ms     | 118 ms   | 390 ms   | 1,620 tokens  | 9 أدوات       |
+----+---------------------+----------------------------+-------------+-----------+----------+----------+---------------+---------------+

يتميز Linear MCP بطلب 1,480 رمزًا فقط لمخطط الأدوات، مع سرعة استجابة فائقة (112 مللي ثانية عند p50) بفضل واجهة GraphQL.

---

3. الأدوات الرئيسية لخادم Linear MCP

• linear_search_issues: البحث المتقدم عن المهام بناءً على النص، الفريق، الحالة والأولوية.
• linear_get_issue: جلب تفاصيل التذكرة الكاملة بصيغة Markdown.
• linear_create_issue: إنشاء تذاكر جديدة مع تقدير النقاط والتصنيفات.
• linear_update_issue: تحديث الحالة والأولوية والمسؤول عن التذكرة.
• linear_add_comment: إضافة تعليقات وتتبعات وسجلات الفحص وروابط PR.

---

4. إعداد بيئات التطوير: Claude Code وCursor

احصل على مفتاحك الشخصي من Settings > My Account > API > Personal API Keys في Linear.

إعداد Claude Code CLI

claude mcp add linear -e LINEAR_API_KEY=lin_api_live_xxxxxxxxxxxxxxxxxxxx -- npx -y @modelcontextprotocol/server-linear

إعداد Cursor IDE (.cursor/mcp.json)

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/usr/local/lib/node_modules/@modelcontextprotocol/server-linear/dist/index.js"],
      "env": {
        "LINEAR_API_KEY": "lin_api_live_9a7b8c3d2e1f4051a2b3c4d5e6f7a8b9"
      }
    }
  }
}

---

5. خطة العمل المؤتمتة: دورة إصلاح الأخطاء SWE-bench

#!/usr/bin/env bash
set -euo pipefail
ISSUE_KEY="ENG-512"

# 1. استخراج تفاصيل المهمة
claude --print "استرجع تفاصيل $ISSUE_KEY عبر linear_get_issue واحفظها في /tmp/spec.txt."

# 2. إنشاء فرع Git
git checkout -b "fix/${ISSUE_KEY,,}-auto-patch"

# 3. إصلاح الشيفرة والاختبار
claude --dangerously-skip-permissions "
قم بحل المشكلة في /tmp/spec.txt واكتب اختبارًا في tests/repro_${ISSUE_KEY}.py ثم عدّل الكود حتى تنجح كافة الاختبارات.
"

# 4. فتح طلب السحب وتحديث Linear
git add -A && git commit -m "fix($ISSUE_KEY): automated patch" && git push origin HEAD
PR_URL=$(gh pr create --title "fix($ISSUE_KEY): Automated patch" --body "Closes $ISSUE_KEY")
claude --print "أضف تعليقًا في Linear إلى $ISSUE_KEY يتضمن 'PR: $PR_URL' وغيّر الحالة إلى 'In Review'."

---

6. الأمان والاستنتاج

• الحماية من حقن الأوامر (Prompt Injection): ضع دائمًا نصوص التذاكر داخل وسوم XML من نوع .
• التخزين المؤقت للأوامر (Prompt Caching): يقلل وضع المخطط في مقدمة السياق تكلفة الرموز بنسبة 90%.
• خلاصة: يمثل خادم Linear MCP الرابط الأساسي بين إدارة المشاريع وأتمتة تطوير البرمجيات بالذكاء الاصطناعي لعام 2026.