اربط Claude Code مع Jira و Confluence بأمر واحد هو claude mcp add. تعرّف على نقطة نهاية v2، واختيارات النطاق، وتسجيل الدخول عبر OAuth، وترويسات رمز API، وأوائل الأوامر النصية، وملف .mcp.json للفريق، وجدول لاستكشاف أخطاء ستواجهها فعلًا وإصلاحها.
لا تنخفض قائمة المهام المتراكمة في Jira أبدًا، ولا يستطيع أحد العثور على شيء في Confluence. يستطيع Claude قراءة الاثنين والكتابة فيهما والإجابة عن أسئلة بشأنهما دون أن تلصق تذكرة واحدة في نافذة دردشة. الربط كله سطر واحد في الطرفية: claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp. شغّله، وسجّل الدخول مرة واحدة من متصفحك، فيستطيع Claude Code البحث في Jira باستخدام JQL، وإنشاء عناصر العمل، وقراءة صفحات Confluence أو تعديلها، كل ذلك ضمن صلاحياتك أنت.
يمرّ هذا الدليل على claude mcp add atlassian بالترتيب الذي ستحتاجه فعلًا: ما الذي يوفّره الخادم، وما الذي يجب التحقق منه أولًا، والأمر الدقيق، والنطاقات الثلاثة، وتسجيل الدخول عبر OAuth، وجولة أولى من الأوامر النصية، وخيار رمز API للأتمتة، ومشاركة الإعداد مع الفريق، وجدول لاستكشاف الأخطاء وإصلاحها. كل أمر ونقطة نهاية أدناه مأخوذ من الوثائق الحالية لـ Atlassian و Claude Code، وقد جرى التحقق منها في أكتوبر 2026.
MCP (بروتوكول سياق النموذج) هو المعيار المفتوح الذي يسمح لعميل الذكاء الاصطناعي باستدعاء أدوات خارجية. تستضيف Atlassian خادمها البعيد الخاص، Atlassian Rovo MCP Server، فلا تثبّت شيئًا محليًا. يتصل Claude Code بعنوان URL، وتتولى Atlassian المصادقة والصلاحيات واستدعاءات Jira و Confluence خلف ذلك.
تخدم نقطة نهاية واحدة Jira و Jira Service Management و Confluence و Bitbucket و Projects و Goals وتسجيلات Loom. يركّز هذا المقال على Jira و Confluence، وهما الثنائي الذي تربطه معظم الفرق أولًا. يستخدم تسجيل الدخول OAuth 2.1، وتحترم كل عملية ضوابط الوصول الحالية لديك. يرى Claude بالضبط ما يراه حسابك، لا أكثر.
لا تكتب أسماء الأدوات أبدًا. تكتب طلبًا عاديًا، فيختار Claude الأداة المناسبة. ومع ذلك، فمعرفة القائمة تساعدك على صياغة أوامر أفضل:
| المنتج | القراءة | الكتابة | البحث |
|---|---|---|---|
| Jira | getJiraIssue، listJiraProjects، listJiraBoards، listJiraIssueComments، listJiraIssueTransitions | createJiraIssue، editJiraIssue، transitionJiraIssue، addOrEditJiraIssueComment | searchJiraIssuesUsingJql |
| Confluence | getConfluenceContent، listConfluenceSpaces، listConfluenceContent، listConfluenceComments | createConfluenceContent، updateConfluenceContent، createConfluenceComment، addLabelsToConfluenceContent | searchConfluence (CQL) |
💡 نصيحة: أدوات القراءة فقط آمنة للتجربة أولًا. أدوات الكتابة تغيّر التذاكر والصفحات الحقيقية، لذا احتفظ بها إلى ما بعد نجاح الاتصال.
قائمة التحقق قصيرة، لكن تخطي أحد بنودها هو السبب الذي يعطّل معظم عمليات الإعداد:
claude --version في الطرفية. إذا طبع رقم إصدار، فأنت جاهز.
يستغرق الإعداد كله بضع دقائق بعد أن تُنجز هذه البنود.
افتح أي طرفية وشغّل:
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp
يؤدي كل جزء وظيفة واحدة:
claude mcp add يسجّل خادم MCP جديدًا لدى Claude Code.--transport http يختار ناقل HTTP القابل للبث الذي تستخدمه الخوادم البعيدة.atlassian هو الاسم المحلي. وهو ما ستراه في /mcp وفي claude mcp list.https://mcp.atlassian.com/v2/mcp هو نقطة نهاية الإصدار v2 من Atlassian.💡 نصيحة: تعرض المقالات القديمة عنوان v1. توثيق Atlassian الحالي يشير إلى v2، لذا انسخ الرابط أعلاه بدلًا من إجابة قديمة في منتدى.
يحفظ الأمر الخادم افتراضيًا في النطاق المحلي. ويمكنك اختيار مكانه باستخدام --scope:
| النطاق | العلم | يُحمَّل في | مشترك مع الفريق | يُخزَّن في |
|---|---|---|---|---|
| المحلي (الافتراضي) | --scope local | المشروع الحالي فقط | لا | ~/.claude.json |
| المشروع | --scope project | المشروع الحالي فقط | نعم، عبر نظام التحكم بالإصدارات | .mcp.json في جذر المشروع |
| المستخدم | --scope user | كل مشاريعك | لا | ~/.claude.json |
للاستخدام الشخصي عبر كل المستودعات، يكون نطاق المستخدم هو الخيار العملي:
claude mcp add --transport http atlassian --scope user https://mcp.atlassian.com/v2/mcp
يعمل نطاق المشروع هنا أيضًا، لأن الرابط لا يحمل أي سرّ. ويظل كل زميل يسجّل الدخول بحسابه الخاص في Atlassian.
إضافة الخادم لا تسجّل دخولك. أكمل بهذه الخطوات:
/mcp.claude mcp list.تفضّل البقاء في الطرفية؟ شغّل claude mcp login atlassian. على جهاز بلا واجهة، يطبع claude mcp login atlassian --no-browser رابطًا بدلًا من فتح المتصفح. ولعرض تفاصيل خادم واحد، استخدم claude mcp get atlassian. يخبرك عمود الحالة بموقعك:
| الحالة | المعنى |
|---|---|
| ✔ Connected | الخادم نشط وجاهز |
| ! Needs authentication | تسجيل الدخول عبر OAuth ما زال معلقًا |
| ✘ Failed to connect | خطأ في الاتصال، غالبًا مشكلة في الرابط أو الشبكة |
ابدأ بالقراءة. يثبت الاختبار الأول الجيد أن تسجيل الدخول يعمل، ويعرّف Claude بطريقة تنظيم حسابك في Atlassian.
اسأل بلغة عادية، أو الصق JQL مباشرة:
"اعرض المشكلات غير المحلولة في المشروع PAY التي تم تحديثها هذا الأسبوع، مرتبةً حسب الأولوية، ولخّص أهم خمس منها."
يستدعي Claude searchJiraIssuesUsingJql. إذا أردت التحكم الكامل، فأعطه الاستعلام بنفسك:
project = PAY AND status != Done AND assignee = currentUser() ORDER BY priority DESC
عندما يكون الاسم غامضًا، اطلب من Claude تشغيل lookupJiraAccountId لأحد أعضاء الفريق قبل التصفية حسب المكلَّف. فهي تحوّل الاسم المعروض أو البريد الإلكتروني إلى معرّف الحساب الذي يحتاجه JQL.
تعمل عمليات الكتابة بالطريقة نفسها، مع عادة تستحق التبنّي: اطلب مسودة أولًا.
"أعدّ مسودة لخلل (Bug) في المشروع PAY بعنوان 'Checkout fails on saved cards' باستخدام تتبّع المكدس أعلاه. اعرض لي الحقول. لا تُنشئ أي شيء حتى أقول لك «نفّذ»."
خلف الكواليس، يبحث Claude عن أنواع القضايا والحقول المطلوبة للمشروع، ثم يستدعي createJiraIssue بعد أن توافق. وتحريك العمل إلى الأمام قصير بالقدر نفسه:
"انقل PAY-142 إلى In Review وأضف تعليقًا يربط طلب السحب."
يستخدم هذا الطلب transitionJiraIssue وaddOrEditJiraIssueComment. افتراضيًا، يطلب Claude Code موافقتك قبل تشغيل أدوات MCP، لذا اقرأ كل طلب كتابة قبل أن تقبله.
💡 نصيحة: سمِّ المشروع ونوع القضية والأولوية في رسالتك الأولى. الأوامر التي تتضمن هذه التفاصيل تحتاج إلى استدعاءات أدوات أقل وأسئلة متابعة أقل، وهذا يخفض أيضًا استهلاك نقاط Rovo.
يعمل Confluence عبر بحث CQL وأدوات الصفحات:
"ابحث في Confluence عن دليل الاستجابة للحوادث ولخّص خطوات التصعيد."
"أنشئ صفحة في المساحة ENG بعنوان 'Release checklist' من الملاحظات الموجودة في هذا الملف."
"أضف تعليقًا في تذييل صفحة الإعداد الأولي يسأل إن كانت خطوات VPN ما زالت صحيحة."
يمكن للتحديثات على الصفحات الحالية أن تستبدل المحتوى كاملًا أو أن تطبّق تعديلات دقيقة. وبالنسبة لأي شيء يعتمد عليه الناس، اطلب من Claude إجراء تعديلات مستهدفة وعرض التغيير قبل الحفظ.
يناسب OAuth العمل التفاعلي اليومي. أما المصادقة برمز API فتناسب مسارات العمل الآلية والبوتات وغيرها من عمليات التشغيل غير التفاعلية، حيث لا يوجد أحد ليضغط على شاشة الموافقة. وهي اختيارية، ويجب أن يفعّلها مسؤول المؤسسة أولًا في إعدادات خادم Rovo MCP.
تقبل Atlassian صيغتين للترويسة:
Authorization: Basic <base64(email:api_token)>Authorization: Bearer <credential>أنشئ قيمة Base64 لرمز شخصي على macOS أو Linux:
printf '%s' 'you@company.com:YOUR_API_TOKEN' | base64
على Linux أضف -w 0 حتى يبقى الناتج الطويل في سطر واحد. وعلى PowerShell في Windows:
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("you@company.com:YOUR_API_TOKEN"))
ثم سجّل الخادم باسم مختلف، حتى يبقى إلى جانب إدخال OAuth الخاص بك:
claude mcp add --transport http atlassian-ci https://mcp.atlassian.com/v2/mcp \
--header "Authorization: Basic BASE64_VALUE"
⚠️ تحذير: عامل الرمز كما تعامل كلمة المرور. احتفظ به في النطاق المحلي أو نطاق المستخدم، ولا تضعه أبدًا في
.mcp.jsonمرفوع إلى المستودع، وغيّره عندما يغادر أحد الفريق.
تشير Atlassian إلى أن بعض أدوات MCP قد لا تكون متاحة مع المصادقة بالرمز، لأن الرموز تحمل نطاقات قابلة للاختيار أضيق من جلسة OAuth كاملة. إليك المفاضلة بين الخيارين في جدول واحد:
| OAuth 2.1 | رمز API | |
|---|---|---|
| الإعداد | تسجيل الدخول في المتصفح عبر /mcp | مفتاح تفعيل من المسؤول مع ترويسة |
| الاستخدام الأمثل | العمل التفاعلي اليومي | مهام CI والروبوتات والأتمتة |
| الهوية | مستخدمك | مستخدمك، أو حساب خدمة |
| توفّر الأدوات | المجموعة الكاملة | قد تغيب بعض الأدوات |
لمنح مستودع كامل الاتصال نفسه، أضف الخادم بنطاق المشروع أو اكتب الملف يدويًا:
{
"mcpServers": {
"atlassian": {
"type": "http",
"url": "https://mcp.atlassian.com/v2/mcp"
}
}
}
احفظه باسم .mcp.json في جذر المشروع وأضفه إلى المستودع. في الجلسات التفاعلية، يطلب Claude Code من كل زميل الموافقة على خوادم المشروع قبل استخدامها. وفي الأوضاع غير التفاعلية مثل claude -p، تُحمَّل خوادم المشروع دون مطالبة. ولإعادة ضبط تلك الموافقات، شغّل claude mcp reset-project-choices.
نص إشعار Atlassian نفسه: «في 1 مارس 2027 سيبدأ أي استخدام قائم للإصدار v1 تلقائيًا في عرض أدوات v2 واستخدامها.» وقد يحتاج العملاء الذين خزّنوا بيانات اعتماد قديمة إلى مسح بيانات clientIds أو .well-known المخزّنة مؤقتًا. إذا سجّلت عنوان v1 قبل شهور، فنفّذ استبدالًا نظيفًا الآن:
claude mcp logout atlassian
claude mcp remove atlassian
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp
ثم شغّل /mcp وسجّل الدخول مرة أخرى.
عادتان تحافظان على سلامة الإعداد مع الوقت:
تقع معظم الإخفاقات ضمن أنماط قليلة. ابدأ بـ claude mcp list، ثم طابِق العَرَض:
| العَرَض | السبب المحتمل | الحل |
|---|---|---|
! Needs authentication | انتهى تسجيل الدخول دون إكماله أو انتهت صلاحيته | شغّل /mcp أو claude mcp login atlassian |
✘ Failed to connect | رابط خاطئ، أو ناقل خاطئ، أو حظر على الشبكة | شغّل claude mcp get atlassian وتأكد من أن النوع http وأن الرابط ينتهي بـ /v2/mcp |
| المتصفح لا يفتح أبدًا | جلسة بعيدة أو بلا واجهة | استخدم claude mcp login atlassian --no-browser |
| تسجيل الدخول يدور في حلقة بعد تبديل الإصدارات | بيانات عميل مخزّنة قديمة | شغّل تسلسل الخروج والإزالة والإضافة المذكور أعلاه |
| أداة متوقعة غير موجودة | نطاقات الرمز أضيق من OAuth | وسّع نطاقات الرمز أو انتقل إلى OAuth |
| البحث لا يعيد شيئًا لمشروع تستطيع فتحه | عدم تطابق الاسم | اطلب من Claude سرد مشاريع Jira التي يراها، ثم استخدم الاسم الدقيق نفسه |
حين لا ينجح شيء آخر، تستغرق إزالة الخادم وإعادة إضافته نحو عشر ثوانٍ، وتستبعد وجود إدخال محلي تالف. بعد أي تغيير، أعد تشغيل claude mcp list قبل أن تلوم أمرك النصي. وسطر ✔ Connected الأخضر يخبرك بأن المشكلة في الطلب، لا في الاتصال.
يحلّ ربط Claude مع Atlassian الجانب التقني فقط. ويبقى حوله عملان: كتابة نص تذاكر يستحق القراءة، ومنح صفحات Confluence بعض الثقل البصري. يساعد PicassoIA في كليهما، كأداة منفصلة إلى جانب إعدادك في Claude Code. يعمل الربط عبر MCP أعلاه داخل Claude Code، بينما تتم الخطوات أدناه على PicassoIA.
Claude Sonnet 5 يحوّل الملاحظات الخام إلى مسودات تذاكر منظمة قبل أن تفتح الطرفية أصلًا:
low يتجاوز التفكير العميق ويجيب بأسرع وقت. انتقل إلى high أو max عندما تمس المشكلة عدة أنظمة.هل تحتاج إلى استدلال أعمق لتقرير حادثة معقد؟ Claude Opus 4.7 وClaude Fable 5 متاحان على المنصة نفسها.
دليل التشغيل الذي له صورة رأس واضحة يُفتح أكثر من كتلة نص. P-Image، وFlux 2 Pro، وSeedream 5 Pro، وGPT Image 2 كلها تحوّل جملة إلى صورة يمكنك استخدامها كلافتة للصفحة. جرّب أمرًا نصيًا مثل "لوح أبيض لفريق في ضوء الشمس مع ملاحظات لاصقة، عمق ميداني ضحل، حبيبات فيلم طبيعية".
تشمل قائمة أدوات Atlassian رفع المرفقات لقضايا Jira، لكن Confluence يدعم التنزيلات فقط، لذا أضف الصورة النهائية إلى الصفحة باستخدام محرر Confluence.
يقدم PicassoIA أيضًا ربط MCP خاصًا به لتوليد الصور والفيديو، ويُدار من حسابك. الفكرة نفسها التي أعددتها للتو: اربط مرة واحدة، ثم اسأل بلغة عادية.
شغّل الأمر، وسجّل الدخول، واطلب من Claude أول بحث JQL لك. ثم افتح PicassoIA، واختر نموذجًا، وأنشئ مسودات التذاكر والصور التي يواصل فريقك تأجيلها. ستشكرك مراجعة السبرنت القادمة.
اختر لغتك
