MCPアトラシアン

Atlassian製品（ConfluenceおよびJira）用のモデルコンテキストプロトコル（MCP）サーバー。この統合は、ConfluenceとJira Cloud、およびServer/Data Centerの両方のデプロイメントをサポートします。

使用例

AI アシスタントに次のことを依頼します。

📝 Jira の自動更新- 「会議メモから Jira を更新」
🔍 AI を活用した Confluence 検索- 「Confluence で OKR ガイドを見つけて要約する」
🐛 スマートな Jira 課題フィルタリング- 「先週の PROJ プロジェクトの緊急のバグを表示」
📄 コンテンツ作成と管理- 「XYZ 機能の技術設計ドキュメントを作成する」

機能デモ

https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

互換性

製品	展開タイプ	サポートステータス
合流	雲	✅ 完全にサポートされています
合流	サーバー/データセンター	✅ サポートされています（バージョン 6.0 以降）
ジラ	雲	✅ 完全にサポートされています
ジラ	サーバー/データセンター	✅ サポートされています（バージョン 8.14 以降）

クイックスタートガイド

1. 認証の設定

まず、Confluence と Jira に必要な認証トークンを生成します。

クラウド向け

https://id.atlassian.com/manage-profile/security/api-tokensにアクセスしてください。
「APIトークンの作成」をクリックし、名前を付けます
トークンをすぐにコピーする

サーバー/データセンター向け

プロフィール（アバター）→プロフィール→個人アクセストークンに移動します
**「トークンの作成」**をクリックし、名前を付けて有効期限を設定します
トークンをすぐにコピーする

2. インストール

MCP Atlassian を使用する主な方法は、IDE 統合を使用することです。

オプション1: uvxの使用（推奨）

まず uv をインストールします:

macOS/Linux:

# Using the official installer
curl -LsSf https://astral.sh/uv/install.sh | sh

# Alternatively, on macOS you can use Homebrew
brew install uv

ウィンドウズ:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

uvがインストールされると、パッケージを個別にインストールしなくても、IDE 構成でuvx mcp-atlassian直接使用できます。

オプション2: pipを使用する

pip install mcp-atlassian

オプション3: Smitheryを使用する

npx -y @smithery/cli install mcp-atlassian --client claude

オプション4: Dockerを使用する

リポジトリをクローンします。
git clone https://github.com/sooperset/mcp-atlassian.git cd mcp-atlassian
Docker イメージをビルドします。
docker build -t mcp/atlassian .

3. 主要な設定オプション

IDE で設定する場合、次のオプションの環境変数を使用できます。

CONFLUENCE_SPACES_FILTER : スペースキーでフィルタリングします (例: "DEV、TEAM、DOC")
JIRA_PROJECTS_FILTER : プロジェクトキーでフィルタリングします（例: "PROJ、DEV、SUPPORT"）
READ_ONLY_MODE : 書き込み操作を無効にするには「true」に設定します
MCP_VERBOSE : より詳細なログを記録するには「true」に設定します

**注:**必要なサービスの変数のみを含めることで、Confluence のみ、Jira のみ、または両方のサービスを設定できます。

利用可能なすべてのオプションについては、 .env.exampleファイルを参照してください。

IDE統合

MCP Atlassian は、IDE 統合を通じて AI アシスタントと併用できるように設計されています。

注: Claude Desktop で構成を適用するには:
方法 1 (推奨) : ハンバーガーメニュー (☰) > 設定 > 開発者 > 「設定の編集」ボタンをクリック
方法 2 : 構成ファイルを直接探して編集する:
Windows : %APPDATA%\Claude\claude_desktop_config.json
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Linux : ~/.config/Claude/claude_desktop_config.json
カーソルの場合：設定→機能→MCPサーバー→+新しいグローバルMCPサーバーを追加を開きます

インストール方法に応じて設定する方法は次のとおりです。

uvxの使用（推奨）

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

サーバー/データセンターの展開の場合は、代わりに次の環境変数を使用します。

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://confluence.your-company.com",
        "CONFLUENCE_PERSONAL_TOKEN": "your_token",
        "JIRA_URL": "https://jira.your-company.com",
        "JIRA_PERSONAL_TOKEN": "your_token"
      }
    }
  }
}

Confluence のみ:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Jira のみ:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

環境変数の代わりにコマンドライン引数を使用することもできます。

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

pip を使用して mcp-atlassian をインストールした場合は、代わりに次の構成を使用します。

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "mcp-atlassian",
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

Docker イメージをビルドした場合は、次の構成を使用します。

方法1: 環境変数を使用する

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

方法2: 環境ファイルを使用する

リポジトリ内の.env.exampleテンプレートに基づいて.envファイルを作成し、変数を入力して、次を使用します。

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--env-file", "/path/to/your/.env", "mcp/atlassian"]
    }
  }
}

SSEトランスポート構成

次のコマンドでサーバーを起動します。

uvx mcp-atlassian --transport sse --port 9000 \
  --confluence-url https://your-company.atlassian.net/wiki \
  --confluence-username your.email@company.com \
  --confluence-token your_api_token \
  --jira-url https://your-company.atlassian.net \
  --jira-username your.email@company.com \
  --jira-token your_api_token

IDE で設定します:

{
  "mcpServers": {
    "mcp-atlassian-sse": {
      "url": "http://localhost:9000/sse"
    }
  }
}

リソースとツール

リソース

confluence://{space_key} : Confluence スペースにアクセスする
jira://{project_key} : Jira プロジェクトにアクセスする

注: MCP サーバーは、ユーザーの貢献と割り当てに基づいて、ユーザーがアクティブにやり取りしている Confluence スペースと Jira プロジェクトのみを表示するようにリソースをフィルタリングします。

主要ツール

Confluenceツール

confluence_search : CQL を使用して Confluence コンテンツを検索する
confluence_get_page : 特定のページの内容を取得する
confluence_create_page : 新しいページを作成する
confluence_update_page : 既存のページを更新する

Jiraツール

jira_get_issue : 特定の問題の詳細を取得する
jira_search : JQL を使用して課題を検索する
jira_create_issue : 新しい課題を作成する
jira_update_issue : 既存の課題を更新する
jira_transition_issue : 課題を新しいステータスに移行する
jira_add_comment : 課題にコメントを追加する

Confluenceツール	Jiraツール
`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_create_issue_link`
	`jira_remove_issue_link`

トラブルシューティングとデバッグ

よくある問題

認証失敗:
- クラウドの場合: APIトークンを確認してください（アカウントのパスワードではありません）
- サーバー/データセンターの場合: 個人アクセストークンが有効であり、期限切れでないことを確認してください
- 古い Confluence サーバーの場合: 一部の古いバージョンでは、 CONFLUENCE_USERNAMEとCONFLUENCE_API_TOKEN (token はパスワード) を使用した基本認証が必要です。
SSL 証明書の問題: Server/Data Center を使用していて SSL エラーが発生した場合は、 CONFLUENCE_SSL_VERIFY=falseまたはJIRA_SSL_VERIFY=falseを設定してください。
権限エラー: Atlassian アカウントにスペース/プロジェクトにアクセスするための十分な権限があることを確認してください

デバッグツール

# Using MCP Inspector for testing
npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

# For local development version
npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...

# View logs
# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
# Windows
type %APPDATA%\Claude\logs\mcp*.log | more

安全

APIトークンを共有しないでください
.env ファイルを安全かつプライベートに保つ
ベストプラクティスについてはSECURITY.mdをご覧ください

貢献

MCP Atlassianへの貢献を歓迎します！貢献をご希望の場合は、以下をご記入ください。

CONTRIBUTING.mdガイドをご覧ください
開発環境をセットアップします。
uv sync --frozen --all-extras --dev pre-commit install
変更を加えてプルリクエストを送信する

コードの品質を保つために事前コミットフックを使用し、リリースにはセマンティックバージョニングに従います。

ライセンス

MITライセンス（ LICENSEファイル参照）です。これはAtlassianの公式製品ではありません。

MCP Atlassian

Integrations