Elevance MCP Atlassian - スタンドアロンパッケージ

JiraおよびConfluence統合のためのModel Context Protocolサーバー（AIアシスタント向け）。

提供内容

合計72ツール:

• Jiraツール48個（検索、作成、更新、トランジション、コメントなど）

• Confluenceツール24個（検索、ページ、コメント、添付ファイルなど）

Related MCP server: Jira Cloud MCP Server

クイックセットアップ（5分）

1. 個人アクセストークン（PAT）を取得する

JiraおよびConfluence:

1. https://jira.elevancehealth.com にログインします

2. プロフィールアイコン → プロフィール をクリックします

3. 「個人アクセストークン」に移動します

4. 「トークンを作成」をクリックします

   • 名前: MCP Atlassian Integration

   • 有効期限: 1年

5. トークンをコピーします（一度しか表示されません！）

2. 環境を設定する

# Copy template
copy .env.template .env

# Edit .env and paste your PAT tokens
notepad .env

YOUR_JIRA_PAT_TOKEN_HERE と YOUR_CONFLUENCE_PAT_TOKEN_HERE を実際のトークンに置き換えます。

3. 依存関係をインストールする

# Option A: Using pip
pip install -r requirements.txt

# Option B: Install as package
pip install -e .

4. IDEを設定する

Claude Desktopの場合:

%APPDATA%\Claude\claude_desktop_config.json を編集します:

{
  "mcpServers": {
    "elevance-atlassian": {
      "command": "python",
      "args": ["-m", "mcp_atlassian"],
      "cwd": "C:\\path\\to\\elevance-mcp-atlassian-standalone",
      "env": {
        "JIRA_URL": "https://jira.elevancehealth.com",
        "JIRA_PERSONAL_TOKEN": "YOUR_PAT_HERE",
        "CONFLUENCE_URL": "https://confluence.elevancehealth.com/",
        "CONFLUENCE_PERSONAL_TOKEN": "YOUR_PAT_HERE"
      }
    }
  }
}

Windsurfの場合:

MCP設定に追加するか、.env ファイル方式を使用します（推奨）。

Cursorの場合:

設定のMCP設定に追加します。形式はClaude Desktopと同様です。

5. 接続をテストする

python validate_setup.py

すべてのチェックが✅記号付きで合格するはずです。

6. 使用を開始する！

IDEを再起動して、AIアシスタントに次のように依頼します:

• 「自分に割り当てられたJira課題を探して」

• 「Confluenceでオンボーディング資料を検索して」

• 「プロジェクトXYZにバグを作成して」

• 「PROJ-123のステータスをIn Progressに更新して」

• 「現在のスプリントの課題を表示して」

• 「ConfluenceスペースDEVからページコンテンツを取得して」

利用可能なツール

Jiraツール（48個）

検索と発見:

• jira_search - JQLで課題を検索

• jira_search_fields - カスタムフィールド定義を検索

• jira_get_all_projects - アクセス可能なプロジェクトを一覧表示

• jira_get_project_issues - プロジェクト内の全課題を取得

課題管理:

• jira_get_issue - 課題の詳細を取得

• jira_create_issue - 新しい課題を作成

• jira_update_issue - 既存の課題を更新

• jira_delete_issue - 課題を削除

• jira_batch_create_issues - 複数の課題を作成

ステータスとワークフロー:

• jira_transition_issue - 課題のステータスを変更

• jira_get_transitions - 利用可能なトランジションを取得

コメント:

• jira_add_comment - 課題にコメントを追加

• jira_edit_comment - 既存のコメントを編集

リンク:

• jira_create_issue_link - 2つの課題をリンク

• jira_remove_issue_link - リンクを削除

• jira_create_remote_issue_link - Webリンクを作成

• jira_link_to_epic - 課題をエピックにリンク

• jira_get_link_types - 利用可能なリンクタイプを取得

添付ファイル:

• jira_download_attachments - 課題の添付ファイルをダウンロード

• jira_get_issue_images - 画像をインラインコンテンツとして取得

ウォッチャー:

• jira_add_watcher - 課題にウォッチャーを追加

• jira_remove_watcher - ウォッチャーを削除

• jira_get_issue_watchers - ウォッチャーを一覧表示

工数管理:

• jira_add_worklog - 課題に作業時間を記録

• jira_get_worklog - 作業ログエントリを取得

アジャイル/スプリント:

• jira_get_agile_boards - ボードを一覧表示

• jira_get_board_issues - ボード上の課題を取得

• jira_get_sprints_from_board - スプリントを一覧表示

• jira_get_sprint_issues - スプリント内の課題を取得

• jira_create_sprint - 新しいスプリントを作成

• jira_update_sprint - スプリントを更新

• jira_add_issues_to_sprint - 課題をスプリントに追加

バージョン:

• jira_get_project_versions - バージョンを一覧表示

• jira_create_version - 新しいバージョンを作成

• jira_batch_create_versions - 複数のバージョンを作成

コンポーネント:

• jira_get_project_components - プロジェクトコンポーネントを一覧表示

分析:

• jira_get_issue_dates - 日付情報を取得

• jira_get_issue_sla - SLAメトリクスを計算

• jira_batch_get_changelogs - 変更履歴を取得

開発情報:

• jira_get_issue_development_info - PR、コミット、ブランチを取得

• jira_get_issues_development_info - バッチ開発情報

高度な機能:

• jira_get_user_profile - ユーザー情報を取得

• jira_get_field_options - カスタムフィールドオプションを取得

• jira_get_issue_proforma_forms - ProFormaフォームを取得

• jira_get_proforma_form_details - フォームの詳細を取得

• jira_update_proforma_form_answers - フォームの回答を更新

サービスデスク（Server/DCのみ）:

• jira_get_service_desk_for_project - サービスデスクを取得

• jira_get_service_desk_queues - キューを一覧表示

• jira_get_queue_issues - キュー内の課題を取得

Confluenceツール（24個）

検索:

• confluence_search - CQLでコンテンツを検索

• confluence_search_user - ユーザーを検索

ページ:

• confluence_get_page - ページコンテンツを取得

• confluence_create_page - 新しいページを作成

• confluence_update_page - ページを更新

• confluence_delete_page - ページを削除

• confluence_move_page - ページを移動

• confluence_get_page_children - 子ページを取得

• confluence_get_page_history - ページバージョンを取得

• confluence_get_page_diff - バージョンを比較

コメント:

• confluence_add_comment - コメントを追加

• confluence_reply_to_comment - コメントに返信

• confluence_get_comments - ページのコメントを取得

添付ファイル:

• confluence_get_attachments - 添付ファイルを一覧表示

• confluence_upload_attachment - ファイルをアップロード

• confluence_upload_attachments - 複数のファイルをアップロード

• confluence_download_attachment - ファイルをダウンロード

• confluence_download_content_attachments - すべての添付ファイルをダウンロード

• confluence_delete_attachment - 添付ファイルを削除

画像:

• confluence_get_page_images - 画像をインラインコンテンツとして取得

ラベル:

• confluence_get_labels - コンテンツラベルを取得

• confluence_add_label - ラベルを追加

分析:

• confluence_get_page_views - 閲覧統計を取得

トラブルシューティング

「Module not found」エラー

pip install -e .

「認証に失敗しました」

• PATトークンが有効で期限切れでないことを確認

• トークンが失効していないことを確認

• 正しいURL（https://jira.elevancehealth.com）を使用していることを確認

• トークンの再生成を試行

SSL証明書エラー

.env ファイルに追加:

JIRA_SSL_VERIFY=false
CONFLUENCE_SSL_VERIFY=false

接続テストが失敗する

# Test if Python can import the module
python -c "import mcp_atlassian; print('OK')"

# Check MCP version
python -m mcp_atlassian --version

検証実行時に「No such file or directory」エラー

正しいディレクトリにいることを確認:

cd C:\path\to\elevance-mcp-atlassian-standalone
python validate_setup.py

IDEにツールが表示されない

1. IDE設定に正しいパスが含まれていることを確認

2. IDEを完全に再起動

3. MCP接続エラーについてIDEログを確認

4. .env またはIDE設定で TOOLSETS=all が設定されていることを確認

セキュリティのベストプラクティス

• ✅ .env ファイルを非公開に保つ

• ✅ PATトークンを共有しない

• ✅ トークンを6〜12か月ごとにローテーションする

• ✅ .env をバージョン管理にコミットしない

• ✅ 追跡用に強力なトークン名を使用する

• ✅ 不要になったらトークンを失効させる

高度な設定

特定のプロジェクトにフィルタリング

.env 内:

JIRA_PROJECTS_FILTER=PROJ1,PROJ2,PROJ3
CONFLUENCE_SPACES_FILTER=SPACE1,SPACE2,SPACE3

詳細ログを有効にする

.env 内:

MCP_VERBOSE=true
MCP_VERY_VERBOSE=true  # Debug level

読み取り専用モード（テスト用）

.env 内:

READ_ONLY_MODE=true

これにより、すべての書き込み操作（作成、更新、削除）が防止されます。

カスタムツールセット

.env 内:

# Only core tools
TOOLSETS=default

# Specific toolsets
TOOLSETS=default,jira_agile,jira_analytics

# Specific tools only
ENABLED_TOOLS=jira_search,jira_get_issue,confluence_search

システム要件

• Python: 3.10以上

• オペレーティングシステム: Windows、macOS、またはLinux

• ネットワーク: jira.elevancehealth.com へのアクセス

• IDE: MCP対応のClaude Desktop、Cursor、またはWindsurf

パッケージ内容

elevance-mcp-atlassian-standalone/
├── src/mcp_atlassian/       # Complete MCP implementation
│   ├── jira/                # 48 Jira tools
│   ├── confluence/          # 24 Confluence tools
│   ├── models/              # Data models
│   ├── servers/             # MCP server logic
│   └── utils/               # Utilities
├── .env.template            # Configuration template
├── requirements.txt         # Python dependencies
├── pyproject.toml          # Package metadata
├── validate_setup.py       # Setup validation script
├── README.md               # This file
├── SETUP-GUIDE.md          # Detailed setup instructions
└── LICENSE                 # MIT License

サポート

問題や質問がある場合は、以下に連絡してください:

• 開発者: Mohamed Wasim

• メール: Mohamed.Wasim@carelon.com

次のステップ

1. ✅ 上記の手順でセットアップを完了

2. ✅ 検証を実行: python validate_setup.py

3. ✅ IDEを設定

4. ✅ IDEを再起動

5. ✅ Jira/ConfluenceでAIアシスタントの使用を開始

追加リソース

• SETUP-GUIDE.md - スクリーンショットの説明付きの詳細なステップバイステップガイド

• 元のドキュメント - https://mcp-atlassian.soomiles.com

ライセンス

MITライセンス - Elevance Health/Carelon社内用

バージョン: 1.0
最終更新: 2026年3月
保守担当: Carelon Global Solutions