/ الدليل / الملعب / MCP Atlassian
← كل الخوادم ↗ GitHub
● مجتمع sooperset 🔑 يتطلب مفتاحك

MCP Atlassian

بواسطة sooperset · sooperset/mcp-atlassian

المعيار الذهبي للمجتمع لـ Jira + Confluence في Claude — بحث JQL، رفع التذاكر وانتقالها، قراءة/كتابة صفحات Confluence، كل ذلك خلف خادم stdio واحد.

MCP Atlassian هو موصِّل Atlassian الأكثر نجوماً من الأطراف الثالثة، ويدعم كلاً من Cloud وServer/Data Center. يعرض بحث JQL، وعمليات CRUD للقضايا والانتقالات والتعليقات والمرفقات، وواجهة Confluence Storage API الكاملة. المصادقة عبر API token (Cloud) أو PAT (Server). يدعم وضع القراءة فقط للنشرات ذات الصلاحيات المحدودة.

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

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

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

عرض مباشر

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

mcp-atlassian-sooperset.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

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

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

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

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

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

claude mcp add mcp-atlassian-sooperset -- uvx mcp-atlassian

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

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

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

تصنيف خطأ إنتاج إلى تذكرة Jira مع رابط Confluence runbook

👤 المهندسون في حالة الاستدعاء ⏱ ~10 min intermediate

متى تستخدمه: أطلق Sentry تنبيهاً — تريد تذكرة Jira مصنَّفة ورابط runbook بسرعة.

المتطلبات الأساسية
  • API tokens — Atlassian → My Account → Security → API tokens
الخطوات
  1. البحث عن المشكلات ذات الصلة
    Atlassian: search Jira for issues containing 'NullPointerException OrderService' in the last 30 days. Also search Confluence for runbook pages mentioning OrderService.✓ تم النسخ
    → كلا مجموعتي النتائج مُعادتان
  2. القرار: تكرار أم جديدة
    If there's an open BUG issue in last 14 days, comment on it with the new stack trace. Otherwise create a new BUG, link the runbook page, set priority High.✓ تم النسخ
    → استدعاء jira_add_comment أو jira_create_issue مرة واحدة فقط
  3. التسليم
    Tell me the ticket key and short summary so I can post it in Slack.✓ تم النسخ
    → ABC-1234 + ملخص بسطر واحد

النتيجة: تذكرة مصنَّفة مع رابط runbook في أقل من دقيقتين؛ بلا تكرار للمشكلات.

المزالق
  • لصق stack trace في Jira كنص عادي يفقد التنسيق — ضعه بين علامات {code}؛ يُرسِل MCP كما هو
  • حقن JQL عبر إدخال المستخدم — اقتبس معاملات السلاسل دائماً؛ تهرب الأداة لكن كن صريحاً
اجمعها مع: sentry · github

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

👤 قادة التقنية / مديرو الهندسة ⏱ ~10 min beginner

متى تستخدمه: صباح الاثنين: تحتاج تلخيص ما تم شحنه وما هو محجوب.

الخطوات
  1. سحب ما تم إنجازه الأسبوع الماضي
    Atlassian: JQL project = PLAT AND status changed to Done during (-7d, now()) ORDER BY updated DESC✓ تم النسخ
    → قائمة قضايا مع المُعيَّن والمفتاح والملخص
  2. سحب المحجوبات
    Now JQL project = PLAT AND status = Blocked — for each, summarize the latest comment.✓ تم النسخ
    → قائمة المحجوبات مع ملخص آخر تعليق لكل قضية
  3. التأليف
    Format as a 200-word weekly report grouped by Shipped / Blocked / At Risk.✓ تم النسخ
    → تقرير موجز جاهز للصق

النتيجة: تقرير حالة مجمَّع في 90 ثانية مع مفاتيح القضايا المُستشهَد بها.

المزالق
  • تضخيم السياق بسلاسل تعليق طويلة — استخدم jira_get_issue مع fields=summary,status,assignee فقط

صياغة RFC في Confluence من نقاش

👤 المهندسون الكاتبون لوثائق التصميم ⏱ ~20 min intermediate

متى تستخدمه: ناقشتم نهجاً في الدردشة؛ تريد صفحة Confluence منه.

الخطوات
  1. إيجاد المساحة الأم
    Atlassian: find the 'Engineering RFC' space. List its top-level pages.✓ تم النسخ
    → المساحة + الصفحة الأم مُحدَّدتان
  2. التأليف
    Create a new page under it titled 'RFC: switch from Redis to Valkey'. Sections: context, goals/non-goals, options considered, decision, plan. Use the discussion above as raw material.✓ تم النسخ
    → تُعيد confluence_create_page رابط URL

النتيجة: RFC مُسوَّدة جاهزة للمراجعة.

المزالق
  • معرِّف الصفحة الأم خاطئ — ابحث دائماً عبر confluence_search بالمساحة أولاً

تنظيف التذاكر القديمة بالجملة

👤 مديرو الهندسة ⏱ ~30 min intermediate

متى تستخدمه: يحتوي backlog على 200 تذكرة ميتة؛ تريد تصفيتها.

الخطوات
  1. تحديد القديمة
    JQL: project = PLAT AND status = Open AND updated < -90d. Limit 50.✓ تم النسخ
    → قائمة بالقضايا القديمة
  2. اقتراح الإجراء
    For each, propose: close-stale, reassign-to-triage, or keep. Show me 10 at a time before transitioning.✓ تم النسخ
    → توصية لكل قضية؛ توافق على دفعات
  3. التطبيق
    Close the ones I approved with a 'closing as stale' comment.✓ تم النسخ
    → استدعاء jira_transition_issue + jira_add_comment لكل قضية

النتيجة: backlog مُنظَّف مع سجل تدقيق لكل قضية.

المزالق
  • إغلاق تلقائي لتذاكر حقيقية لكنها هادئة — احرص على الدُفعات + التأكيد قبل الانتقال

التركيبات

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

mcp-atlassian-sooperset + sentry

تحويل أخطاء Sentry إلى تذاكر Jira منسَّقة

Sentry: get the latest critical issue. Atlassian: file a Jira BUG with the stack trace and link the Sentry URL.✓ تم النسخ
mcp-atlassian-sooperset + github

ربط PRs بتذاكر Jira تلقائياً

GitHub: find PRs merged today. Atlassian: for each, comment on the linked Jira issue with the PR URL.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
jira_search jql: str, limit? أي بحث في Jira 1 API call
jira_get_issue key: str, fields? عندما تحتاج نص قضية واحدة كاملاً 1 call
jira_create_issue project, type, summary, description, fields? رفع تذكرة جديدة 1 call
jira_transition_issue key, transition, comment? تحريك القضية عبر سير العمل 1 call
jira_add_comment key, body إضافة سياق 1 call
confluence_search cql: str إيجاد الوثائق 1 call
confluence_get_page id: str قراءة محتوى صفحة 1 call
confluence_create_page space, parent_id, title, body وثيقة جديدة 1 call
confluence_update_page id, title, body, version تعديل وثيقة 1 call

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

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

حصة API
Atlassian Cloud: 5000 طلب/ساعة لكل مستخدم/token (يتفاوت بحسب الطبقة)
الرموز لكل استدعاء
300–4000
التكلفة المالية
مجاني مفتوح المصدر؛ خطة Atlassian الخاصة بك تُطبَّق
نصيحة
استخدم fields= لتخفيف payloads؛ افتراضيات jira_get_issue ثقيلة

الأمان

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

الحد الأدنى من الصلاحيات: read:jira-work write:jira-work read:confluence-content.all write:confluence-content
تخزين بيانات الاعتماد: API token في متغير بيئة؛ دوِّر عبر My Account
نقل البيانات الخارجي: مثيل atlassian.net الخاص بك فقط (أو المستضاف ذاتياً)
لا تمنح أبدًا: site-admin

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

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

401 Unauthorized

انتهت صلاحية token أو اسم مستخدم خاطئ (يجب أن يكون بريداً إلكترونياً لـ Cloud)

تحقق: curl -u email:token $URL/rest/api/3/myself
JQL parse error

اقتبس قيم السلاسل، وتهرَّب من الأحرف الخاصة؛ جرِّب أولاً في واجهة Jira

Forbidden when creating in space

مستخدم token يفتقد إذن 'Add page' في تلك المساحة

Rate-limited 429

تراجع؛ قلِّل التوزيع الموازي؛ تحقق من حد معدل Atlassian لكل token

تحقق: X-RateLimit headers

البدائل

MCP Atlassian مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Atlassian official MCP (Cloud)تستخدم Cloud فقط وتريد OAuthأحدث، مجموعة أدوات أضيق؛ لا يغطي Server/DC
Linear MCPأنت على Linear لا Jiraنظام مختلف؛ أسرع/أنظف لكن لا يعادل Confluence

المزيد

الموارد

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

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

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