Atlassian MCP Server

Integrations

  • Provides a server for integrating with Atlassian cloud services, requiring an Atlassian account and API token.

  • Allows retrieving page content by ID and searching for content within Confluence pages.

  • Enables getting ticket details, searching tickets with JQL, creating new tickets, and adding comments to tickets in Jira.

アトラシアン MCP サーバー

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

特徴

  • JIRAチケットの詳細を取得する
  • JQL を使用して JIRA チケットを検索する
  • 新しいJIRAチケットを作成する
  • JIRAチケットにコメントを追加する
  • Confluenceページコンテンツを取得する
  • Confluenceでコンテンツを検索する

前提条件

  • 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
  1. プロジェクトを構築する
npm run build
  1. グローバルにインストール
npm install -g .
  1. セットアップを実行する
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
  1. まだ存在しない場合は、 assetsディレクトリにicon.pngファイルを追加します。
  2. 公開スクリプトを実行します。
npm run publish-mcp
  1. 指示に従ってnpmに公開するか、配布パッケージを作成します。
  2. リポジトリの URL を Cline MCP Marketplace チームに送信します。

ライセンス

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

ID: ok85tqlb4u