Linear MCP: الإعداد والصلاحيات وأتمتة مهام الفريق

عنوان خادم Linear MCP وطرق المصادقة

استخدم https://mcp.linear.app/mcp عبر Streamable HTTP، وهو اتصال ويب بالخادم المستضاف. يعتمد الإعداد التفاعلي على OAuth 2.1 مع التسجيل الديناميكي للعملاء لتسجيل التطبيق العميل والحصول على تفويض المستخدم. ويمكن بدلًا من ذلك إرسال رمز OAuth أو مفتاح Linear API في الترويسة Authorization: Bearer <yourtoken>. إعداد Linear MCP

يمكن تشبيه MCP بشباك خدمة مشترك: يطلب المساعد عملية محددة، كالعثور على مهمة أو حفظ تعديل، وينفذ خادم Linear ما تسمح به صلاحيات الاتصال. يوضح طلبك ما تريد إنجازه، لكنه لا يمنح المساعد صلاحيات إضافية.

هذه طرق مختلفة لتقييد الاتصال. عبارة «لا تعدّل شيئًا» في الطلب هي تعليمات للمساعد؛ أما نقطة اتصال أو بيانات اعتماد للقراءة فقط فتضع قيدًا فعليًا على ما يستطيع تنفيذه. خيارات الوصول في Linear

إعداد الاتصال في التطبيق الذي يستخدمه فريقك

Claude وClaude Code

في تطبيق Claude على المتصفح أو سطح المكتب، افتح Settings → Connectors ووصل Linear. هذا هو المسار الموضح في صفحة تكامل Claude لدى Linear.

أما في Claude Code:

1. نفّذ claude mcp add --transport http linear-server https://mcp.linear.app/mcp في الطرفية.
2. افتح جلسة Claude Code.
3. نفّذ /mcp وأكمل خطوات المصادقة.

يرد الأمر والخطوة اللاحقة له في تعليمات Linear لإعداد Claude.

Cursor

يوفر دليل Linear الرئيسي رابطًا للتثبيت، ويوجهك إلى البحث عن Linear في صفحة أدوات MCP لدى Cursor. استخدم خيار التثبيت في قسم Cursor من دليل Linear.

وتوضح الصفحة المخصصة لتكامل Cursor أيضًا طريقة الإعداد اليدوي التالية:

1. اضغط Ctrl/Cmd + Shift + J لفتح إعدادات Cursor.
2. اختر MCP.
3. اختر Add new global MCP server.
4. أضف هذا الإعداد:

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

يستخدم هذا الإعداد mcp-remote وسيطًا بين التطبيق العميل والخادم المستضاف. وهو الإعداد المنشور في صفحة تكامل Cursor لدى Linear.

Codex CLI وإضافة بيئة التطوير

توضح Linear أن واجهة سطر الأوامر وإضافة بيئة التطوير تستخدمان إعدادات MCP نفسها.

1. نفّذ codex mcp add linear --url https://mcp.linear.app/mcp.
2. اتبع طلب تسجيل الدخول إلى Linear كما يوضحه دليل الإعداد.
3. عند الإعداد اليدوي، توجهك Linear إلى المصادقة باستخدام codex mcp login linear بعد تعديل ~/.codex/config.toml.

توجد نقطة اختلاف بين صفحات التوثيق ينبغي الانتباه إليها قبل نسخ الإعداد:

تورد الصفحة المخصصة إعداد الخادم اليدوي [mcp_servers.linear] مع url = "https://mcp.linear.app/mcp". ننقل هذه الإعدادات كما نُشرت، لكن تعارض خياري تفعيل الميزة يعني أنه لا يصح اعتبار أي منهما متطلبًا حاليًا ينطبق على الجميع. تكامل Codex لدى Linear، دليل MCP الرئيسي

استخدم مسار الإضافة وتسجيل الدخول أعلاه. يوثق دليل MCP الحالي لدى OpenAI إعداد خوادم HTTP والأمر codex mcp login <server-name> من دون اشتراط أي من خياري تفعيل الميزة. وثائق OpenAI الرسمية لـMCP

ChatGPT

اتبع المسار الذي توثقه Linear:

1. افتح إعدادات موصلات ChatGPT عبر الرابط الموجود في صفحة تكامل ChatGPT لدى Linear.
2. وصل Linear.
3. أضف Linear مصدرًا في البحث المتعمق.

تصف Linear هذا الاتصال بأنه وسيلة للرجوع إلى المهام والمشاريع والنقاشات مع الحفاظ على صلاحيات كل مستخدم الحالية. وهي لا توثق إنشاء المهام أو تحديثها عبر هذا الإعداد. استخدمه للبحث والتلخيص، واختر لأمثلة التعديل أدناه عميل MCP موثقًا يدعم الكتابة. هذا التمييز يخص الاتصال الموصوف هنا، ولا يمثل حكمًا عامًا على جميع تكاملات ChatGPT.

ما الأدوات التي تسميها Linear في وثائقها؟

التمييز المفيد هنا هو بين جلب السياق وحفظ التغييرات. يعرض الجدول التالي معرّفات الأدوات كما وردت حرفيًا في قائمة Linear المنشورة لـالأدوات شائعة الاستخدام، مع وظيفة كل منها. تظهر القائمة في صفحة تكامل Slack، ضمن القسم الخاص بتوصيل خادم Linear MCP نفسه بـSlackbot. قائمة أدوات Linear

يسمي سجل تغييرات Linear أيضًا الأدوات list_cycles وlist_issue_labels وlist_comments وsave_project وsave_document. ويوثق تفاصيل دورات العمل، وجلب التصنيفات والتعليقات على صفحات متعددة، وتعديلات المشاريع، وإنشاء المستندات أو نقل تبعيتها إلى مبادرات أو دورات عمل. هذه قائمة منشورة بالأدوات ذات الصلة، ولا تعني أن كل تطبيق عميل يتيح مجموعة متطابقة وثابتة العدد من الأدوات. أدوات دورات العمل والتصنيفات، أدوات التعليقات، أدوات المشاريع والمستندات

قد تستدعي الأمثلة القديمة create_issue وupdate_issue كلًا على حدة. وقد جمعتهما Linear في save_issue. انتبه لهذا التغيير عند نسخ طلبات قديمة أو بناء تكامل يعتمد على أسماء الأدوات. تغيير أدوات Linear

ما صلاحيات الاتصال، وما الذي يتحكم فيه المسؤول؟

تعامل مع الاتصال باعتباره مسارًا مفوضًا للوصول إلى بيانات مساحة العمل. في مصطلحات OAuth لدى Linear، يعني read «صلاحية القراءة لحساب المستخدم»، ويعني write «صلاحية الكتابة لحساب المستخدم». وفي الوضع الافتراضي الذي يعمل به التطبيق باسم المستخدم، تُنشأ الموارد باسم الشخص الذي فوّض التطبيق. صلاحيات OAuth في Linear

أما مفاتيح API، فتصف Linear صلاحياتها بأنها «وصول كامل إلى البيانات التي يستطيع مستخدمك الوصول إليها»، مع إمكانية تقييد الصلاحيات والفرق. لذلك يختلف المفتاح المقيد فعليًا عن مفتاح شخصي واسع الصلاحيات. صلاحيات مفاتيح API

تعتمد أدوات التحكم المتاحة على طريقة مصادقة الاتصال:

توضح Linear أن الغرض من الموافقة على التطبيقات هو التحكم في «التطبيقات التي يمكنها الوصول إلى مساحة العمل وبياناتها». ويمكن للأعضاء طلب الموافقة أثناء التثبيت. تنطبق ضوابط المفاتيح على المصادقة بمفاتيح API؛ ولا تغني عن إدارة اتصالات التطبيقات عبر OAuth. الموافقة على التطبيقات، إدارة API

في تطبيقات Anthropic المدعومة، يمكن لمساحات عمل Enterprise التي تستخدم Okta SAML الاستفادة من التفويض الذي تديره المؤسسة. وتقول Linear إن ذلك «يطبق صلاحياتهم الحالية في Linear». يدير المسؤولون الوصول عبر Okta، من دون الحاجة إلى تفويض منفصل من المستخدم لكل اتصال. التفويض الذي تديره المؤسسة

إذا كان المطلوب إعداد تقارير حالة فقط، فاختر الوصول للقراءة فقط. أما لفرز المهام وإنشائها، فامنح صلاحيات الكتابة اللازمة واعرض التغييرات المقترحة قبل تطبيقها. هذه توصية لتنظيم سير العمل، وليست ادعاءً بأن كل تطبيق عميل يفرض آلية الموافقة نفسها.

ثلاثة استخدامات عملية تستحق البدء بها

ابدأ بتقارير دورة العمل لأنها لا تتطلب الكتابة. ثم انتقل إلى فرز المهام إذا كان التعامل مع الوارد عملًا متكررًا. أما تحويل المواصفات إلى تذاكر فيفيد حين يقضي قائد الفريق وقتًا في نقل قرارات محسومة إلى مهام.

الأمثلة التالية افتراضية ومفصلة لتوضيح الطلبات والمخرجات المتوقعة؛ وليست نتائج اختبار أُجري بعد تسجيل الدخول.

فرز المهام الجديدة في مقترح قابل للمراجعة

يمكن لقائد هندسي أن يطلب من المساعد فحص البلاغات الواردة، وجلب المهام المشابهة الموجودة، ثم عرض التعديلات المقترحة معًا. يقلل ذلك تكرار البحث وتعديل الحقول، مع إبقاء قرار المسؤولية والأولوية بيد القائد.

مثال على المدخلات: يفيد بلاغ جديد بعنوان «زر التصدير يتوقف عن الاستجابة» بأن المتصفح يتجمد عند تصدير بيانات بعد تصفيتها. وتصف مهمة موجودة بعنوان «تصدير البيانات المصفاة لا ينتهي» الشاشة نفسها. أما بلاغ «الدعوات لا تصل» فلا يتضمن سجلات تسليم أو خطوات لإعادة إنتاج المشكلة.

الطلب:

مقترح مفيد للمراجعة:

بعد المراجعة، يمكن للقائد تفويض تطبيق التغييرات المتفق عليها فقط في التصنيفات والمكلّفين بالمهام عبر save_issue، مع إبقاء البلاغات غير الواضحة كما هي. وينبغي أن يعيد المساعد روابط المهام المتأثرة وسجلًا بالحقول التي تغيرت. ترد عمليات الجلب والحفظ في قائمة أدوات Linear.

قبل بناء نظام فرز مخصص، قارنه بميزة Triage Intelligence. توفر Linear بالفعل اقتراحات للحقول واكتشافًا للتكرار والعلاقات بين المهام. ويكون تنسيق العمليات عبر MCP بصورة مخصصة أجدى عندما يحتاج القرار إلى سياق أو قواعد تتجاوز سير العمل المدمج. Triage Intelligence

تحويل المواصفات إلى مهام من دون اختراع متطلبات

يمكن للمؤسس تحويل موجز ميزة معتمد إلى مسودات مهام، ثم إنشاء المهام التي اجتازت المراجعة في Linear. الفائدة هنا هي الاتساق: ترتبط كل تذكرة بالمتطلب الذي استندت إليه، وتظل القرارات الناقصة واضحة.

مثال على المواصفات: «يستطيع مسؤولو مساحة العمل دعوة الأعضاء بالبريد الإلكتروني. يقبل المدعوون الدعوة عبر رابط في رسالة بريد إلكتروني. ويمكن للمسؤولين إلغاء الدعوات المعلقة. تغييرات الفوترة والدعوات الجماعية خارج النطاق».

الطلب:

التقسيم المقترح للمهام:

أسئلة لم تُحسم: ماذا يحدث إذا كان عنوان البريد الإلكتروني يخص عضوًا موجودًا بالفعل؟ هل تنتهي صلاحية الدعوة؟ ماذا ينبغي أن يرى المدعو بعد إلغائها؟ تظل هذه أسئلة مفتوحة حتى يحسمها مالك المنتج.

بعد الموافقة، يمكن للمساعد إنشاء المهمة الرئيسية والمهام الفرعية، وإرجاع روابطها، وتحديد أي عنصر تعذر إنشاؤه. إنشاء المهام الفرعية من إمكانات MCP الموثقة. تغييرات MCP لدى Linear

يتولى المساعد نقل المتطلبات إلى المهام، ويظل حسم قرارات المنتج مسؤولية مالك المنتج.

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

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

قد يغطي التقرير الأسبوعي وملخص دورة العمل فترتين مختلفتين. حدد الفريق والدورة والفترة التي يغطيها التقرير، حتى لا تتحول عبارة «اكتمل خلال هذه الدورة» ضمنيًا إلى «اكتمل هذا الأسبوع».

مثال على المادة المصدرية: وُضعت مهمة «رسالة الدعوة بالبريد الإلكتروني» في حالة «مكتملة» خلال الفترة التي يغطيها التقرير. ولا تزال «قبول الدعوة» في حالة «قيد التنفيذ». ويذكر تعليق على «إلغاء الدعوة» أن التنفيذ ينتظر قرارًا متعلقًا بالمنتج حول ما يراه المستخدم عند فتح رابط دعوة أُلغيت.

الطلب:

مثال على المسودة:

في المسودة الفعلية، ينبغي إرفاق كل جملة برابط المهمة المقابلة لها. يتجنب المثال عمدًا ذكر نسبة إنجاز أو الادعاء بأن الميزة أُطلقت. وتوفر أدوات جلب دورات العمل والمهام والتعليقات ما يلزم لهذا الاستخدام. أدوات دورات العمل والمهام، جلب التعليقات

استخدامات إضافية بعد استقرار مسارات العمل السابقة

إنشاء التعليقات من إمكانات الخادم الموثقة، وتوفر أدوات المشاريع السياق اللازم لتسليم العمل. إمكانات الخادم، أدوات المشاريع

حساب الجدوى: وقت المراجعة جزء من التكلفة

البند المتأثر في الميزانية هو تكلفة التنسيق الهندسي. قبل MCP، يبحث القائد وينسخ المعلومات ويوفق بينها ويكتب. وبعد توصيل المساعد، يظل على القائد تحديد نطاق الطلب ومراجعة النتيجة وتصحيح الأخطاء.

استخدم المعادلة التالية لحساب نقطة التعادل وفق تكاليفك:

صافي القيمة = (وقت الإعداد اليدوي − وقت الإعداد بمساعدة المساعد والمراجعة والتصحيح) × تكلفة ساعة العمل الشاملة − التكاليف الإضافية للتطبيق العميل والتشغيل.

التقرير المصقول الذي يستغرق التحقق منه وقتًا أطول لم يوفر وقت الفريق. حافظ على نطاق التقرير نفسه عند المقارنة بين طريقتي العمل، واحتسب الوقت اللازم لإصلاح التعديلات الخاطئة. الهدف المفيد هو تقليل جهد التنسيق لكل نتيجة معتمدة.

للمقارنة بين الاشتراكات، راجع أسعار Linear. وإذا لم يُحسم اختيار أداة تتبع العمل بعد، فتتناول مقارنة Linear وJira هذا القرار. أما دليل أفضل خوادم MCP فيغطي اتصالات أخرى ذات صلة.

ما الذي يستحق بناء منتج حوله؟

خدمة لإعداد مسودات تقارير دورات العمل هي أقوى فرصة للبدء. قد يدفع قائد هندسي مقابل تقرير متسق يلتزم بحدود الفريق، ويفصل العمل المنجز عن العمل المفتوح، ويستند إلى أدلة من المهام. وأصغر نسخة مفيدة من الخدمة تحفظ تعريف التقرير، وتجلب بيانات الدورة ذات الصلة، وتنتج مسودة قابلة للتحرير. أما الجدولة وإعادة المحاولة والتسليم فتكون من مهام تطبيقك.

التحدي هو التميز: يسهل تقليد طلب عام لتلخيص العمل. ما قد يشكل منتجًا هو تطبيق قواعد الشركة في إعداد التقارير، وإمكانية تتبع المعلومات إلى مصادرها، وآلية المراجعة. تحقق من أن الفرق تواجه صعوبة متكررة في هذه التفاصيل قبل بناء خدمة مستقلة باشتراك.

قائمة مخصصة لمراجعة مقترحات الفرز فرصة أضيق نطاقًا. قد يدفع قائد فريق المنصة أو هندسة الدعم مقابل جمع سياق مهام Linear مع سياسات توجيه المهام الخاصة بفريقه وسياق الدعم الذي مُنح وصولًا مستقلًا إليه. تعرض أصغر نسخة التغييرات المقترحة للحقول والأدلة وخيار الموافقة أو التجاوز، ثم تطبق التغييرات المعتمدة.

التحدي هنا هو المنافسة المباشرة مع ميزة Triage Intelligence المدمجة في Linear. ابنِ هذا الحل فقط حين يغيّر السياق الإضافي أو السياسة قرارًا لا يعالجه النظام المدمج بما يكفي لذلك الفريق. هذه فرضيات لمنتجات محتملة، وليست نتائج مزعومة لعملاء.

أين تنتهي فائدة الاتصال؟

يمنح MCP المساعد إمكانية تنفيذ عمليات؛ لكنه لا يحسم المتطلبات الغامضة ولا يجعل بيانات المهام الناقصة موثوقة. يمكن لتذكرة في حالة «مكتملة» أن تدعم معلومة عن حالة تلك التذكرة. لكنها لا تثبت بمفردها أن الميزة وصلت إلى العميل.

كذلك، لا يعني تفويض الوصول إلى Linear تفويض الوصول إلى كل مستند أو مستودع شيفرة أو نظام دعم مذكور في إحدى المهام. إذا كان الحل الذي تبنيه يحتاج إلى تلك المصادر، فخطط لمسارات منفصلة للوصول إليها وجلب بياناتها.

في الإعدادات الجديدة، استخدم /mcp. تصنف Linear المسار /sse على أنه بديل احتياطي متقادم. ويصرح خادم jerhadf المجتمعي الأقدم أيضًا بأنه متقادم ولم يعد يخضع للصيانة، ويوجه المستخدمين إلى خادم Linear الرسمي. الإرشادات الحالية لنقطة الاتصال

خطوتك في بداية الأسبوع: اطلب من القائد الهندسي تحديد الفريق ودورة العمل والفترة التي سيغطيها تقرير حالة أولي باتصال للقراءة فقط. تحقق من معلومات المسودة بالرجوع إلى المهام المرتبطة بها، وقارن جهد إعدادها بالعملية الحالية. وسّع الاستخدام ليشمل الكتابة حين يصبح لدى الفريق إجراء واضح للمراجعة.

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