Atlassian Cli

atlassian-cli

インストール

go install（推奨）

Go 1.21 以降が必要です。

go install github.com/putcho01/atlassian-cli@latest

$GOPATH/bin が $PATH に含まれていない場合は、シェルの設定ファイル（~/.zshrc など）に次の内容を追加してください。

export PATH="$PATH:$(go env GOPATH)/bin"

ソースからインストール

git clone https://github.com/putcho01/atlassian-cli.git
cd atlassian-cli
go build -o atlassian-cli .

クイックスタート

Cloud（atlassian.net）

1. API トークンを作成します。

2. 環境変数を設定します。

export JIRA_URL=https://your-domain.atlassian.net
export [email protected]
export JIRA_API_TOKEN=your-api-token

3. 認証を確認します。

atlassian-cli jira myself

Confluence も使用する場合は、追加の変数を設定します。

export CONFLUENCE_URL=https://your-domain.atlassian.net/wiki
export [email protected]
export CONFLUENCE_API_TOKEN=your-api-token

Server/Data Center

export JIRA_URL=https://jira.example.com
export JIRA_PERSONAL_TOKEN=your-pat

JIRA_EMAIL が設定されていない場合、Bearer（PAT）認証が自動的に使用されます。

認証

2 種類の認証方式に対応しています。

Cloud - API トークン（Basic 認証）

Atlassian Cloud（*.atlassian.net）で使用します。メールアドレスと API トークンを使った Basic 認証で認証します。

変数	説明
JIRA_URL	Jira Cloud の URL（例：https://your-domain.atlassian.net）
JIRA_EMAIL	Atlassian アカウントのメールアドレス
JIRA_API_TOKEN	API トークン
JIRA_DEFAULT_PROJECT	--project が省略された場合に使用するデフォルトのプロジェクトキー（任意）
CONFLUENCE_URL	Confluence Cloud の URL（例：https://your-domain.atlassian.net/wiki）
CONFLUENCE_EMAIL	Atlassian アカウントのメールアドレス
CONFLUENCE_API_TOKEN	API トークン

Server/Data Center - Personal Access Token（Bearer）

セルフホスト型の Jira/Confluence Server/DC で使用します。PAT を使った Bearer 認証で認証します。

変数	説明
JIRA_URL	Jira のベース URL（例：https://jira.example.com）
JIRA_PERSONAL_TOKEN	Personal Access Token
JIRA_DEFAULT_PROJECT	--project が省略された場合に使用するデフォルトのプロジェクトキー（任意）
CONFLUENCE_URL	Confluence のベース URL
CONFLUENCE_PERSONAL_TOKEN	Personal Access Token

EMAIL が設定されている場合は Basic 認証（Cloud）が使用され、設定されていない場合は Bearer 認証（Server/DC）が使用されます。

使用するサービスの変数だけが必要です。たとえば、Jira のみを使用する場合、Confluence の変数を設定する必要はありません。

コマンド

Jira

# Authentication
atlassian-cli jira myself                # Show authenticated user

# Issues
atlassian-cli jira issue get PROJ-123    # Get issue (includes description)
atlassian-cli jira issue open PROJ-123   # Open issue in browser
atlassian-cli jira issue search "project = PROJ"       # Search issues via JQL
atlassian-cli jira issue search "project = PROJ" -i    # Interactive TUI picker (↑/↓ navigate, enter detail, o open, q quit)
atlassian-cli jira issue create --project PROJ --summary "New task"  # or omit --project if JIRA_DEFAULT_PROJECT is set
atlassian-cli jira issue update PROJ-123 --field summary="Updated summary"
atlassian-cli jira issue delete PROJ-123
atlassian-cli jira issue subtasks PROJ-123
atlassian-cli jira issue transition PROJ-123 "In Progress"

# Comments
atlassian-cli jira issue comment list PROJ-123
atlassian-cli jira issue comment add PROJ-123 --body "Looks good to me"

Confluence

# Pages
atlassian-cli confluence page get 12345          # Get page content
atlassian-cli confluence page create --space PROJ --title "New Page" --body "<p>Hello</p>"
atlassian-cli confluence page create --space PROJ --title "Child Page" --parent 12345 --body "<p>Child</p>"
atlassian-cli confluence page update 12345 --title "Updated Title" --body "<p>New content</p>"           # version auto-detected
atlassian-cli confluence page update 12345 --title "Updated Title" --body "<p>New content</p>" --version 3  # explicit version

# Labels
atlassian-cli confluence label list 12345
atlassian-cli confluence label add 12345 important,reviewed
atlassian-cli confluence label remove 12345 outdated

# Page Restrictions
atlassian-cli confluence restriction list 12345
atlassian-cli confluence restriction add 12345 --operation update --type user --name <account-id>
atlassian-cli confluence restriction remove 12345 --operation update --type user --name <account-id>

出力形式

すべてのコマンドは、--output / -o フラグで 3 種類の出力形式に対応しています。

# Default: human-readable table
atlassian-cli jira issue search "project = PROJ" -o table

# Machine-readable JSON
atlassian-cli jira issue search "project = PROJ" -o json

# GitHub-flavored Markdown (great for Claude Code)
atlassian-cli jira issue search "project = PROJ" -o markdown

HTML から Markdown への変換

-o markdown を使用すると、HTML コンテンツ（Jira の説明、Confluence ページ本文、コメント）は、読みやすい GitHub Flavored Markdown に自動変換されます。Confluence のストレージ形式のマクロにも対応しています。

• コードブロック（ac:structured-macro name="code"）-> フェンス付きコードブロック
• 注意書き（note、info、warning、tip）-> ラベル付きの引用
• ページリンク（ac:link）-> 強調表示されたテキスト
• 目次マクロ -> 削除

MCP サーバー

AI アシスタントとの連携のために、MCP サーバーとして起動します。

atlassian-cli mcp-server

ツールグループのフィルタリング

--tools フラグを使って、利用可能なツールをフィルタリングします。

# Only enable Jira issue and search tools
atlassian-cli mcp-server --tools jira_issue,jira_search

# Only enable Confluence tools
atlassian-cli mcp-server --tools confluence_page,confluence_label

利用可能なツールグループ：

• jira_user - ユーザー認証
• jira_issue - 課題、サブタスクの取得
• jira_search - JQL による課題の検索
• jira_create - 課題の作成
• jira_update - 課題の更新
• jira_delete - 課題の削除
• jira_transition - 課題のトランジション、利用可能なトランジションの取得
• confluence_page - ページコンテンツの取得
• confluence_label - ラベル管理
• confluence_restriction - ページ制限の管理

Claude Code との統合

Claude Code の MCP 設定に追加します。

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-cli",
      "args": ["mcp-server"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token",
        "CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
        "CONFLUENCE_EMAIL": "[email protected]",
        "CONFLUENCE_API_TOKEN": "your-api-token"
      }
    }
  }
}

公式 ACLI ではなく、このツールを選ぶ理由

Atlassian は、公式 CLI（ACLI）と、AI 統合用のリモート MCP サーバーを提供しています。このツールとの違いは次のとおりです。

ACLI との比較

	atlassian-cli	ACLI
配布形態	単一バイナリ、依存関係なし	パッケージのインストールが必要
認証	環境変数のみ	対話型の acli auth login
CI/CD への適合性	高い — ブラウザーを使った認証が不要	限定的 — ヘッドレス環境でのログインが煩雑
Server/DC のサポート	あり（PAT 認証）	Cloud が中心
対象ユーザー	開発者、自動化、AI エージェント	管理者、一括操作

Atlassian のリモート MCP サーバーとの比較

Atlassian のリモート MCP サーバーは 2026 年 2 月に GA となりましたが、トレードオフがあります。

• コンテキストを大量に消費 — 73 個のツールスキーマを事前に読み込むため、実際の作業を始める前にコンテキストウィンドウの 40～50％を消費します
• OAuth が必須 — ブラウザベースの認証フローが必要で、ヘッドレス環境や CI/CD 環境には適していません
• ネットワークへの依存 — Atlassian のリモートサーバーへのアウトバウンド接続が必要です

このツールの --tools フラグを使えば、必要なグループだけを読み込めるため、AI エージェントのトークン使用量を最小限に抑えられます。

このツールを選ぶ場合

• CI/CD パイプラインや自動化スクリプトで実行する場合（環境変数による認証のみ）
• Server/Data Center と Cloud の両方で単一のインターフェースを使う場合
• コンテキスト効率が重要な AI エージェントにMCP サーバーとして組み込む場合

ライセンス

MIT