MCP Atlassian Server

MCP Atlassian Server（phuc-nt による）

導入

**MCP Atlassian Server (phuc-nt 製)**は、Cline、Claude Desktop、Cursor などの AI エージェントを Atlassian Jira および Confluence に接続し、標準化されたインターフェースを通じてデータのクエリやアクションの実行を可能にする Model Context Protocol (MCP) サーバーです。

**注:**このサーバーは主に Cline で使用するために設計および最適化されていますが、MCP 標準に準拠しており、他の MCP 互換クライアントでも動作します。

• 主な機能:
  • AIエージェントをAtlassian JiraおよびConfluenceに接続する
  • リソース（読み取り専用）とツール（アクション/ミューテーション）の両方をサポート
  • MCP Marketplace を通じて Cline と簡単に統合
  • 個人開発環境向けのローカルファースト設計
  • Cline AIアシスタントとの最適化された統合

このプロジェクトの目的

JiraとConfluenceを日々開発に使っている私は、これらのツールの操作にかなりの時間を費やしていることに気づきました。これらのツールは確かに強力ですが、集中して作業している最中に頻繁にコンテキストを切り替えることなく、もっと簡単に操作できる方法があればいいのにと思っていました。

AIエージェントとモデルコンテキストプロトコル（MCP）の登場は、まさに絶好の機会でした。JiraとConfluence（Slack、GitHub、カレンダーなどへの対応も計画中）をAIワークフローに接続できる可能性をすぐに見出しました。

このプロジェクトは、MCP と AI エージェントの学習の旅として始まりましたが、Atlassian ツールを日常的に使用する個人や組織にとって本当に役立つものに進化することを願っています。

システムアーキテクチャ

インストールとセットアップ

詳細なインストールおよびセットアップ手順については、 AIアシスタント向けインストールガイドをご覧ください。このガイドは、ClineなどのAI/LLMアシスタントがMCP Atlassian Serverを読み取り、自動的にセットアップできるように特別にフォーマットされています。

Clineユーザーへの注意：インストールガイド（llms-install.md）は、Cline AIが理解・実行できるように最適化されています。「MCP Atlassian Server（by phuc-nt）をインストール」とClineに指示するだけで、指示を解析し、ステップバイステップでセットアップをお手伝いします。

ガイドの内容は次のとおりです。

• 前提条件とシステム要件
• Node.js環境のステップバイステップのセットアップ
• Cline AIアシスタントをAtlassianに接続するための設定
• Atlassian APIトークンの取得と設定
• セキュリティに関する推奨事項とベストプラクティス

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Atlassian Integration Server を自動的にインストールするには:

機能の概要

すべてのリソースとツールの詳細なドキュメントについては、 「リソースとツールのリファレンス」を参照してください。

リクエストフロー

使用例

インストール後に Cline に次のクエリを実行してみてください。

1. タスクの作成と管理
   • 「プロジェクト DEMO にログインエラーに関する新しい問題を作成する」
   • 「現在のスプリントで自分に割り当てられたすべての課題を検索する」
   • 「問題 DEMO-43 を完了ステータスに移行する」
2. プロジェクト情報概要
   • 「プロジェクトDEMOのすべての問題を要約する」
   • 「プロジェクト DEMO の問題は誰に割り当てられますか?」
   • 「現在のスプリントで未割り当ての課題を一覧表示する」
3. Confluence によるドキュメント作成
   • 「「会議メモ」というタイトルのConfluenceページを作成する」
   • 「Confluence ページの「API ドキュメント」を新しい例とラベルで更新します」
   • 「建築に関するページに「ドキュメント」というラベルを追加する」
   • 「「会議メモ」ページから「下書き」ラベルを削除します」
   • 「APIドキュメントに関するConfluenceページにコメントを追加する」
4. 分析とレポート
   • 「現在のスプリントと前回のスプリントの完了した課題の数を比較する」
   • 「「To Do」ステータスの問題が最も多いのは誰ですか？」

これらのクエリは、この MCP サーバーで徹底的にテストされた Cline 環境内で最適に機能します。

使用上の注意

1. シンプルな JQL : 問題を検索するときは、スペースや特殊文字を含まないシンプルな JQL を使用します (例: project=DEMO``project = DEMO AND key = DEMO-43 )。
2. Confluence ページの作成: Confluence ページを作成するときは、エラーを回避するために、単純な HTML コンテンツを使用し、parentId を指定しないでください。
3. Confluence ページの更新：ページを更新する際は、競合を避けるため、必ず現在のバージョン番号を含めてください。ラベルの更新（追加/削除）も可能です。また、コンテンツには有効な保存形式を使用してください。
4. 問題の作成: 新しい問題を作成するときは、成功を最大限に高めるために、最低限必要なフィールド (projectKey、概要) のみを指定します。
5. アクセス権: 構成された Atlassian アカウントが、操作するプロジェクトとスペースにアクセスできることを確認します。

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

• APIトークンはそれを作成したユーザーのすべての権限を継承します
• 信頼できない相手とトークンを共有しないでください
• LLMにトークンを含む設定ファイルの分析を依頼する際は注意が必要です
• llms-install.mdの詳細なセキュリティガイドラインを参照してください。

貢献とサポート

• GitHub でプル リクエストまたは問題を開いて貢献します。
• 追加のサポートについては、MCP/Cline コミュニティに参加してください。

MCP Atlassian Server (phuc-nt 製) は、 Cline Marketplace からワンクリックでインストールできるようになりました。
詳細な手順についてはllms-install.mdをご覧ください。

サーバーはオープンな MCP 標準を使用していますが、主に Cline ユーザー向けに設計およびテストされています。