Atlassian MCP Server

Atlassian MCP Server

Atlassian MCP サーバーは、AI アシスタントと IDE を Jira や Confluence などの Atlassian 製品に接続するオープンソースの標準化された統合サーバーです。これにより、MCP 対応アプリケーションを通じて、Atlassian データやアクションにシームレス、安全、柔軟にアクセスできます。

Author: sooperset


プロトコルを表示

Atlassian MCP サーバーとは？

Atlassian MCP サーバーは、Atlassian 製品（Confluence と Jira、クラウドおよびサーバー / データセンター）を AI パワーのアシスタントや開発者ツールと統合するために設計されたモデルコンテキストプロトコル (MCP) サーバーです。Jira と Confluence の機能を実行可能な関数（"ツール"）として MCP インターフェース経由で公開することで、LLM とエージェントがプログラム的に Atlassian コンテンツを自動化、検索、操作することを可能にします。このサーバーは、あなたの Atlassian インスタンスと MCP ホストアプリケーションの間の安全なブリッジとして機能します。

Atlassian MCP サーバーの設定方法

  1. 認証設定: デプロイメントタイプに基づいて、お好みの認証方法を選択します。
    • Jira/Confluence クラウド用: API トークン (推奨) または OAuth 2.0 を使用
    • サーバー / データセンター用: 個人用アクセストークン (PAT) を使用
  2. 環境変数: Atlassian の URL、トークン、その他のオプション（プロジェクト / スペースフィルター、読み取り専用モード、ログ設定など）のための環境変数を準備します。
  3. インストール: Docker イメージ（ghcr.io/sooperset/mcp-atlassian:latest）をローカル環境またはサーバーにプルします。
  4. IDE またはアシスタントでの設定:
    • IDE の MCP サーバー設定を介して環境変数を直接渡します（例: claude_desktop_config.json または Cursor の MCP 設定で）。
    • あるいは、環境ファイルを作成し、Docker の --env-file フラグを使用します。
  5. トランスポートの設定: サーバーは stdio を使用してプロセスとして実行するか、マルチユーザーまたはネットワークデプロイメント用の永続的な HTTP サービス（SSE またはストリーミング http トランスポートを使用）として実行できます。
  6. プロキシサポート: 必要に応じて、対応する環境変数を使用して HTTP(S)/SOCKS プロキシを設定します。
  7. ツール制御: ENABLED_TOOLS を使用して特定の操作へのアクセスを制限または許可し、READ_ONLY_MODE でさらにセキュリティを強化します。

Atlassian MCP サーバーの使い方

  1. サーバーを起動: Docker 経由で設定を使用してサーバーを起動します。必要に応じて有効なツール、ロギング、またはトランスポートタイプを指定します。
  2. IDE または AI アシスタント経由で接続: 適切なコマンドまたは HTTP エンドポイントを指定して、実行中のサーバーを IDE/アシスタント設定に MCP サーバーとして追加します。
  3. ツールを呼び出す: 自然言語やカスタムフローを使用してアシスタントに Jira と Confluence の操作（例: 検索、作成、更新、要約）の手助けを求めます。
  4. アクセス制御: 利用可能なツールをフィルタリングし、書き込み操作を有効化 / 無効化し、ユーザーごとまたはサーバー全体の認証を選択します。
  5. 監視とデバッグ: ログを表示し、デバッグツールを使用し、インタラクションを監視してスムーズな運用を確保します。

主要機能

  • Jira & Confluence (クラウドおよびサーバー/DC) を単一の統合でサポート
  • 実行可能なツール: Atlassian API を呼び出し可能なツールとして MCP 経由で公開し、LLM やエージェントが利用可能
  • シームレスな IDE / アシスタント統合: Claude Desktop、Cursor、類似プラットフォームで設定可能
  • マルチ認証サポート: OAuth 2.0、API トークン、PAT をサポート。単一およびマルチユーザー認証を可能にします
  • 安全なインフラ内デプロイメント: 認証情報とデータを環境内で保持
  • ツールフィルタリングと読み取り専用モード: 利用可能なアクションと権限を細かく制御
  • プロキシおよびロギングサポート: 企業向けのカスタムプロキシ、ロギング、詳細なデバッグオプションを提供
  • スケーラブルな HTTP トランスポート: 共有または自動化された使用ケースのために永続的な HTTP サービスとして実行可能

使用例

  • AI 搭載の検索: 自然言語クエリを使用してプロジェクト文書や課題を迅速に見つけて要約
  • 自動化された Jira 更新: 会議のメモやチャットコマンドに基づいて Jira 課題を作成、更新、遷移、コメント
  • ドキュメント生成: AI アシスタントや IDE から直接 Confluence ページや Jira チケットを作成、更新
  • レポートおよびフィルタリング: 緊急のバグ、ステータス更新、プロジェクトメトリクスを自動的に取得して要約
  • マルチユーザーワークフロー: 組織全体で Atlassian アクションへのアクセスを有効化し、各ユーザーの権限を尊重するためのユーザーごとのトークンを使用

よくある質問

Q: サポートされている認証方法は何ですか？
A: サーバーは Atlassian API トークン (クラウド)、個人用アクセストークン (サーバー/DC)、および OAuth 2.0 (クラウド) をサポートしています。これは高度なシナリオやマルチユーザーサポートに役立ちます。

Q: MCP サーバーがアシスタントに提供するアクションを制限できますか？
A: はい、ENABLED_TOOLS 環境変数またはコマンドラインフラグを使用して有効なツールを指定し、READ_ONLY_MODE を設定してすべての書き込み操作を無効化できます。

Q: サーバー / データセンターのデプロイメントで SSL 証明書の問題をどう扱いますか？
A: Atlassian インスタンスが自己署名証明書を使用している場合、設定で CONFLUENCE_SSL_VERIFY=false または JIRA_SSL_VERIFY=false を設定します。

Q: 各ユーザーの認証情報を持つ複数ユーザー用にサーバーを実行できますか？
A: はい、HTTP トランスポート (SSE またはストリーミング HTTP) を使用し、各クライアントがユーザー固有のトークン (クラウド用の OAuth またはサーバー / データセンター用の PAT) を提供します。

Q: アシスタントが Jira または Confluence に接続できない場合はどうしますか？
A: 認証情報、ネットワーク / プロキシ設定、URL の正確性、および Atlassian インスタンスのユーザー権限を確認してください。