Atlassian MCP Server
公式Atlassian製品のJira、Confluence、OpsgenieなどにAIエージェントを接続するための公式Atlassian MCPサーバー。
Atlassian MCPで何ができますか?
- Atlassian製品を横断して検索 — ツールを切り替えることなく、アシスタントにJira課題、Confluenceページ、Bitbucketリポジトリ、またはProjectsを検索させることができます。
- 作業項目の作成と更新 — 自然言語でアシスタントにJiraストーリーの作成、課題の更新、またはConfluenceページの生成を指示できます。
- コンテンツの要約と取得 — アシスタントにConfluenceページ、Loom録画、またはJira Service Managementリクエストを要約させることができます。
- 反復的なワークフローの自動化 — アシスタントに会議メモからJira課題を一括作成させたり、作業項目を関連ドキュメントにリンクさせたりできます。
- プロジェクトと目標のステータスを照会 — AIクライアント内でProjects、Goals、またはCompassコンポーネントの依存関係に関するリアルタイムの更新を取得できます。
ホスト型 MCP サーバー
npx add-mcp 'https://mcp.atlassian.com/v1/mcp/authv2'Claude Code、Codex、Cursor などにインストールできます
ドキュメント
Atlassian MCP Server
Atlassian公式のModel Context Protocol(MCP)サーバー:クラウドホスト型のブリッジで、AIツールにJira、Confluence、Jira Service Management、Bitbucket、Compass、Loom、そしてAtlassianプラットフォーム全体への安全でリアルタイムなアクセスを提供します。Teamwork Graphを搭載しています。
はじめに · サポート対象ツール · セキュリティと管理 · コミュニティ
公式Atlassian MCP Serverは、Atlassian Cloudサイトと互換性のある外部ツールを結ぶクラウドベースのブリッジです。設定後、これらのツールはJira、Confluence、Jira Service Management、Bitbucket、Compass、Loom、およびAtlassianプラットフォームデータ(Projects、Goals、Teams、Focus、Talent、Teamwork Graph)とリアルタイムに連携できます。認証にはOAuth 2.1またはAPIトークンを使用するため、すべての操作はユーザーの既存のアクセス制御を尊重します。
Atlassian MCP Serverを使用すると、次のことが可能です:
- 要約と検索:ツールを切り替えることなく、Jira、Jira Service Management、Confluence、Bitbucket、Projects、Goalsなどを検索・要約できます。
- 取得と確認:Loomのビデオやミーティングの録画を取得・確認できます。
- 作成と更新:自然言語コマンドに基づいて、作業項目やページを作成・更新できます。
- 反復作業の自動化:ミーティングノートや仕様書から作業項目を生成するなどの作業を自動化できます。
一度接続すれば、あとはやりたいことを説明するだけです。タブの切り替えやコピー&ペーストは不要です。AIが適切なアクションを選択して実行します。
IDEやAIツールで作業し、コンテキストを切り替えずにAtlassianデータを活用したい開発者、コンテンツクリエイター、プロジェクトチーム向けに設計されています。
[!IMPORTANT] v2が推奨バージョンになりました。 新規セットアップでは
https://mcp.atlassian.com/v2/mcpを使用してください。これにより、より多くのツールと製品が利用可能になります。既存のv1接続は自動的にv2ツールを公開・使用し始めます。互換性のないクライアントは、認証を継続するためにキャッシュされたクライアントIDまたは.well-knownの認証情報をクリアする必要がある場合があります。セットアップ手順については、Atlassian MCP Server入門を参照してください。
ワンクリックセットアップ
以下のAIクライアントを選択して、公式Atlassian MCP Serverをインストールしてください。各ボタンはクライアントのネイティブなインストールリンクを使用するため、JSON設定を手動で編集する必要はありません。
|
Cursorに追加 コードベースで課題を参照し、作業ログを記録します。 |
VS Codeに追加 GitHub CopilotでJira課題を検索・作成します。 |
ChatGPTに追加 ChatGPTから直接検索、要約、作成ができます。 |
Claudeに追加 JiraとConfluenceをClaudeワークフローに統合します。 |
エージェントにセットアップを任せる
ほとんどのAIコーディングエージェントは、サーバーのインストール、認証、設定を自分で行えます。以下のプロンプトをコピーしてエージェントに貼り付けてください:
Set up Atlassian MCP for this agent using the official setup guide at
https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/
and the MCP server URL https://mcp.atlassian.com/v2/mcp. Then start the Atlassian MCP
authentication flow so I can sign in.
または、クライアント独自のコマンドでサーバーを手動で追加することもできます:
| クライアント | コマンドまたは設定 |
|---|---|
| Claude Code | claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp、その後セッションで/mcpを実行して認証 |
| Codex | codex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp |
| Claude Desktop | 設定 → 拡張機能 → 拡張機能を参照 → プラグイン、次にAtlassianを検索 |
| Codex Desktop | プラグインまたはコネクタ、次にAtlassian Rovoをインストール |
| VS Code / GitHub Copilot | 拡張機能ビュー → @mcp Atlassianを検索 → インストール |
| Cursor | Cursor用Atlassianプラグイン(MCP対応) → Cursorに追加 |
| Windsurf | Cascade → MCPサーバー → サーバーを追加 → カスタムサーバーを追加、serverUrlをhttps://mcp.atlassian.com/v2/mcpに設定 |
| その他のMCPクライアント | サーバーURL https://mcp.atlassian.com/v2/mcpを使用 |
目次
- ワンクリックセットアップ
- サポート対象クライアント
- プラグインパッケージと互換性
- サポート対象製品とツール
- サーバーによるツールの公開方法
- MCPゲートウェイ
- 開始前の確認
- データとセキュリティ
- 仕組み
- ワークフロー例
- ヒントとコツ
- 管理者メモ:アクセス管理
- セキュリティ
- サポートとフィードバック
- 免責事項
サポート対象クライアント
Atlassian MCP Serverは、増え続けるMCP互換クライアントで動作します:
| クライアント | セットアップ参照 |
|---|---|
| OpenAI ChatGPT | Connectors / MCPガイド |
| OpenAI Codex(CLIおよびDesktop) | Codex MCPドキュメント |
| Claude(Claude.ai、Desktop、Code) | Claude MCPドキュメント |
| Cursor | CursorマーケットプレイスのAtlassian |
| Visual Studio Code(GitHub Copilot) | VS Code MCPドキュメント |
| GitHub Copilot CLI | Copilot CLIについて |
| Google Gemini CLI | Gemini CLI MCPドキュメント |
| Windsurf | Windsurf MCPドキュメント |
| Docker | Docker MCPカタログとツールキット |
| Kiroおよびその他のAgent Pluginsクライアント | Kiro Powersドキュメント |
| Amazon Quick Suite | MCP統合ガイド |
Atlassian MCP Serverは、localhostで実行でき、mcp-remoteプロキシを介してサーバーに接続できる、ローカルMCP互換クライアントもサポートしています。これにより、MCP仕様に従ったカスタムまたはサードパーティの統合が可能になります。
[!TIP] サポート対象クライアントの最新の正規リストとステップバイステップのセットアップについては、Atlassian MCP Server入門を参照してください。また、クライアント独自のMCPドキュメントや組み込みアシスタントも参照できます。
プラグインパッケージと互換性
このリポジトリは、同じMCPサーバーとスキルを複数のパッケージ形式で公開しているため、クライアントはネイティブな検出およびインストールフローを使用できます:
| 形式 | マニフェストと設定 | 共有コンポーネント |
|---|---|---|
| Agent Plugins v1 | plugin.jsonおよびmcp.json | skills/ |
| Claude Codeプラグイン | .claude-plugin/plugin.jsonおよび.claude-plugin/marketplace.json | .mcp.jsonおよびskills/ |
| Cursorプラグイン | .cursor-plugin/plugin.json | .mcp.jsonおよびskills/ |
| Gemini拡張機能 | gemini-extension.json | マニフェストに埋め込まれたMCPサーバー設定 |
| MCPレジストリ | server.json | リモートサーバーメタデータ |
skills/内のスキルは/v2/mcpエンドポイントを対象としており、すべてのパッケージ化されたプラグインがインストールするものです。以前の世代はskills/v1/にアーカイブされており、v1エンドポイントをまだ使用しているユーザー向けです。これはどのプラグインでもインストールされず、手動で設定されます。違いについてはskills/README.mdを参照してください。
mcp.jsonと.mcp.jsonはどちらも意図的なものです。Agent Pluginsはルートのmcp.jsonファイル名とそのポータブルなトランスポート語彙を必要とします。既存のクライアントは.mcp.jsonとネイティブな設定語彙を引き続き使用します。どちらかのファイルを変更する場合は、エンドポイント設定を一致させてください。
ルートパッケージは、Kiro Powersを含むAgent Pluginsを実装するクライアントがインポートできます。クライアント固有のマニフェストは引き続き利用可能であり、ポータブルパッケージに置き換えられることはありません。
サポート対象製品とツール
ツールは製品と目的(読み取り、書き込み、検索、削除、管理)ごとに整理されています。組織管理者は権限グループレベルでアクセスを許可または取り消し、各ツールは親グループのアクセスを継承します。
| 製品 | 権限グループ | OAuth 2.1 | APIトークン |
|---|---|---|---|
| Jira | read_jira · write_jira · search_jira | ✅ | ✅ |
| Jira(管理者有効) | delete_jira · manage_jira | ✅ | ✅ |
| Confluence | read_confluence · write_confluence · search_confluence | ✅ | ✅ |
| Bitbucket Cloud | read_bitbucket · write_bitbucket | ✅ | ✅ |
| Jira Service Management | read_jsm · write_jsm | — | ✅(のみ) |
| Atlassianプラットフォーム | read_teamwork_graph · write_teamwork_graph · search_atlassian | ✅ | ✅ |
| Loom | read_loom · write_loom | ✅ | ✅ |
| Goals | read_goals · write_goals | ✅ | ✅ |
| Projects | read_projects · write_projects | ✅ | ✅ |
| Teams | read_teams · write_teams | ✅ | ✅ |
| Focus | read_focus · write_focus | ✅ | ✅ |
| Talent | read_talent · write_talent | ✅ | ✅ |
| Compass | read_compass · write_compass | ✅(のみ) | — |
製品固有の条件:
delete_jiraとmanage_jiraはデフォルトでは無効であり、管理者が有効化するまで使用できません。- Bitbucket Cloud ツールは、Bitbucket ワークスペースが組織にリンクされている場合にのみ利用できます。組織にリンクされていないワークスペースは、認証時に選択できません。
- Jira Service Management ツールは API トークンによる認証のみをサポートしており、組織管理者が API トークン認証を有効にしている場合にのみ利用できます。
- Loom ツールは、Atlassian サイトにリンクされた Loom ワークスペースでのみ利用できます。
- Teamwork Graph ツールは、リンクされたプルリクエスト、ビルド、デプロイなど、Jira に接続されたサードパーティサービスからデータを取得できます。GitHub for Atlassian の場合、フルアクセス はユーザーの GitHub 権限に基づいて GitHub データを取得することを意味し、制限付きアクセス はユーザーの Jira 権限に基づいてデータを取得することを意味します。Azure DevOps、GitLab、Jenkins、Spinnaker コネクタは制限付きアクセスモデルに従います。
[!NOTE] 各権限グループに必要なスコープを含む、完全で最新のツールリファレンスについては、サポートされているツール を参照してください。
サーバーがツールを公開する方法
Atlassian MCP Server は、接続時にすべてのツール定義を AI クライアントに送信するのではなく、最も使用頻度の高いツールの小さなセットを公開し、残りはクライアントが必要に応じて検出できるようにします。Primary とマークされたツールは、エージェントに直接表示されます。
これには 2 つの利点があります:
- クライアントのコンテキストは、ツール定義で埋め尽くされる代わりに、目の前のタスクのために空いたままになります。
- クライアントが再接続しなくても、新しいツールが利用可能になります。
MCP ゲートウェイ
MCP ゲートウェイを使用している場合、または検出および実行メソッドを使用する代わりにすべてのツールを事前に利用可能にする必要がある場合は、tools=all オーバーライドを使用して、すべてのツールをページ分割されたフラットなツールリストとして公開します:
https://mcp.atlassian.com/v2/mcp?tools=all
開始する前に
サーバーをセットアップする前に、環境が次の要件を満たしていることを確認してください。
前提条件
要件は接続方法によって異なります:
サポートされているクライアント向け
- Jira、Confluence、Jira Service Management、Bitbucket、Compass のいずれか 1 つ以上を備えた Atlassian Cloud サイト
- 選択したクライアントへのアクセス
- OAuth 2.1 認証フローを完了するための最新のブラウザ、またはヘッドレス認証用の API トークン資格情報
組織管理者が API トークンによる認証を無効にしている場合、MCP クライアントはトークンで接続できず、代わりに OAuth 2.1 を使用する必要があります。
IDE またはローカルクライアント向け (デスクトップセットアップ)
- 1 つ以上のサポートされている製品を備えた Atlassian Cloud サイト
- サポートされている IDE (例: Claude Desktop、VS Code、Cursor) またはカスタムの MCP 互換クライアント
- ローカル MCP プロキシを実行するための Node.js v18+ がインストールされている (
mcp-remote) - OAuth ログインを完了するための最新のブラウザ、またはヘッドレス認証用の API トークン資格情報
データとセキュリティ
サーバーはいくつかのセキュリティ制御を実施します:
- すべてのトラフィックは、Atlassian のセキュリティ慣行 に従って、HTTPS (TLS 1.2 以降) で転送中に暗号化されます。
- OAuth 2.1 および API トークン認証は、安全なアクセス制御を提供します。
- データアクセスは、Jira、Confluence、Jira Service Management、Bitbucket、Compass、Loom を含む、接続されたすべての Atlassian 製品にわたってユーザー権限を尊重します。
- 組織が Atlassian Cloud 製品に IP 許可リストを使用している場合、Atlassian MCP Server を介して行われたツール呼び出しもこれらの IP ルールに従います。
セキュリティモデルと管理者制御の詳細な概要については、以下を参照してください:
仕組み
アーキテクチャと通信
-
サポートされているクライアントがサーバーエンドポイントに接続します。すべてのクライアントに推奨されるエンドポイントは次のとおりです:
https://mcp.atlassian.com/v2/mcpv1 エンドポイント (
https://mcp.atlassian.com/v1/mcp/authv2およびhttps://mcp.atlassian.com/v1/mcp) は引き続きサポートされており、既存の v1 接続は自動的に v2 ツールを公開して使用し始めます。 -
セットアップに応じて、安全なブラウザベースの OAuth 2.1 フローがトリガーされるか、API トークン認証が使用されます。
-
承認されると、クライアントはコンテキストデータをストリーミングし、接続された Atlassian 製品からリアルタイムの応答を受け取ります。
[!WARNING] 2026 年 6 月 30 日以降、レガシーの Server-Sent Events エンドポイント (
https://mcp.atlassian.com/v1/sse) はサポートされなくなります。/sseを使用するように構成されたカスタムクライアントを更新して、/mcp— できればhttps://mcp.atlassian.com/v2/mcpを指すようにしてください。
[!NOTE] v2 ツールへの移行後に認証を完了できないクライアントは、キャッシュされたクライアント ID または
.well-known資格情報をクリアする必要がある場合があります。
権限管理
アクセスは、ユーザーが Atlassian Cloud で表示する権限をすでに持っているデータにのみ付与されます。すべてのアクションは、既存のプロジェクトまたはスペースレベルのロールを尊重します。OAuth と API トークン認証はどちらも、構成されたスコープと Atlassian 権限を尊重します。
API トークン認証 (ヘッドレス)
API トークン認証は、ヘッドレス、サービススタイル、または非対話型のクライアントセットアップ (例: バックエンドシステムや自動化) で利用できます。また、Jira Service Management ツールでは必須です。
2 つのメカニズムがサポートされています:
| メカニズム | ヘッダー |
|---|---|
| 個人用 API トークン (Basic 認証) | Authorization: Basic <base64(email:api_token)> |
| サービスアカウント API キー (Bearer トークン) | Authorization: Bearer <api_key> |
- 管理者による有効化が必要: 組織管理者は、Atlassian MCP Server の API トークン認証を有効にする必要があります (Atlassian Administration → Rovo → Rovo MCP server → Authentication)。
- スコープ付きトークンが必要: アクセスする必要があるツールとデータに必要なスコープを持つ個人用 API トークンを作成するか、管理者にサービスアカウント API キーを依頼してください。
- 構成ガイド: API トークンによる認証の構成
- 管理者設定リファレンス: Atlassian MCP Server 設定の制御: 認証の構成
ワークフローの例
接続すると、クライアントから次のようなタスクを実行できます。
Jira ワークフロー
- 検索: 「Project Alpha のすべてのオープンバグを検索してください。」
- 作成/更新: 「'オンボーディングの再設計' というタイトルのストーリーを作成してください。」
- 一括作成: 「これらのメモから 5 つの Jira 課題を作成してください。」
Confluence ワークフロー
- 要約: 「Q2 計画ページを要約してください。」
- 作成: 「'Team Goals Q3' というタイトルのページを作成してください。」
- ナビゲート: 「アクセスできるスペースは何ですか?」
Compass ワークフロー
- 作成: 「現在のリポジトリに基づいてサービスコンポーネントを作成してください。」
- 一括作成: 「この CSV/JSON からコンポーネントとカスタムフィールドをインポートしてください。」
- クエリ: 「
api-gatewayサービスに依存しているものは何ですか?」
Loom ワークフロー
- 取得: 「先週のデザインレビューの Loom 録画を見つけてください。」
- 要約: 「この Loom ウォークスルーを要約し、アクション項目をリストしてください。」
Projects and Goals ワークフロー
- ステータス: 「Checkout Revamp プロジェクトの現在のステータスは何ですか?」
- ロールアップ: 「今四半期、リスクのある目標はどれですか、そしてその理由は?」
複合タスク
- コンテンツのリンク: 「これらの 3 つの Jira 作業項目を 'リリース計画' ページにリンクしてください。」
- ドキュメントの検索: 「この Compass コンポーネントにリンクされている Confluence ドキュメントページを取得してください。」
- 作業の前進: 「PROJ-456 を 'レビュー中' に移動し、PR が上がっているというコメントを追加してください。」
[!NOTE] 実際の機能は、権限レベルとクライアントプラットフォームによって異なります。
ヒントとコツ
デフォルトの CloudId、Jira プロジェクト、Confluence スペースを設定する
AGENTS.md を以下の Markdown で更新して、検出ツールの呼び出しを減らし、時間とトークンを節約し、最大検索結果を設定します。
## Atlassian MCP
When connected to atlassian-rovo-mcp:
- **MUST** use Jira project key = YOURPROJ
- **MUST** use Confluence spaceId = "123456"
- **MUST** use cloudId = "https://yoursite.atlassian.net" (do NOT call getAccessibleAtlassianResources)
- **MUST** use `maxResults: 10` or `limit: 10` for ALL Jira JQL and Confluence CQL search operations.
スキルを使用する
Claude などのデスクトップクライアントを使用している場合は、繰り返しのタスク用にスキルを作成または再利用できます。デフォルトの Atlassian MCP スキルを参照してください。
Cursor の場合、スキルはマーケットプレイスプラグインの一部です。
管理者メモ: アクセスの管理
組織で Atlassian MCP Server を使用する準備をしている管理者の場合は、以下の点を確認してください。より詳細な管理者ガイダンスについては、以下を参照してください:
- Atlassian MCP Server について
- Atlassian MCP Server 設定の制御
- Atlassian MCP Server の管理
- Atlassian MCP Server アクティビティの監視
アクセスの管理、監視、取り消し
- 管理者コントロール: サイトおよび組織管理者は、組織の Marketplace およびサードパーティアプリの管理 から MCP アプリのアクセスを管理、確認、または取り消すことができます。
- ドメインコントロール: Atlassian Administration の Rovo MCP server 設定ページを使用して、接続を許可する外部 AI ツールとドメインを制御します。デフォルトでは、Atlassian がサポートするドメインが許可されています。信頼できるドメインを追加したり、サポートされているドメインをブロックしたりできます。ドメインコントロールは OAuth 2.1 接続に適用されます。詳細については、利用可能な Atlassian MCP サーバードメイン を参照してください。
- IP コントロール: 組織が Atlassian Cloud アプリに IP 許可リストを使用している場合、Atlassian MCP Server を介して行われたリクエストは、関連するアプリの組織の IP 許可リストで許可された IP アドレスから発信される必要があります。構成の詳細については、製品アクセスの IP アドレスの指定 を参照してください。 Bitbucket Cloud の IP 制限は、ワークスペース管理者が Workspace settings → Access controls で個別に構成します。ワークスペース内のプライベートコンテンツへのアクセスの制御 を参照してください。
- エンドユーザーコントロール: 個々のユーザーは、プロファイル設定から自分のアプリ認証を取り消すことができます。
- 監査ログ: Atlassian MCP Server を介してツールが使用されるたびに、組織の監査ログにイベントが記録されます。管理者は、Atlassian Administration の Insights → Audit log でこれらを確認できます (Rovo MCP User Actions でフィルタリングするか、MCP を検索してください)。詳細については、Atlassian MCP サーバーアクティビティの監視 を参照してください。
一般的な問題のトラブルシューティング
-
「この IP アドレスから接続する権限がありません。アクセスについては管理者に問い合わせてください。」 これは通常、IP 許可リストが有効になっており、リクエストの送信元 IP アドレスが Atlassian MCP Server を介して関連アプリにアクセスすることを許可されていないことを示します。サイト、組織、または Bitbucket ワークスペースの管理者に、該当する IP 許可リストの確認を依頼してください。
ホスト型 AI クライアントは、ユーザーの企業ネットワークや VPN ではなく、AI プロバイダーの送信 IP アドレスからリクエストを送信できます。したがって、許可された VPN に接続しているだけでは不十分な場合があります。管理者に、プロバイダーの公開済み送信 IP 範囲を確認し、必要なアクセスを承認するよう依頼してください。OpenAI ホスト型コネクタについては、OpenAI の IP 出力ガイダンス を参照してください。ローカル MCP 接続は、ローカルネットワークの送信 IP アドレスを使用できます。IP 許可リストが Atlassian MCP でどのように機能するか を参照してください。
-
OAuth サインインは成功するが、ツール呼び出しが 403 を返す。 サインインが成功しても、ツール呼び出しが IP 制限を通過するとは限りません。403 は、スコープ、アプリ権限、またはその他のアクセスポリシーが不十分であることを示す場合もあります。IP 許可リストを変更する前に、拒否の理由を確認してください。
セキュリティ
Model Context Protocol (MCP) を使用すると、AI エージェントはアカウントの権限を使用してツールと Atlassian データに接続できるため、強力なワークフローが作成されますが、構造的なリスクも生じます。有効にする MCP クライアントまたはサーバー (例: IDE プラグイン、デスクトップアプリ、ホスト型 MCP サーバー、または「ワンクリック」統合) は、AI エージェントに代わってアクションを実行させる可能性があります。
大規模言語モデル (LLM) は、プロンプトインジェクション および関連する攻撃 (間接プロンプトインジェクションや ツールポイズニング など) に対して脆弱です。これらの攻撃は、明示的なリクエストなしに、エージェントにデータを外部送信させたり、意図しない変更を加えさせたりする可能性があります。 リスクを軽減するため、信頼できるMCPクライアントとサーバーのみを使用し、各エージェントがアクセスできるツールとデータを慎重に確認し、最小権限(スコープ付きトークン、最小限のプロジェクト/ワークスペースアクセス)を適用してください。影響が大きい操作や破壊的な操作には、人間の確認を必須とし、監査ログで異常なアクティビティを監視してください。AtlassianのMCPリスクに関するガイダンスを確認することを強くお勧めします: MCPクライアント: 潜在的なセキュリティリスクを理解する。
サポートとフィードバック
私たちは、Atlassian MCP Serverを改善するために皆様のフィードバックを活用しています。バグや制限に遭遇した場合、または提案がある場合は、以下をご利用ください:
- Atlassianサポートポータルで問題や機能リクエストを報告してください。
- Atlassianコミュニティで経験や質問を共有し、開発者関連の質問はAtlassianデベロッパーコミュニティで行ってください。
- アプリを構築中にバグや問題を発見した場合、または提案がある場合は、エコシステムデベロッパーポータルにアクセスしてください。
免責事項
MCPクライアントは、既存の権限を使用してAtlassian製品全体でアクションを実行できます。最小権限を使用し、確認前に影響の大きい変更をレビューし、監査ログで異常なアクティビティを監視してください。