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 サーバー設定

{
  "mcpServers": {
    "atlassian": {
      "command": "npx",
      "args": ["-y", "@sooperset/mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
        "CONFLUENCE_EMAIL": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

注： JIRA_API_TOKEN と CONFLUENCE_API_TOKEN は必ず環境変数またはシークレットマネージャーから読み込み、認証情報をコードに直接記述しないでください。

制約事項

必ず行うこと

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

必ず避けること

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

出力テンプレート

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

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

ドキュメント