Atlassian MCPを使ってJiraチケットを分析しConfluenceにページ作成してみた

たかやま

2025.04.23

こんにちは。たかやまです。
非公式ではありますがAtlassianサービスのMCPが公開されていたので、今回はこちらを使ってJiraチケットを分析しConfluenceにページを作成してみたいと思います。
https://github.com/sooperset/mcp-atlassian/tree/main
 さきにまとめAtlassian MCPはJiraやConfluenceを操作できるMCPサーバー
クラウド版、Server/Data Center版の両方に対応
実行環境はDockerが推奨
READ_ONLY_MODEを設定することで書き込みオペレーションを防ぎ安全に利用可能
 Atlassian MCPとは!Atlassian MCPはコミュニティベースの非公式ツールです。ご利用にあたっては自己責任でお願いいたします。
Atlassian MCPは、Atlassian製品（ConfluenceとJira）向けのModel Context Protocol（MCP）サーバーです。このツールを使うことで、生成AIアシスタントからAtlassian製品を直接操作できるようになります。
クラウド版だけでなく、Server/Data Centerデプロイメントの両方に対応しています。
2025/04時点での対応状況は以下のようになっています。


Product
Deployment Type
Support Status


Confluence
Cloud
✅ Fully supported

Confluence
Server/Data Center
✅ Supported (version 6.0+)

Jira
Cloud
✅ Fully supported

Jira
Server/Data Center
✅ Supported (version 8.14+)

 やってみる Dockerイメージのダウンロード!Atlassian MCPを利用するには、Dockerが動作する環境が必要です。
本記事ではRancher Desktopを使ってDocker環境を構築しています。
以前までuvやpythonもサポートしていましたが、現在はDockerの利用を推奨しています。
https://github.com/sooperset/mcp-atlassian/pull/306
こちらの記事ではDockerを利用して進めて行きます。
以下のコマンドでDockerイメージをダウンロードします。
macOS/Linux
docker pull ghcr.io/sooperset/mcp-atlassian:latest
 MCPサーバーを設定するMCPサーバーに以下内容を設定します。
APIトークンは以下の情報を参考に作成してください。
Jira Service ManagementのREST APIを触ってみた - APIトークンの取得 | DevelopersIO
{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_USERNAME",
        "-e", "CONFLUENCE_API_TOKEN",
        "-e", "JIRA_URL",
        "-e", "JIRA_USERNAME",
        "-e", "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_confluence_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_jira_api_token"
      }
    }
  }
}
私はCursorを利用しているのでCursorのMCPサーバーに登録します。

登録すると以下のようにMCPサーバーが追加されます。
提供されているツールは2025/04時点で以下のようになっています。


Confluence Tools
Jira Tools


confluence_search
jira_get_issue

confluence_get_page
jira_search

confluence_get_page_children
jira_get_project_issues

confluence_get_page_ancestors
jira_get_epic_issues

confluence_get_comments
jira_create_issue

confluence_create_page
jira_batch_create_issues

confluence_update_page
jira_update_issue

confluence_delete_page
jira_delete_issue

-
jira_get_transitions

-
jira_transition_issue

-
jira_add_comment

-
jira_add_worklog

-
jira_get_worklog

-
jira_download_attachments

-
jira_link_to_epic

-
jira_get_agile_boards

-
jira_get_board_issues

-
jira_get_sprints_from_board

-
jira_get_sprint_issues

-
jira_update_sprint

-
jira_create_issue_link

-
jira_remove_issue_link

 Jira Toolsを試してみる実際にJira Toolsを試してみたいと思います。
以下のプロンプトを実行します。
以下のJiraプロジェクトのチケットを10件確認してください。
<JiraのURL>
プロンプトを実行するとツール jira_search が実行されて、Jiraのチケットを検索してくれます。

検索はJQLを利用して実行するようですね。
実行すると以下のようにチケットの結果が返ってきていますね。
チケットの詳細を確認してみたいと思います。

以下のプロンプトを実行します。
チケット <チケットキー> の内容を教えて下さい。
チケット内容の確認もできますね。
以下のようにチケットの情報の統計が取れるので、生成AIを利用してチケット傾向を分析することもできます。
以下のJiraプロジェクトのチケットの傾向について教えて下さい。
<JiraのURL>
いい感じに直近のチケットの傾向がまとめられていますね！
 Confluence Toolsを試してみるこちらのAtlassian MCPはConfluenceのツールも提供しています。
さきほどのJiraのチケット傾向のページをConfluenceに作成してみます。
以下のプロンプトを実行します。
チケットの傾向についてまとめたページを以下のConfluenceスペースに作成してください。
<ConfluenceのURL>
Jiraチケットの傾向情報をベースにConfluenceページを作成してくれていますね。
実際に作成されたConfluenceページは以下のようになります。
実行していたCursorのプロジェクトに影響されたのか普段のブログのような文体になっているのは置いといて...チケット傾向分析がまとめられていますね！
画像についてはうまく添付できていないようなのでこのあたりは差し替えて上げる必要がありますが、レポート生成に活用できそうだなと思いました。
 Environment Fileの活用またこちらのMCPではEnvironment Fileを活用することでより細かくMCPを制御することができます。
サンプルのEnvironment Fileは以下のようになっています。
https://github.com/sooperset/mcp-atlassian/blob/main/.env.example
今回は READ_ONLY_MODE を true にして読み取り専用モードにしてみます。

他の環境変数はご自身の環境に合わせて設定してください。
atlassian.env
# MCP-ATLASSIAN CONFIGURATION
# Note: Do not use double quotes for any values in this file

# =============================================
# GENERAL CONFIGURATION
# =============================================

# Transport Options
# CLI: --transport [stdio|sse], --port PORT
# Default: stdio transport
# Note: PORT is only used when TRANSPORT=sse
# TRANSPORT=stdio        # Options: stdio, sse
# PORT=8000              # Only used when TRANSPORT=sse

# Read-only Mode (disables all write operations)
# CLI: --read-only
- # READ_ONLY_MODE=true
+ READ_ONLY_MODE=true

# Debug Options
# CLI: -v/--verbose (once for INFO, twice for DEBUG)
# Default logging level is WARNING (minimal output)
# MCP_VERBOSE=true           # For INFO level (same as -v)
# MCP_VERY_VERBOSE=true      # For DEBUG level (same as -vv)

# =============================================
# CONFLUENCE CONFIGURATION
# =============================================

## ---- CLOUD DEPLOYMENT ----
# CLI: --confluence-url, --confluence-username, --confluence-token
CONFLUENCE_URL=https://your-domain.atlassian.net/wiki
CONFLUENCE_USERNAME=your.email@domain.com
CONFLUENCE_API_TOKEN=your_api_token

# Optional: Filter spaces
# CLI: --confluence-spaces-filter
# CONFLUENCE_SPACES_FILTER=DEV,TEAM,DOC

## ---- SERVER/DATA CENTER DEPLOYMENT ----
# CLI: --confluence-url, --[no-]confluence-ssl-verify
# CONFLUENCE_URL=https://confluence.your-company.com
# CONFLUENCE_SSL_VERIFY=true           # CLI: --[no-]confluence-ssl-verify

## Authentication options (choose one):

# 1. Using Personal Access Token (recommended):
# CLI: --confluence-personal-token
# CONFLUENCE_PERSONAL_TOKEN=your_personal_access_token

# 2. Using Basic Authentication (username/password):
# CLI: --confluence-username, --confluence-token
# CONFLUENCE_USERNAME=your_username
# CONFLUENCE_API_TOKEN=your_password

# =============================================
# JIRA CONFIGURATION
# =============================================

## ---- CLOUD DEPLOYMENT ----
# CLI: --jira-url, --jira-username, --jira-token
JIRA_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your.email@domain.com
JIRA_API_TOKEN=your_api_token

# Optional: Filter projects
# CLI: --jira-projects-filter
# JIRA_PROJECTS_FILTER=PROJ,DEV,SUPPORT

## ---- SERVER/DATA CENTER DEPLOYMENT ----
# CLI: --jira-url, --jira-personal-token, --[no-]jira-ssl-verify
# JIRA_URL=https://jira.your-company.com
# JIRA_PERSONAL_TOKEN=your_personal_access_token
# JIRA_SSL_VERIFY=true                 # CLI: --[no-]jira-ssl-verify
合わせてMCPサーバーの設定ファイルも以下のように更新します。
{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/path/to/your/mcp-atlassian.env",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ]
    }
  }
}
この設定でさきほどのプロンプトをもう一度実行してみます。
ちゃんと書き込みオペレーションがブロックされていますね。
 デバッグ方法デバッグ方法についても紹介されていたので試してみます。
以下のコマンドを実行することでデバッグツールを起動することもできます。
npx @modelcontextprotocol/inspector uvx mcp-atlassian
実行すると以下のようにローカルサーバーが起動します。
$ npx @modelcontextprotocol/inspector uvx mcp-atlassian
Starting MCP inspector...
⚙️ Proxy server listening on port 6277
🔍 MCP Inspector is up and running at http://127.0.0.1:6274 🚀
上記コマンドで表示されたローカルサーバのURL（http://127.0.0.1:6274）にアクセスすると以下のようなデバッグツールが起動します。
環境変数を設定して、指定のツールを実行することで動作を確認することができます。
AI Agent側でうまく動作しない場合などにトークンを消費させずテストできるので、こちらを活用してみてください。
 最後にAtlassian MCPをご紹介しました。
私自身、Jira Query Language (JQL) や Confluence Query Language (CQL)をあまり詳しくないので、LLMと組み合わせて自然言語で問い合わせできるのはいいですね。
また、READ ONLYモードもあり安全に利用できるので、安心して利用できるのも嬉しいですね。
この記事が誰かのお役に立てれば幸いです。
以上、たかやま(@nyan_kotaroo)でした。

Confluence Tools	Jira Tools
`confluence_search`	`jira_get_issue`
`confluence_get_page`	`jira_search`
`confluence_get_page_children`	`jira_get_project_issues`
`confluence_get_page_ancestors`	`jira_get_epic_issues`
`confluence_get_comments`	`jira_create_issue`
`confluence_create_page`	`jira_batch_create_issues`
`confluence_update_page`	`jira_update_issue`
`confluence_delete_page`	`jira_delete_issue`
-	`jira_get_transitions`
-	`jira_transition_issue`
-	`jira_add_comment`
-	`jira_add_worklog`
-	`jira_get_worklog`
-	`jira_download_attachments`
-	`jira_link_to_epic`
-	`jira_get_agile_boards`
-	`jira_get_board_issues`
-	`jira_get_sprints_from_board`
-	`jira_get_sprint_issues`
-	`jira_update_sprint`
-	`jira_create_issue_link`
-	`jira_remove_issue_link`

Atlassian MCPを使ってJiraチケットを分析しConfluenceにページ作成してみた

さきにまとめ

Atlassian MCPとは

やってみる

Dockerイメージのダウンロード

MCPサーバーを設定する

Jira Toolsを試してみる

Confluence Toolsを試してみる

Environment Fileの活用

デバッグ方法

最後に

関連記事

主なカテゴリ

AWS

おすすめ

プロダクト

コンテンツ

お問い合わせ

運営会社

Product	Deployment Type	Support Status
Confluence	Cloud	✅ Fully supported
Confluence	Server/Data Center	✅ Supported (version 6.0+)
Jira	Cloud	✅ Fully supported
Jira	Server/Data Center	✅ Supported (version 8.14+)