MCP Atlassian Sprint

MCP Atlassianは、Atlassian製品（ConfluenceとJira）にモデルコンテキストプロトコルサービスを提供する統合ツールで、クラウドおよびオンプレミスデプロイに対応しています。

知識管理と記憶開発者ツール #Atlassian統合 #知識管理 #プロジェクト管理 #IDEツール .Python

スコア : 2.5ポイント

ダウンロード数 : 19

更新時間 : 2025-04-28

MCP Atlassianとは？

MCP Atlassianは、Atlassianプラットフォーム内のConfluenceとJiraサービスを接続および操作するためのモデルコンテキストプロトコル（MCP）サーバーです。簡単なコマンドでチームの知識ベースとタスク管理システムにアクセスし、管理することができます。

MCP Atlassianの使い方は？

サーバーをインストールし、対応するAPIトークンを設定するだけで使用を開始できます。コンテンツを検索したり、ページを作成したり、プロジェクトを更新したりすることができます。

適用シナリオ

効率的な管理と協力が必要な企業チーム、特にConfluenceとJiraを知識共有とタスク追跡に依存しているチームに適しています。

主要機能

Confluence統合Confluenceのスペースとページの検索、作成、更新、削除をサポートします。

Jira統合Jiraのプロジェクトとそれに関連するタスクの検索、作成、更新、削除をサポートします。

多プラットフォームサポートAtlassian CloudおよびServer/Data Centerデプロイと互換性があります。

利点と制限

利点

Atlassian製品とのシームレスな統合

複数のクエリ言語（CQLとJQL）をサポート

インストールと設定が容易

制限

有効なAPIトークンが必要

一部の高度な機能には特定の権限が必要

使い方

サーバーのインストール

brew、pipまたはDockerを使用してMCP Atlassianをインストールします。

認証の設定

APIトークンを生成し、サーバー上でURLと資格情報を設定します。

使用開始

サーバーを起動し、基本機能をテストします。

使用例

例1：Confluenceコンテンツの検索CQLクエリを使用してConfluenceページを検索します。

例2：Jiraタスクの作成JQLクエリを使用して新しいJiraタスクを作成します。

よくある質問

APIトークンを取得する方法は？

SSL検証はサポートされていますか？

トランスポートモードを切り替える方法は？

関連リソース

公式ドキュメント

詳細なインストールと設定ガイド。

GitHubコードリポジトリ

ソースコードと貢献ガイド。

デモビデオ

MCP Atlassianの機能をすばやく理解する。

インストール

以下のコマンドをクライアントにコピーして設定

{
  "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"
      ]
    }
  }
}

{
  "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"
      ]
    }
  }
}

{
  "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"
      ]
    }
  }
}

{
  "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"
      ]
    }
  }
}

注意：あなたのキーは機密情報です。誰とも共有しないでください。

🚀 MCP アトラスサーバーガイド

MCP アトラスサーバーは、Confluence と Jira プロジェクトの管理を支援するツールです。このガイドでは、サーバーのインストール、設定、使用方法などを説明します。

🚀 クイックスタート

📦 インストール

パッケージマネージャーを使用したインストール

npm を使用する場合：

npm install mcp-atlassian --save

Yarn を使用する場合：

yarn add mcp-atlassian

設定ファイルの作成

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を追加します。

CONFLUENCE_URL=あなたのアトラスのURL
CONFLUENCE_USERNAME=あなたのユーザー名
CONFLUENCE_TOKEN=あなたのAPIトークン

JIRA_URL=あなたのJiraのURL
JIRA_USERNAME=あなたのユーザー名
JIRA_TOKEN=あなたのAPIトークン

サーバーの起動

npx mcp-atlassian

✨ 主な機能

MCP アトラスサーバーの機能

リソースのフィルタリング：ユーザーがアクティブにインタラクションしているアトラススペースと 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`	特定のエピックタスクに関連付けられたすべての問題を取得します。

💻 使用例

基本的な使用法

Confluence 内容の検索

mcp-atlassian confluence_search --query "あなたの検索キーワード"

新しい Jira 問題の作成

mcp-atlassian jira_create_issue --projectKey "プロジェクトキー" --issueType "タスク" --summary "問題の概要" --description "詳細な説明"

📚 ドキュメント

開発とデバッグ

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

リポジトリをクローンします。

git clone https://github.com/your-username/mcp-atlassian.git
cd mcp-atlassian

依存関係をインストールします。
```
npm install
```
開発サーバーを起動します。
```
npm run dev
```

デバッグツール

mcp-debug パッケージを使用して MCP サーバーをデバッグします。

npm install mcp-debug --save-dev

セキュリティに関する注意事項

トークンの保護：API トークンをコード内に平文で保存しないでください。環境変数を使用することをおすすめします。
アクセスの制限：アトラスと Jira のアクセス権限がセキュリティポリシーに準拠していることを確認してください。

高度な設定

プロキシサーバーの設定

.env ファイルに以下の内容を追加してプロキシを設定します。

HTTP_PROXY=http://プロキシアドレス:ポート
HTTPS_PROXY=https://プロキシアドレス:ポート

ログ記録の有効化

.env ファイルで詳細なログを有効にします。

DEBUG=true

よくある質問

認証に失敗した場合はどうすればいいですか？
- ユーザー名とトークンが正しいことを確認してください。
- トークンが十分な権限を持っていることを確認してください。
アトラスまたは Jira に接続できません。どうすればいいですか？
- ネットワーク接続を確認してください。
- ターゲットの URL が正しいことを確認してください。
ツールコマンドをデバッグするにはどうすればいいですか？
- コマンドラインで --verbose オプションを使用して詳細出力を有効にします。
```
mcp-atlassian <コマンド> --verbose
```