MCPアトラシアン

Atlassian製品（ConfluenceおよびJira）用のモデルコンテキストプロトコル（MCP）サーバー。この統合は、Atlassian CloudとServer/Data Centerの両方のデプロイメントをサポートします。

機能デモ

互換性

製品	展開タイプ	サポートステータス
合流	雲	✅ 完全にサポートされています
合流	サーバー/データセンター	✅ サポートされています（バージョン 7.9 以降）
ジラ	雲	✅ 完全にサポートされています
ジラ	サーバー/データセンター	✅ サポートされています（バージョン 8.14 以降）

セットアップガイド

1. 認証の設定

まず、必要な認証トークンを生成します。

アトラシアンクラウド向け

https://id.atlassian.com/manage-profile/security/api-tokensにアクセスしてください。
「APIトークンの作成」をクリックし、名前を付けます
トークンをすぐにコピーする

サーバー/データセンター向け

プロフィール（アバター）→プロフィール→個人アクセストークンに移動します
**「トークンの作成」**をクリックし、名前を付けて有効期限を設定します
トークンをすぐにコピーする

2. インストール

次のいずれかのインストール方法を選択します。

# Using uv (recommended)
brew install uv
uvx mcp-atlassian

# Using pip
pip install mcp-atlassian

# Using Docker
git clone https://github.com/sooperset/mcp-atlassian.git
cd mcp-atlassian
docker build -t mcp/atlassian .

3. 設定と使用方法

MCPサーバーはコマンドライン引数を使用して設定できます。サーバーはConfluence、Jira、または両方のサービスをサポートしています。ユースケースに必要な引数のみを指定してください。

必須引数

Atlassian Cloud の場合:

uvx mcp-atlassian \
  --confluence-url https://your-company.atlassian.net/wiki \
  --confluence-username your.email@company.com \
  --confluence-token your_api_token \
  --jira-url https://your-company.atlassian.net \
  --jira-username your.email@company.com \
  --jira-token your_api_token

サーバー/データセンターの場合:

uvx mcp-atlassian \
  --confluence-url https://confluence.your-company.com \
  --confluence-personal-token your_token \
  --jira-url https://jira.your-company.com \
  --jira-personal-token your_token

注: Confluence のみ、Jira のみ、または両方のサービスを設定できます。使用するサービスの引数のみを指定してください。例えば、Confluence Cloud のみを使用する場合は、 --confluence-url 、 --confluence-username 、 --confluence-tokenのみが必要です。

オプション引数

--transport : トランスポートタイプを選択します ( stdio [デフォルト] またはsse )
--port : SSEトランスポートのポート番号（デフォルト: 8000）
--[no-]confluence-ssl-verify : Confluence Server/DC の SSL 検証をオン/オフにする
--[no-]jira-ssl-verify : Jira Server/DC の SSL 検証のオン/オフ
--verbose : ログの詳細度を上げる（複数回使用可能）
--read-only : 読み取り専用モードで実行します（すべての書き込み操作を無効にします）

**注:**すべての設定オプションは環境変数でも設定できます。利用可能な環境変数の完全なリストについては、リポジトリ内の.env.exampleファイルを参照してください。

IDE統合

クロードデスクトップセットアップ

uvx の使用 (推奨) - クラウド:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://confluence.your-company.com",
        "--confluence-personal-token=your_token",
        "--jira-url=https://jira.your-company.com",
        "--jira-personal-token=your_token"
      ]
    }
  }
}

注: 以下の例はAtlassian Cloudの設定を使用しています。Server/Data Centerの場合は、上記の設定セクションに示されている対応する引数（--confluence-personal-token、--jira-personal-token）を使用してください。

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "python",
      "args": [
        "-m",
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

注: 以下の例はAtlassian Cloudの設定を使用しています。Server/Data Centerの場合は、上記の設定セクションに示されている対応する引数（--confluence-personal-token、--jira-personal-token）を使用してください。

Docker 環境を構成するには、次の 2 つの方法があります。

設定で CLI 引数を直接使用する:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

環境ファイルの使用:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/path/to/your/.env",
        "mcp/atlassian"
      ]
    }
  }
}

カーソルIDEセットアップ

カーソル設定を開く
Features > MCP Serversに移動します
Add new MCP serverクリックします

stdio トランスポートの場合:

name: mcp-atlassian
type: command
command: uvx mcp-atlassian --confluence-url=https://your-company.atlassian.net/wiki --confluence-username=your.email@company.com --confluence-token=your_api_token --jira-url=https://your-company.atlassian.net --jira-username=your.email@company.com --jira-token=your_api_token

name: mcp-atlassian
type: command
command: uvx mcp-atlassian --confluence-url=https://confluence.your-company.com --confluence-personal-token=your_token --jira-url=https://jira.your-company.com --jira-personal-token=your_token

SSE トランスポートの場合、まずサーバーを起動します。

uvx mcp-atlassian ... --transport sse --port 8000

次にカーソルで設定します。

name: mcp-atlassian
type: sse
Server URL: http://localhost:8000/sse

リソース

注: MCP サーバーは、ユーザーの貢献と割り当てに基づいて、ユーザーがアクティブにやり取りしている Confluence スペースと Jira プロジェクトのみを表示するようにリソースをフィルタリングします。

confluence://{space_key} : Confluence スペースにアクセスする
jira://{project_key} : Jira プロジェクトにアクセスする

利用可能なツール

道具	説明
`confluence_search`	CQL を使用して Confluence コンテンツを検索する
`confluence_get_page`	特定のConfluenceページの内容を取得する
`confluence_get_page_children`	特定の Confluence ページの子ページを取得する
`confluence_get_page_ancestors`	特定の Confluence ページの親ページを取得する
`confluence_get_comments`	特定のConfluenceページのコメントを取得する
`confluence_create_page`	新しいConfluenceページを作成する
`confluence_update_page`	既存のConfluenceページを更新する
`confluence_delete_page`	既存のConfluenceページを削除する
`jira_get_issue`	特定の Jira の問題の詳細を取得する
`jira_search`	JQL を使用して Jira の問題を検索する
`jira_get_project_issues`	特定の Jira プロジェクトのすべての課題を取得する
`jira_create_issue`	Jiraで新しい課題を作成する
`jira_update_issue`	既存の Jira の問題を更新する
`jira_delete_issue`	既存の Jira の問題を削除する
`jira_get_transitions`	Jira の問題の利用可能なステータス遷移を取得する
`jira_transition_issue`	Jira の問題を新しいステータスに移行する
`jira_add_worklog`	Jira 課題に作業ログエントリを追加する
`jira_get_worklog`	Jira の問題の作業ログエントリを取得する
`jira_link_to_epic`	問題をエピックにリンクする
`jira_get_epic_issues`	特定のエピックにリンクされたすべての問題を取得する

開発とデバッグ

ローカル開発のセットアップ

リポジトリをクローンしてローカルバージョンを実行する場合:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/your/mcp-atlassian",
        "run", "mcp-atlassian",
        "--confluence-url=https://your-domain.atlassian.net/wiki",
        "--confluence-username=your.email@domain.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-domain.atlassian.net",
        "--jira-username=your.email@domain.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

デバッグツール

# Using MCP Inspector
# For installed package
npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

# For local development version
npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...

# View logs
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

安全

APIトークンを共有しないでください
.env ファイルを安全かつプライベートに保つ
ベストプラクティスについてはSECURITY.mdをご覧ください

ライセンス

MITライセンス（ LICENSEファイル参照）です。これはAtlassianの公式製品ではありません。

MCP Atlassian

Integrations