/ 目錄 / 演練場 / MCP Atlassian
● 社群 sooperset 🔑 需要你的金鑰

MCP Atlassian

作者 sooperset · sooperset/mcp-atlassian

Claude 中 Jira + Confluence 的社群金標準 — 透過 JQL 搜尋、建立/轉移工單、讀寫 Confluence 頁面,全部在單一 stdio 伺服器後方。

MCP Atlassian 是星數最多的第三方 Atlassian 連接器,同時支援 Cloud 與 Server/Data Center。它暴露 JQL 搜尋、issue 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 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

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}"
      }
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "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

👤 On-call 工程師 ⏱ ~10 min intermediate

何時使用: Sentry 警報觸發 — 你想快速建立分流完成的 Jira 工單和 runbook 連結。

前置條件
  • API tokens — Atlassian → My Account → Security → API tokens
步驟
  1. 搜尋相關內容
    Atlassian:在過去 30 天內搜尋 Jira 中包含「NullPointerException OrderService」的 issue。同時搜尋 Confluence 中提及 OrderService 的 runbook 頁面。✓ 已複製
    → 兩組結果均已回傳
  2. 決策:重複或新建
    若過去 14 天內有未關閉的 BUG issue,在其上留言附上新的堆疊追蹤。否則建立新的 BUG,連結 runbook 頁面,設定優先級為 High。✓ 已複製
    → 呼叫 jira_add_comment 或 jira_create_issue 一次
  3. 交接
    告訴我工單編號和簡短摘要,讓我可以貼到 Slack。✓ 已複製
    → ABC-1234 + 一行摘要

結果: 在 2 分鐘內建立附有 runbook 連結的分流工單;不重複提交。

注意事項
  • 將堆疊追蹤貼入 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✓ 已複製
    → 包含負責人、工單編號、摘要的 issue 清單
  2. 取得卡關項目
    現在 JQL project = PLAT AND status = Blocked — 針對每個,摘要最新的留言。✓ 已複製
    → 卡關清單,每個 issue 附有最後留言摘要
  3. 撰寫報告
    格式化為 200 字的週報,依已交付/卡關/有風險分組。✓ 已複製
    → 簡潔的報告,可直接貼上

結果: 在 90 秒內組裝完成附有引用工單編號的狀態報告。

注意事項
  • 冗長的留言串讓 context 膨脹 — 使用 jira_get_issue 並只指定 fields=summary,status,assignee

從討論內容草擬 Confluence RFC

👤 撰寫設計文件的工程師 ⏱ ~20 min intermediate

何時使用: 你在聊天中討論了某種方案;想從中產出一個 Confluence 頁面。

步驟
  1. 尋找父空間
    Atlassian:尋找「Engineering RFC」空間。列出其頂層頁面。✓ 已複製
    → 已確認空間 + 父頁面
  2. 撰寫
    在其下建立標題為「RFC:從 Redis 換成 Valkey」的新頁面。章節:背景、目標/非目標、考量的選項、決策、計劃。使用上方討論作為原始素材。✓ 已複製
    → confluence_create_page 回傳 URL

結果: 草稿 RFC 已準備好供審閱。

注意事項
  • 父頁面 ID 錯誤 — 務必先用 confluence_search 按空間搜尋

批次清理過時工單

👤 工程管理 ⏱ ~30 min intermediate

何時使用: 積壓清單有 200 個殭屍工單;你想整理它們。

步驟
  1. 找出過時工單
    JQL:project = PLAT AND status = Open AND updated < -90d。限制 50 筆。✓ 已複製
    → 過時 issue 清單
  2. 提議行動
    針對每個,提議:close-stale、reassign-to-triage 或 keep。每次轉移前先給我看 10 個。✓ 已複製
    → 每個 issue 的建議;你批次核准
  3. 套用
    對我核准的那些,加上「closing as stale」留言後關閉。✓ 已複製
    → 對每個 issue 呼叫 jira_transition_issue + jira_add_comment

結果: 積壓清單清理完畢,每個 issue 均有稽核記錄。

注意事項
  • 自動關閉了仍然有效但安靜的工單 — 永遠批次確認後再轉移

組合

與其他 MCP 搭配,撬動十倍槓桿

mcp-atlassian-sooperset + sentry

將 Sentry 錯誤轉換為格式完整的 Jira 工單

Sentry:取得最新嚴重 issue。Atlassian:建立附有堆疊追蹤和 Sentry URL 連結的 Jira BUG。✓ 已複製
mcp-atlassian-sooperset + github

自動將 PR 連結到 Jira 工單

GitHub:尋找今天合入的 PR。Atlassian:對每個,在連結的 Jira issue 上留言附上 PR URL。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
jira_search jql: str, limit? 任何 Jira 查詢 1 API call
jira_get_issue key: str, fields? 需要單個 issue 的完整內容 1 call
jira_create_issue project, type, summary, description, fields? 建立新工單 1 call
jira_transition_issue key, transition, comment? 在工作流程中移動 issue 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:每位使用者/token 每小時 5000 次請求(依方案而異)
每次呼叫 Token 數
300–4000
費用
免費開源;你的 Atlassian 方案費用照常
提示
使用 fields= 精簡酬載;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 解析錯誤

引用字串值,跳脫特殊字元;先在 Jira 介面預覽

在空間中建立頁面被拒絕

Token 使用者在該空間缺少「新增頁面」權限

遭限流 429

退避重試;減少並行扇出;檢查每個 token 的 Atlassian 限流

驗證: X-RateLimit 標頭

替代方案

MCP Atlassian 對比其他方案

替代方案何時用它替代權衡
Atlassian 官方 MCP(Cloud)你只使用 Cloud 且想要 OAuth較新,工具集較窄;不支援 Server/DC
Linear MCP你使用的是 Linear,不是 Jira不同系統;更快更簡潔,但沒有 Confluence 等效品

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills