Atlassian AI Toolkit

Atlassian Jira および Confluence 向けの AI ファースト SDK、CLI、MCP サーバー

型付き SDK、エージェントネイティブ CLI、Atlassian Cloud API 用の MCP サーバーを含む Bun モノレポです。

パッケージ

Related MCP server: MCP Atlassian

CLI のインストール

推奨: スタンドアロンバイナリ

Node.js も npm も不要、PATH の競合もありません。Bun でビルドされた単一ファイルです。

macOS および Linux:

curl -fsSL https://raw.githubusercontent.com/spenserhale/atlassian-ai-toolkit/main/scripts/install.sh | sh

このスクリプトは OS とアーキテクチャを検出し、最新リリースから対応するバイナリをダウンロードして SHA256 を検証し、$HOME/.local/bin/atlassian にインストールします。

ATLASSIAN_AI_TOOLKIT_VERSION=v0.1.0 でバージョンを固定するか、ATLASSIAN_AI_TOOLKIT_INSTALL=$HOME/bin でインストール先ディレクトリを変更できます。

Windows: 最新リリース から atlassian-windows-x64.exe をダウンロードし、PATH に配置してください。

利用可能なバイナリ: atlassian-linux-{x64,arm64}、atlassian-darwin-{x64,arm64}、atlassian-windows-x64.exe。

アップグレード

インストール済みバイナリを、最新の GitHub リリースからその場でアップグレードします (最初に SHA256 を検証します):

atlassian upgrade            # apply the latest release
atlassian upgrade --dry-run  # only show current vs latest

Windows では、アップグレード前に実行中のインスタンスを終了するか、最新リリース から exe を再ダウンロードしてください。

シェルエイリアス

コマンドを短くするには、シェルプロファイル (~/.zshrc または ~/.bashrc) に次のエイリアスを追加します:

alias jira='atlassian jira'
alias conf='atlassian confluence'

これで、jira get PROJ-123 は atlassian jira get PROJ-123 を実行し、conf get 123456 は atlassian confluence get 123456 を実行します。

設定

シェルで Atlassian Cloud の認証情報を設定します:

export ATLASSIAN_SITE_URL="https://your-site.atlassian.net"
export ATLASSIAN_EMAIL="you@example.com"
export ATLASSIAN_API_TOKEN="your-api-token"

スコープ付き API トークンは https://id.atlassian.com/manage-profile/security/api-tokens で作成します。

添付ファイル

1 つ以上のファイルを Jira 課題にアップロードします。複数アップロードするには --file を繰り返します。保存されるファイル名はファイルのベース名で、MIME タイプは拡張子から推測されます。

# Attach a single file
atlassian jira attach PROJ-123 --file ./screenshot.png

# Attach several files and print the API response
atlassian jira attach PROJ-123 --file ./error.log --file ./har-capture.har --json

MCP ツール jira_add_attachment は同じ paths に加え、エージェントがインラインで生成するコンテンツ用の files 配列を受け取ります (filename、content、encoding: utf8 | base64)。

Confluence ページでは、1 回の呼び出しにつき 1 つの添付ファイルを受け付けます:

atlassian confluence attachment upload --page 123456 --file ./diagram.png

サイトで添付ファイルが有効になっている必要があり、アップロードはサイトの最大添付ファイルサイズの制限を受けます。

破壊的操作

削除はデフォルトでプレビューされます。実際の削除には --force と、取得したリソースから得られる一致する --confirm 値が必要です。

# Preview the permanent Jira delete
atlassian jira delete PROJ-123

# Permanently delete the Jira issue
atlassian jira delete PROJ-123 --force --confirm PROJ-123

# Preview moving a Confluence page to trash
atlassian confluence delete 123456

# Move a Confluence page to trash
atlassian confluence delete 123456 --force --confirm 123456

# Permanently purge an already-trashed Confluence page
atlassian confluence delete 123456 --purge --force --confirm 123456

ソースから始める

# Install dependencies
bun install

# Build all packages
bun run build

# Run the CLI
bun run dev:cli -- --help

# Run the MCP server (stdio mode for Claude Desktop)
bun run dev:mcp

トークンは、ワークフローに必要な最小限の Jira および Confluence の権限にスコープする必要があります。サードパーティのリファレンス実装は refs/ にありますが、これは意図的に gitignore されており、このリポジトリが未レビューのコードをベンダリングしたり、ローカル認証情報を使って実行したりすることはありません。

アーキテクチャ

packages/sdk/     <-- Types, API client, business logic (foundation)
    ^       ^
    |       |
packages/cli/   packages/mcp/
    (Stricli)    (FastMCP)

CLI と MCP サーバーはどちらも SDK の薄いラッパーです。REST API が変更された場合は SDK を更新するだけで、両方のコンシューマーが自動的に修正を受け取れます。

開発

# Run tests across all packages
bun test

# Build a specific package
cd packages/sdk && bun run build

新しい API オペレーションの追加

1. packages/sdk/src/types.ts に型を追加する

2. packages/sdk/src/client.ts にクライアントメソッドを追加する

3. packages/cli/src/commands/ に CLI コマンドを追加する

4. packages/mcp/src/tools/ に MCP ツールを追加する

破壊的操作はデフォルトでプレビューパスにし、CLI では明示的な --force フラグ、MCP ツールでは force: true を必須にする必要があります。