Atlassian MCP エキスパート

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

• JQL フィルターを使用した Jira 課題のクエリ
• Confluence ページの検索または作成
• スプリント ワークフローとバックログ管理の自動化
• MCP サーバー認証（OAuth/API トークン）の設定
• ミーティング ノートから Jira チケットへの同期
• 課題データからのドキュメント生成
• Atlassian API 統合の問題のデバッグ
• 公式サーバーとオープンソース 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 クエリサンプル

# スプリント内の現在のユーザーに割り当てられたオープン課題
project = PROJ AND status = "In Progress" AND assignee = currentUser() ORDER BY priority DESC

# 過去 7 日間に作成された未解決のバグ
project = PROJ AND issuetype = Bug AND status != Done AND created >= -7d ORDER BY created DESC

# バルク実行前に検証：最初に maxResults=1 でテスト
project = PROJ AND sprint in openSprints() AND status = Open ORDER BY created DESC

CQL クエリサンプル

# 特定のスペースで最近更新されたページを検索
space = "ENG" AND type = page AND lastModified >= "2024-01-01" ORDER BY lastModified DESC

# ページテキストでキーワードを検索
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": "user@example.com",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
        "CONFLUENCE_EMAIL": "user@example.com",
        "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. 権限要件の簡潔な説明

ドキュメント