アトラシアン MCP サーバー

Atlassian JIRAおよびConfluenceとの統合のためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、MCPプロトコルを介してJIRAチケットやConfluenceページを操作するためのツールを提供します。

特徴

• JIRAチケットの詳細を取得する

• JQL を使用して JIRA チケットを検索する

• 新しいJIRAチケットを作成する

• JIRAチケットにコメントを追加する

• Confluenceページコンテンツを取得する

• Confluenceでコンテンツを検索する

Related MCP server: Jira MCP Server

前提条件

• Node.js 16以上

• Atlassian Cloud アカウント

• Atlassian APIトークン

インストール

オプション 1: Cline Marketplace からインストールする (推奨)

1. オープンクライン

2. 設定 > MCPサーバーへ移動

3. 「マーケットプレイス」タブを選択します

4. 「アトラシアン」を検索

5. 「インストール」をクリック

6. プロンプトが表示されたら、Atlassian の資格情報を設定します。

オプション2: npmからインストールする

npm install -g atlassian-mcp-server

オプション3: ソースからインストールする

1. リポジトリをクローンする

2. インストール スクリプトを実行します。

./install.sh

または手動で:

1. 依存関係をインストールする

npm install

2. プロジェクトを構築する

npm run build

3. グローバルにインストール

npm install -g .

4. セットアップを実行する

atlassian-mcp-setup

構成

セットアップ スクリプト、構成ファイル、または環境変数を使用してサーバーを構成できます。

セットアップ スクリプトの使用 (推奨)

セットアップ スクリプトを実行して構成ファイルを作成します。

npx atlassian-mcp-setup

またはローカルにインストールされている場合:

npm run setup

スクリプトは構成プロセスをガイドし、 configディレクトリにconfig.jsonファイルを作成します。

設定ファイルを手動で使用する

1. configディレクトリにconfig.jsonファイルを作成します ( config.sample.jsonからコピーできます)

2. Atlassian の詳細を入力してください:

{
  "atlassian": {
    "baseUrl": "https://your-instance.atlassian.net",
    "email": "your-email@example.com",
    "token": "your-api-token-here"
  },
  "server": {
    "name": "atlassian-server",
    "version": "0.1.0"
  }
}

環境変数の使用

次の環境変数を設定します。

• ATLASSIAN_BASE_URL : Atlassian インスタンスの URL (例: https://your-instance.atlassian.net )

• ATLASSIAN_EMAIL : Atlassianアカウントのメールアドレス

• ATLASSIAN_TOKEN : Atlassian APIトークン

• ATLASSIAN_CONFIG_PATH : (オプション) カスタム構成ファイルの場所へのパス

Atlassian APIトークンの取得

1. https://id.atlassian.com/manage-profile/security/api-tokensで Atlassian アカウントにログインします。

2. 「APIトークンを作成」をクリックします

3. トークンに名前を付けます（例：「MCP Server」）

4. 生成されたトークンをコピーします（再度表示することはできません）

使用法

サーバーの実行

atlassian-mcp-server

またはソースからインストールした場合:

npm start

Clineとの統合

オプション 1: Marketplace からインストールする (推奨)

1. オープンクライン

2. 設定 > MCPサーバーへ移動

3. 「マーケットプレイス」タブを選択します

4. 「アトラシアン」を検索

5. 「インストール」をクリック

6. プロンプトが表示されたら、Atlassian の資格情報を設定します。

オプション2: 手動設定

サーバーを手動でインストールした場合は、MCP 設定に以下を追加します。

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp-server",
      "args": [],
      "env": {
        "ATLASSIAN_CONFIG_PATH": "/path/to/your/config.json"
      },
      "disabled": false
    }
  }
}

あるいは、設定で資格情報を直接提供することもできます。

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp-server",
      "args": [],
      "env": {
        "ATLASSIAN_BASE_URL": "https://your-instance.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@example.com",
        "ATLASSIAN_TOKEN": "your-api-token-here"
      },
      "disabled": false
    }
  }
}

利用可能なツール

get_jira_ticket

キー別に JIRA チケットの詳細を取得します。

パラメータ:

• ticket_key : JIRA チケット キー (例: "PROJ-123")

Jiraチケット検索

JQL を使用して JIRA チケットを検索します。

パラメータ:

• jql : JQLクエリ文字列

• max_results : 返される結果の最大数（デフォルト: 10）

Jiraチケットの作成

新しい JIRA チケットを作成します。

パラメータ:

• project_key : プロジェクトキー（例："PROJ"）

• summary : チケットの概要/タイトル

• description : チケットの説明

• issue_type : 問題の種類（例：「バグ」、「タスク」、「ストーリー」）（デフォルト：「タスク」）

Jiraチケットにコメントを追加する

JIRA チケットにコメントを追加します。

パラメータ:

• ticket_key : JIRA チケット キー (例: "PROJ-123")

• comment : コメントテキスト

get_confluence_page

ID で Confluence ページを取得します。

パラメータ:

• page_id : Confluence ページ ID

検索合流点

Confluence 内のコンテンツを検索します。

パラメータ:

• query : 検索クエリ

• limit : 結果の最大数（デフォルト: 10）

マーケットプレイスへの公開

このサーバーは、次の GitHub リポジトリを使用して Cline MCP Marketplace に公開されるように構成されています: https://github.com/kompallik/ATLASSIAN-MCP

更新を公開するには:

1. 提供されているスクリプトを使用して、変更を GitHub リポジトリにプッシュします。

npm run push-github

2. まだ存在しない場合は、 assetsディレクトリにicon.pngファイルを追加します。

3. 公開スクリプトを実行します。

npm run publish-mcp

4. 指示に従ってnpmに公開するか、配布パッケージを作成します。

5. リポジトリの URL を Cline MCP Marketplace チームに送信します。

ライセンス

マサチューセッツ工科大学