atlassian-mcp

Atlassian MCP エキスパート

このスキルを使用する場面

• JQL フィルターを使って Jira の課題を検索する場合
• Confluence ページを検索または作成する場合
• スプリントのワークフローやバックログ管理を自動化する場合
• MCP サーバーの認証（OAuth/API トークン）を設定する場合
• 会議のメモを Jira チケットに同期する場合
• 課題データからドキュメントを生成する場合
• Atlassian API の統合に関する問題をデバッグする場合
• 公式 MCP サーバーとオープンソース MCP サーバーのどちらを選ぶか検討する場合

基本的なワークフロー

1. サーバーを選択する - 公式のクラウド版、オープンソース、またはセルフホスト可能な MCP サーバーを選択します
2. 認証する - OAuth 2.1、API トークン、または PAT 認証情報を設定します
3. クエリを設計する - Jira には JQL、Confluence には CQL を記述します。完全に実行する前に maxResults=1 で検証します
4. ワークフローを実装する - ツール呼び出しを構築し、ページネーションとエラー復旧に対応します
5. 権限を確認する - 書き込みや一括操作を行う前に、読み取り専用のプローブで必要なスコープを確認します
6. デプロイする - IDE 統合を設定し、権限をテストして、レート制限を監視します

リファレンスガイド

状況に応じて詳細なガイダンスを読み込んでください。

トピック	リファレンス	読み込むタイミング
サーバーのセットアップ	references/mcp-server-setup.md	インストール、サーバーの選択、設定
Jira の操作	references/jira-queries.md	JQL 構文、課題の CRUD、スプリント、ボード、課題のリンク
Confluence の操作	references/confluence-operations.md	CQL 検索、ページの作成、スペース、コメント
認証	references/authentication-patterns.md	OAuth 2.0、API トークン、権限スコープ
一般的なワークフロー	references/common-workflows.md	課題のトリアージ、ドキュメントの同期、スプリントの自動化

クイックスタートの例

JQL クエリのサンプル

# Open issues assigned to current user in a sprint
project = PROJ AND status = "In Progress" AND assignee = currentUser() ORDER BY priority DESC

# Unresolved bugs created in the last 7 days
project = PROJ AND issuetype = Bug AND status != Done AND created >= -7d ORDER BY created DESC

# Validate before bulk: test with maxResults=1 first
project = PROJ AND sprint in openSprints() AND status = Open ORDER BY created DESC

CQL クエリのサンプル

# Find pages updated in a specific space recently
space = "ENG" AND type = page AND lastModified >= "2024-01-01" ORDER BY lastModified DESC

# Search page text for a keyword
space = "ENG" AND type = page AND text ~ "deployment runbook"

最小限の MCP サーバー設定

Atlassian Cloud：ホストされている Atlassian Rovo MCP Server に接続し、/mcp を実行して OAuth でサインインします。

claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp

Server/Data Center：個人アクセストークンを使用して、コミュニティ製の mcp-atlassian サーバー（sooperset）を実行します。

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

注記： トークンは必ず環境変数またはシークレットマネージャーから読み込み、認証情報をコードに直接記述しないでください。ツール名はサーバーによって異なります。references/mcp-server-setup.md を参照してください。

制約事項

必ず行うこと

• ユーザーの権限とワークスペースのアクセス制御を尊重する
• 実行前に JQL/CQL クエリを検証する（最初に maxResults=1 でプローブする）
• 指数バックオフを使ってレート制限に対応する
• 大量の結果にはページネーションを使用する（1 ページあたり 50～100 件）
• ネットワーク障害に備えてエラー復旧を実装する
• デバッグと監査証跡のために API 呼び出しをログに記録する
• まず読み取り専用操作でテストする
• 必要な権限スコープを文書化する
• 本番データに対する書き込みや一括操作の前に確認する

必ず避けること

• API トークンや OAuth シークレットをコードに直接記述する
• Atlassian API からのレート制限ヘッダーを無視する
• 必須フィールドを検証せずに課題を作成する
• ユーザーが指定したクエリ文字列の入力サニタイズを省略する
• 権限の境界をテストせずにデプロイする
• 確認プロンプトなしで本番データを更新する
• 同じセッションで異なる認証方式を混在させる
• 機密性の高い課題データをログやエラーメッセージに露出させる

出力テンプレート

Atlassian MCP の機能を実装する際は、次の内容を提示してください。

1. MCP サーバーの設定（JSON/環境変数）
2. クエリの例（説明付きの JQL/CQL）
3. エラー処理を含むツール呼び出しの実装
4. 認証の設定手順
5. 必要な権限に関する簡潔な説明

Synergetic Solutions のプリンシパルコンサルタント、@jeffallan がメンテナンスしています。

ドキュメント