MCP Atlassian — インストール & ライブデモ

Name: MCP Atlassian MCP Server
Author: sooperset

なぜ使うのか

主な機能

Jira：JQL検索、Issue取得／作成／更新、トランジション、コメント追加、ワークフロー一覧
Confluence：ページ検索、コンテンツ取得、ページ作成／更新、コメント、添付ファイル
Cloud＋Server/Data Centerサポート
最小権限デプロイ向けの読み取り専用モード
サイトフィルター — 多数のプロジェクト／スペースがある場合に単一のものに制限可能
Stdio＋HTTP/SSEトランスポート

ライブデモ

実際の動作

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

本番エラーをRunbookリンク付きのJiraチケットにトリアージする

👤 オンコールエンジニア ⏱ ~10 min intermediate

使うタイミング： Sentryアラートが発火した — トリアージ済みのJiraチケットとRunbookリンクを素早く作りたい場合。

前提条件

APIトークン — Atlassian → マイアカウント → セキュリティ → APIトークン

フロー

関連情報を検索

Atlassian: search Jira for issues containing 'NullPointerException OrderService' in the last 30 days. Also search Confluence for runbook pages mentioning OrderService.✓ コピーしました

→ 両方の結果セットが返される
重複か新規かを判断

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が1回呼び出される
引き継ぎ

Tell me the ticket key and short summary so I can post it in Slack.✓ コピーしました

→ ABC-1234 + 1行の概要

結果： 2分以内にRunbookリンク付きのトリアージ済みチケット完成；重複ファイルなし。

注意点

スタックトレースをJiraにプレーンテキストで貼り付けると書式が失われる — {code}マーカーで囲む；MCPはそのまま転送する
ユーザー入力によるJQLインジェクション — 文字列パラメータは常にクォートする；ツールがエスケープするが明示的に行う

組み合わせ： sentry · github

Jiraから週次ステータスレポートを生成する

👤 テックリード／EM ⏱ ~10 min beginner

使うタイミング： 月曜朝：先週リリースされたものとブロックされているものを要約したい場合。

フロー

先週完了したものを取得

Atlassian: JQL project = PLAT AND status changed to Done during (-7d, now()) ORDER BY updated DESC✓ コピーしました

→ 担当者・キー・概要付きのIssueリスト
ブロックされているものを取得

Now JQL project = PLAT AND status = Blocked — for each, summarize the latest comment.✓ コピーしました

→ Issueごとの最新コメント概要付きのブロックリスト
構成

Format as a 200-word weekly report grouped by Shipped / Blocked / At Risk.✓ コピーしました

→ そのままペースト可能な簡潔なレポート

結果： Issueキーを引用した週次レポートが90秒で完成。

注意点

長いコメントスレッドがコンテキストを膨らませる — jira_get_issueで fields=summary,status,assignee のみ指定する

議論からConfluenceのRFCを下書きする

👤 設計文書を書くエンジニア ⏱ ~20 min intermediate

使うタイミング： チャットでアプローチを議論した；そこからConfluenceページを作りたい場合。

フロー

親スペースを探す

Atlassian: find the 'Engineering RFC' space. List its top-level pages.✓ コピーしました

→ スペース＋親ページが特定される
構成

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が完成。

注意点

親ページIDが間違っている — 最初にconfluence_searchでスペースを検索する

古いチケットを一括クリーンアップする

👤 エンジニアリングマネージャー ⏱ ~30 min intermediate

使うタイミング： バックログに200件のゾンビチケットがある；整理したい場合。

フロー

古くなったものを特定

JQL: project = PLAT AND status = Open AND updated < -90d. Limit 50.✓ コピーしました

→ 古いIssueの一覧
対応を提案

For each, propose: close-stale, reassign-to-triage, or keep. Show me 10 at a time before transitioning.✓ コピーしました

→ Issueごとの推奨対応；バッチで承認
適用

Close the ones I approved with a 'closing as stale' comment.✓ コピーしました

→ jira_transition_issue + jira_add_commentが各Issueに呼び出される

結果： Issueごとの監査証跡付きでバックログがクリーンアップされる。

注意点

静かにしているだけの有効なチケットを自動クローズしてしまう — トランジション前に必ずバッチで確認する

組み合わせ

他のMCPと組み合わせて10倍の力を

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

PRと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件の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リクエスト/時（プランにより異なる）
呼び出しあたりのトークン: 300〜4000
金額: OSS無料；Atlassianプランの料金が適用される
ヒント: fields= を使ってペイロードを削減する；jira_get_issueのデフォルトは重い

セキュリティ

権限、シークレット、影響範囲

最小スコープ： read:jira-work write:jira-work read:confluence-content.all write:confluence-content

認証情報の保管： APIトークンは環境変数に保存；マイアカウントからローテーション

データ送信先： 自分のatlassian.net（または自己ホスト）インスタンスのみ

絶対に付与しない： site-admin

Claudeに更新操作をさせたくない場合はREAD_ONLY_MODE=trueを設定；すべての書き込みツールをカバー

トラブルシューティング

よくあるエラーと対処法

401 Unauthorized

tokenの期限切れまたはユーザー名が間違っている（Cloudではメールアドレスが必須）

確認： curl -u email:token $URL/rest/api/3/myself

JQL parse error

文字列値をクォートし、特殊文字をエスケープする；先にJira UIでプレビューする

Forbidden when creating in space

tokenユーザーにそのスペースの「ページ追加」権限がない

Rate-limited 429

バックオフする；並列ファンアウトを減らす；tokenごとのAtlassianレート制限を確認

確認： X-RateLimit headers

代替案

MCP Atlassian 他との比較

代替案	代わりに使う場面	トレードオフ
Atlassian official MCP (Cloud)	Cloudのみを使用してOAuthが欲しい場合	新しい分だけツールセットが狭い；Server/DCは対象外
Linear MCP	JiraではなくLinearを使用している場合	異なるシステム；より高速でクリーンだがConfluence相当のものはない

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る