Jira MCP Server logo

Jira MCP Server

プロジェクト管理#Jira#Atlassian#プロジェクト管理#チケット管理#アジャイル
シェア
最終確認:2026-05-25ライセンス:MIT無料で使えるオープンソースです(商用利用も可)リポジトリ

設定方法

MCP は、お使いの対応アプリ(クライアント)に下記の設定を貼り付けて使います。 タブからアプリを選び、表示された設定をコピーしてください。

Claude Desktop / Claude Code: Claude Desktop(公式デスクトップアプリ)と Claude Code(公式CLI)は同じ JSON を使います。Desktop は設定ファイルに貼り付け、Claude Code は `.mcp.json` に記述するか `claude mcp add` で追加します。

{
  "mcpServers": {
    "jira": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "<YOUR_EMAIL>",
        "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
      }
    }
  }
}

※ Gemini CLI は Claude Desktop と同じ mcpServers 形式のため同一の JSON を表示しています。Codex / VS Code タブの設定は、上記 JSON を各公式スキーマ(Codex=~/.codex/config.toml の TOML 形式 / VS Code=mcp.jsonservers キー)へ 自動変換した参考値です。貼り付け前にお使いのバージョンの公式ドキュメントもご確認ください。

Jira とは

Jira は、Atlassian が提供するエンタープライズ向けの Issue 管理ツールです。チケット・プロジェクト・スプリント・カスタムワークフローなど、大規模開発組織の業務を細かく構造化して管理できるのが特徴です。

同社の Confluence(ドキュメント管理)と連動して、要件→チケット→実装→ドキュメントを一貫して扱える設計。世界中の大規模開発組織・エンタープライズで広く採用されています。

これは公式提供ではなく、有志が作った非公式ツールです。

Jira × AI でできること

このMCPサーバーを導入すると、Jira のチケット管理と Confluence のドキュメント管理をAIへの一言で操作できます。

🎫 チケットを探す

「プロジェクト MYAPP の今スプリント・ステータス In Progress のチケットを担当者別で見せて」
→ JQL ベースの検索でチケット一覧を取得

📝 チケットを作成する

「『ログイン画面でパスワードリセットが失敗する』を Bug・優先度 High で起票」
→ タイトル・優先度・コンポーネント付きで新規チケットを作成

🔁 ステータスを遷移する

「BUG-123 のステータスを『Code Review』に移して、担当者を田中さんに変更」
→ ワークフロー遷移・担当者・属性の更新

📚 Confluence と連動する

「このチケットの仕様確認用 Confluence ページを作って、リンクを Issue に貼って」
→ Confluence ページの新規作成・Issue へのリンク追加

提供される主なツール

mcp-atlassian がカバーする主要操作(全 98 ツールから抜粋):

ツール役割
jira_searchJQL でチケットを検索
jira_get_issueチケットの詳細を取得
jira_create_issueタイトル・優先度・担当者などを指定してチケットを作成
jira_update_issueチケット属性の更新
jira_transition_issueチケットのステータス遷移(ワークフロー)
Confluence ページの検索・取得Confluence の各ページを参照
Confluence ページの作成・更新Confluence のドキュメントを編集
Confluence へのコメント追加ページにコメントを投稿

README 上は 98 tools total と総数表記。Jira 側はチケット操作中心、Confluence 側はページ・コメント操作中心の構成です。編集部が Jira の接続情報のみを与えて起動したところ jira_ で始まる 63 ツールが読み込まれ、Confluence の接続情報のみを与えた場合は 35 ツールでした(合計 98 と一致)。設定した側のツールだけが読み込まれるため、Jira だけ使う場合に Confluence の設定は不要です。

Jira MCP Server について

Jira MCP Server(mcp-atlassian)は、sooperset 氏がコミュニティで開発・公開している MCP サーバーです。Jira API + Confluence API を経由してチケット・プロジェクト・ワークフロー・ドキュメントの操作を AI エージェントから実行できます。

特徴は「Jira と Confluence の同一サーバー実装」。要件→チケット→実装→ドキュメントを一連の流れで AI に扱わせる用途に向きます。Atlassian 社公式の MCP も別途存在しますが、本サーバーは Jira + Confluence 一体型のコミュニティ実装です。

スペック

  • 配布形態: PyPI パッケージ mcp-atlassian(Python 3.10+・uvx または pip で実行)/Docker イメージghcr.io/sooperset/mcp-atlassian:latest
  • 認証:
    • Cloud: API Token(JIRA_USERNAME + JIRA_API_TOKEN
    • Server / Data Center: Personal Access Token(JIRA_PERSONAL_TOKEN
    • OAuth 2.0 にも対応
  • 提供元: コミュニティ製(sooperset / MIT ライセンス)
  • 対応範囲: Jira + Confluence の 98 ツール(同一サーバー・Jira 側 63 / Confluence 側 35)

導入手順

前提条件

  • Jira アカウント(Cloud / Server / Data Center)
  • Atlassian API トークン(Atlassian Cloud 利用の場合)
  • 動かすための土台として、次のどちらか一方
    • uv(Python パッケージマネージャー・Python 3.10 以上が必要)
    • Docker Desktop(ターミナルでのコマンド入力を避けたい場合はこちら)

Docker で入れる場合(コマンド操作を避けたいとき)

このサーバーは PyPI 版(uvx で起動)のほかに、Docker イメージでも配布されています。uv を入れるにはターミナルでコマンドを打つ必要がありますが、Docker Desktop は公式サイトからインストーラーをダウンロードして実行するだけで入ります。すでに Docker Desktop を使っている方や、コマンド操作に不慣れな方はこちらが簡単です。

設定ファイルには次のように書きます(イメージはクライアントの初回起動時に自動で取得されます)。

{
  "mcpServers": {
    "jira": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "JIRA_URL",
        "-e", "JIRA_USERNAME",
        "-e", "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "<YOUR_EMAIL>",
        "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
      }
    }
  }
}

編集部が実際に動かして確認しました(2026 年 8 月 13 日にイメージ ghcr.io/sooperset/mcp-atlassian:latest(サーバー表記 3.4.4)を起動し、Jira 用の 63 ツールが読み込まれることを確認)。Confluence も併用する場合は、args-e の並びと env に Confluence 用の変数(CONFLUENCE_URLCONFLUENCE_USERNAMECONFLUENCE_API_TOKEN)を同じ形で追加してください。

uv のインストール(Docker 版を使う場合は不要)

設定例の uvx は uv に含まれるコマンドのため、先に uv を入れておく必要があります。ターミナル(Windows は PowerShell)で次の 1 行を実行してください。

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows(PowerShell)
irm https://astral.sh/uv/install.ps1 | iex

ステップ

  1. Atlassian APIトークンページ でAPIトークンを発行
  2. 自社のJira URL(https://your-domain.atlassian.net)を確認
  3. ページ上部のタブから使用環境を選択し、JSON設定をコピー
  4. your-domain<YOUR_EMAIL><YOUR_API_TOKEN> をそれぞれ置き換え
  5. コピーしたJSONを設定ファイル(claude_desktop_config.json など)に追記して保存
  6. クライアントを再起動

注意事項

  • APIトークンはソースコードやチャット履歴に含めないよう注意してください。環境変数または .env ファイルで管理し、.gitignore に追加してください。
  • Jira Server(オンプレミス)の場合は JIRA_URL にサーバーのURLを指定し、認証方式が異なる場合があります。詳細はリポジトリのREADMEを確認してください。
  • チケットの更新・削除は元に戻しにくい操作です。AIに実行させる前に対象チケットのIDを必ず確認してください。
  • 同じ mcp-atlassian で Confluence も扱えるため、Plugy 内の Confluence エントリと配布パッケージが共通です。

主なユースケース

  • 今スプリントの未完了タスクや遅延チケットをAIが集計し、進捗サマリを即座に作成する
  • 会議のメモや要件定義書からJiraチケットをAIが自動生成し、手入力作業をなくす
  • 特定の担当者やラベルでフィルタしたチケット一覧をAIが整形して報告書に変換する
  • バグ報告やユーザーフィードバックをAIがJiraチケットに起票し、優先度も判断する

プラットフォーム別の注意事項

  • Windows`uvx` の代わりに、`pip install mcp-atlassian` 後はコンソールスクリプト `mcp-atlassian` でも起動できます。Python のパスが通っていることを確認してください。
  • プロキシ環境Atlassian Cloud接続時は `HTTPS_PROXY` 環境変数を設定してください。