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の公式製品ではありません。