Jira MCP 完整教學 — 讓 Claude Code 直接操作你的 Jira

Jira 每天都要登，改個狀態還要點半天，看著任務卡卡的動不了。但如果能讓 Claude Code 直接操作 Jira，「改狀態」「建 Subtask」「查進度」全部自動跑，是不是爽多了？

這不是在做夢。現在的 MCP（Model Context Protocol）讓 Claude Code 能跟 Jira 溝通，整個工作流程可以變得超流暢。今天我就來分享怎麼設定，以及實際能幹什麼。

先理解 MCP 是什麼

MCP 簡單來說，就是讓 Claude Code 這樣的 AI 工具能夠跟外部系統（像 Jira、Confluence）對話的協議。你不用寫複雜的 API 呼叫，Claude 自己就能透過 MCP 去讀寫 Jira 的資料。

想像 MCP 像是翻譯官，你跟 Claude 說「幫我查最近的 Bug」，Claude 透過 MCP 自動翻譯成 Jira 能聽懂的語言，然後把結果再講給你聽。

三個 Jira MCP 選項，怎麼選？

市面上有三個主要選項：

選項	開發者	工具數量	推薦度	備註
Atlassian Rovo MCP	Atlassian 官方	25 個工具	★★★	官方背書但功能少
sooperset/mcp-atlassian	社群開發	72 個工具	★★★★★	強烈推薦功能最完整
cosmix/jira-mcp	社群開發	7 個工具	★★	已停止維護

直接結論：用 sooperset/mcp-atlassian，49 個 Jira 工具 + 23 個 Confluence 工具，真的有夠方便。

安裝步驟（5 分鐘快速版）

1. 取得 Jira API Token

首先，登入你的 Jira Cloud：

去 https://id.atlassian.com/manage-profile/security/api-tokens
點 Create API token
給個名字，像「Claude Code」
複製 token（別貼出去啦）

Server 或 Data Center 用戶？ 改用 Personal Access Token (PAT)，步驟類似。

2. 設定 .env 檔案

在你的 Claude Code 工作目錄裡，建立 .env 檔案：

1
2
3

JIRA_HOST=https://你的公司.atlassian.net
JIRA_EMAIL=你的email@company.com
JIRA_API_TOKEN=剛剛複製的那個token

安全提醒： 別把 .env 上傳到 Git。加進 .gitignore：

1 2	.env .env.local

3. 安裝 MCP

用 Claude Code 的 MCP 管理工具安裝：

1	claude mcp add sooperset/mcp-atlassian

或者，手動編輯 Claude 的 config（位置：~/.config/claude-code/mcp.json 或 ~/.claude/claude.json，取決於你的系統）：

{
  "mcps": {
    "atlassian": {
      "type": "npm",
      "package": "sooperset/mcp-atlassian"
    }
  }
}

4. 驗證安裝

開 Claude Code，試試看：

1	@claude 列出我最近的 Jira 任務

如果跑出任務清單，恭喜，成功了。

還能加 Confluence？

當然行。同個 API Token 可以用，Confluence 自動就能連。72 個工具中，23 個是 Confluence 的。

實用場景，讓你真的省時間

場景 1: 早上 Standup

1	@claude 幫我列出本週的 Jira 任務，狀態是「In Progress」的，然後給我一個簡短的進度總結

Claude 會幫你自動拉出相關任務，不用開 Jira 網頁版。

場景 2: 寫完 Code，自動更新 Jira

1	@claude 我剛完成 PROJ-123 的功能，幫我把狀態改成「Ready for Review」，然後加個 Comment：「已實作完成，等待 Code Review」

直接改狀態、留言，一行指令搞定。

場景 3: Sprint Planning 時批量建立 Subtask

假設你有一大堆任務要拆分：

@claude 幫我把 PROJ-456（實作使用者登入功能）拆成以下 Subtask：
1. 後端 API 實作
2. 前端表單介面
3. 單元測試
4. 整合測試

一次建好，手不用酸。

場景 4: 自動生成週報

@claude 抓出我這週完成的所有 Jira 任務，整理成週報格式，包括：
- 完成的任務列表
- 目前進行中的任務
- 下週的計畫

直接貼給 PM，省掉手動統計的麻煩。

場景 5: 快速回報 Bug

1	@claude 幫我在 PROJ 專案建立一個 Bug，標題「登入頁面在 Safari 上破版」，優先級「High」，指派給 @frontend-team，並加上以下描述：[描述內容]

不用手動填一堆欄位。

場景 6: 時間追蹤

1	@claude 幫我在 PROJ-789 上記錄 4 小時的工時，分類「Development」

對常常忘記打卡的人真的有救。

JQL 快速參考（查詢語言）

Claude 會幫你組 JQL（Jira Query Language），但知道一些常用的會很有幫助：

# 我指派的任務
assignee = currentUser()

# 我建立的 Issue
creator = currentUser()

# 本週完成的任務
resolved >= -7d AND status = Done

# 高優先級、進行中的 Bug
priority = High AND type = Bug AND status = "In Progress"

# 特定專案的所有任務
project = PROJ

# 搜尋特定文字
text ~ "登入功能"