Atlassian MCP Server

官方

官方 Atlassian MCP 伺服器，用於將 AI 代理連接到 Jira、Confluence、Opsgenie 及其他 Atlassian 產品。

GitHub
871

你可以用 Atlassian MCP 做什麼？

  • 搜尋並摘要 Jira、Confluence 或 Bitbucket 內容 — 讓您的 AI 使用 search 工具尋找未解決的錯誤、摘要頁面或跨專案搜尋。
  • 建立與更新 Jira 問題或 Confluence 頁面 — 透過自然語言使用 write 工具產生故事、任務或文件。
  • 查詢與管理 Compass 元件 — 使用 Compass 的 read 與 write 工具查詢服務相依性，或從您的儲存庫建立元件。
  • 從筆記或規格大量建立項目 — 將會議記錄轉換為多個 Jira 問題，或一次性從結構化資料匯入元件。
  • 連結跨產品的相關工作 — 將 Jira 票證連接到 Confluence 頁面，或擷取與 Compass 元件相關的文件。

文件

Atlassian

Atlassian Rovo MCP Server

Atlassian 的官方模型上下文協定 (MCP) 伺服器：一個雲端託管的橋接器，能讓您的 AI 工具安全、即時地存取 Jira、Confluence、Jira Service Management、Bitbucket 和 Compass。

Official Atlassian Server GitHub stars License: Apache 2.0 Status: Generally Available

Model Context Protocol compatible MCP Registry: com.atlassian Auth: OAuth 2.1 or API token Hosting: Atlassian Cloud

Jira Confluence Jira Service Management Bitbucket Compass Rovo

入門指南 · 支援的工具 · 安全性與管理 · 社群

官方 Atlassian Rovo MCP Server 是一個雲端橋接器，連接您的 Atlassian Cloud 站台與相容的外部工具。設定完成後，它就能讓這些工具即時與 Jira、Confluence、Jira Service Management、Bitbucket 和 Compass 的資料互動。驗證採用 OAuth 2.1 或 API 權杖，因此每個動作都會遵循使用者現有的存取控制。

透過 Atlassian Rovo MCP Server，您可以：

  • 摘要與搜尋 Jira、Confluence、Jira Service Management 和 Bitbucket 的內容，無需切換工具。
  • 根據自然語言指令建立和更新議題或頁面。
  • 自動化重複性工作，例如從會議記錄或規格產生工單。

專為在 IDE 或 AI 工具中工作，且希望無需不斷切換情境就能使用 Atlassian 資料的開發人員、內容創作者和專案團隊所打造。

一鍵設定

選擇下方的 AI 用戶端來安裝官方 Atlassian Rovo MCP Server。每個按鈕都使用您用戶端的原生安裝連結，因此您無需手動編輯任何 JSON 設定。

Add to Cursor
新增至 Cursor
在您的程式碼庫中參考議題並記錄工作。 		Add to VS Code
新增至 VS Code
透過 GitHub Copilot 搜尋和建立 Jira 議題。 		Add to ChatGPT
新增至 ChatGPT
直接從 ChatGPT 搜尋、摘要和建立。 		Add to Claude
新增至 Claude
將 Jira 和 Confluence 帶入 Claude 工作流程。

目錄

支援的用戶端

Atlassian Rovo MCP Server 可與越來越多的 MCP 相容用戶端搭配使用：

用戶端設定參考
OpenAI ChatGPT連接器 / MCP 指南
Claude (Claude.ai、Desktop 和 Code)Claude MCP 文件
CursorCursor 市集中的 Atlassian
Visual Studio Code (GitHub Copilot)VS Code MCP 文件
GitHub Copilot CLI關於 Copilot CLI
Google Gemini CLIGemini CLI MCP 文件
Amazon Quick SuiteMCP 整合指南

Atlassian Rovo MCP Server 也支援任何能在 localhost 上執行，並透過 mcp-remote 代理連線至伺服器的本機 MCP 相容用戶端。這可啟用遵循 MCP 規範的自訂或第三方整合。

[!TIP] 如需目前最新的支援用戶端清單和逐步設定說明，請參閱 Atlassian Rovo MCP Server 入門指南。您也可以參考用戶端本身的 MCP 文件或內建助理。

支援的產品與工具

工具按產品和意圖（讀取、寫入或搜尋）進行組織。組織管理員可在權限群組層級授予或撤銷存取權，每個工具都會繼承其父群組的存取權。

產品權限群組OAuth 2.1API 權杖
Jiraread · write · search✅✅
Confluenceread · write · search✅✅
Jira Service Managementread · write—✅（僅限）
Bitbucket Cloudread · write—✅（限定範圍，僅限）
Compassread · write✅（僅限）—
Atlassian 平台read_teamwork_graph · search_atlassian✅✅

[!NOTE] Jira Service Management 和 Bitbucket Cloud 工具僅可透過 API 權杖驗證使用，而 Compass 工具僅可透過 OAuth 2.1 使用。如需完整的最新工具參考，請參閱支援的工具。

開始之前

在設定伺服器之前，請檢查您的環境是否符合這些要求。

先決條件

需求取決於您的連線方式：

針對支援的用戶端

  • 一個包含 Jira、Confluence、Jira Service Management、Bitbucket 或 Compass 中一項或多項的 Atlassian Cloud 站台
  • 能夠存取所選的用戶端
  • 一個用於完成 OAuth 2.1 授權流程的現代瀏覽器，或用於無頭式驗證的 API 權杖憑證

針對 IDE 或本機用戶端（桌面設定）

  • 一個包含一項或多項支援產品的 Atlassian Cloud 站台
  • 一個支援的 IDE（例如 Claude Desktop、VS Code 或 Cursor）或自訂的 MCP 相容用戶端
  • 已安裝 Node.js v18+ 以執行本機 MCP 代理 (mcp-remote)
  • 一個用於完成 OAuth 登入的現代瀏覽器，或用於無頭式驗證的 API 權杖憑證

資料與安全性

伺服器強制執行多項安全控制：

  • 所有流量在傳輸過程中均根據 Atlassian 的安全實務透過 HTTPS (TLS 1.2 或更新版本) 加密。
  • OAuth 2.1 和 API 權杖驗證提供安全的存取控制。
  • 資料存取遵循 Jira、Confluence、Jira Service Management、Bitbucket 和 Compass 的使用者權限。
  • 如果您的組織對 Atlassian Cloud 產品使用 IP 允許清單，透過 Atlassian Rovo MCP Server 進行的工具呼叫也會遵守這些 IP 規則。

如需安全模型和管理員控制的深入概述，請參閱：

運作方式

架構與通訊

  1. 支援的用戶端連線至伺服器端點。大多數用戶端的建議端點為：

    https://mcp.atlassian.com/v1/mcp/authv2

    也支援 https://mcp.atlassian.com/v1/mcp 端點（例如，用於 API 權杖設定）。

  2. 根據您的設定，會觸發安全的瀏覽器型 OAuth 2.1 流程，或使用 API 權杖驗證。

  3. 授權後，用戶端會串流傳輸情境資料，並從您連線的 Atlassian 產品接收即時回應。

[!NOTE] 舊版的伺服器傳送事件端點 (https://mcp.atlassian.com/v1/sse) 仍受支援，但我們建議更新任何設定為使用 /sse 的自訂用戶端，使其現在指向 /mcp（或 /mcp/authv2）。

權限管理

僅授予使用者在 Atlassian Cloud 中已有權限檢視的資料存取權。所有動作都遵循現有的專案或空間層級角色。OAuth 和 API 權杖驗證都遵循已設定的範圍和 Atlassian 權限。

API 權杖驗證（無頭式）

API 權杖驗證適用於無頭式、服務型或非互動式用戶端設定（例如，後端系統或自動化）。這也是 Jira Service Management 和 Bitbucket Cloud 工具的必要條件。

工作流程範例

連線後，您可以從用戶端執行類似以下的工作。

Jira 工作流程

  • 搜尋：「找出 Alpha 專案中所有未解決的錯誤。」
  • 建立/更新：「建立一個標題為『重新設計入職流程』的故事。」
  • 批次建立：「從這些筆記建立五個 Jira 議題。」

Confluence 工作流程

  • 摘要：「摘要第二季規劃頁面。」
  • 建立：「建立一個標題為『第三季團隊目標』的頁面。」
  • 導覽：「我可以存取哪些空間？」

Compass 工作流程

  • 建立：「根據目前的儲存庫建立一個服務元件。」
  • 批次建立：「從這個 CSV/JSON 匯入元件和自訂欄位。」
  • 查詢：「有哪些項目相依於 api-gateway 服務？」

合併任務

  • 連結內容：「將這三張 Jira 工單連結到『發布計畫』頁面。」
  • 尋找文件：「擷取連結到此 Compass 元件的 Confluence 文件頁面。」

[!NOTE] 實際功能會因您的權限等級和用戶端平台而異。

提示與技巧

設定預設的 CloudId、Jira 專案和 Confluence 空間

使用下方的 Markdown 更新您的 AGENTS.md，以減少探索工具呼叫、節省時間和權杖，並設定最大搜尋結果數量。

## Atlassian Rovo 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 等桌面用戶端，可以為重複性任務建立或重複使用技能。查看預設的 Rovo MCP 技能。

對於 Cursor，技能是市集外掛程式的一部分。

管理員須知：管理存取權

如果您是準備讓組織使用 Atlassian Rovo MCP Server 的管理員，請檢閱以下要點。如需更詳細的管理員指南，請參閱：

安裝與存取

  • 非 Marketplace 應用程式： Atlassian Rovo MCP Server 並非 透過 Atlassian Marketplace 或 管理應用程式 畫面安裝。相反地，它會在使用者首次完成 OAuth 2.1 (3LO) 同意流程時自動安裝（即時或「延遲載入」安裝）。
  • 首次安裝需求： 為您的網站完成 3LO 同意流程的第一位使用者，必須擁有 MCP 範圍所請求的 Atlassian 應用程式存取權（例如 Jira 和/或 Confluence）。這可確保 MCP 應用程式以正確的權限為您的網站註冊。
  • 後續使用者存取： 初始安裝後，僅能存取一個 Atlassian 應用程式（例如僅 Jira 或僅 Confluence）的使用者，也可以完成 3LO 流程，透過 MCP 存取該應用程式。

管理、監控及撤銷存取權

  • 管理員控制項： 網站和組織管理員可以從管理您組織的 Marketplace 和第三方應用程式管理、審查或撤銷 MCP 應用程式的存取權。首次成功完成 3LO 同意後，該應用程式會出現在您網站的 已連結的應用程式 清單中。
  • 網域控制項： 使用 Atlassian 管理中的 Rovo MCP 伺服器 設定頁面，來控制允許哪些外部 AI 工具和網域連線。預設允許 Atlassian 支援的網域；您可以新增信任的網域或封鎖支援的網域。網域控制項適用於 OAuth 2.1 連線。詳情請參閱可用的 Atlassian Rovo MCP 伺服器網域。
  • IP 控制項： 如果您的組織對 Atlassian Cloud 應用程式使用 IP 允許清單，透過 Atlassian Rovo MCP Server 發出的請求，必須來自您組織針對相關應用程式之 IP 允許清單所允許的 IP 位址。有關設定詳情，請參閱指定產品存取的 IP 位址。
  • 終端使用者控制項： 個別使用者可以從其個人資料設定中，撤銷自己的應用程式授權。
  • 稽核記錄： 每次透過 Atlassian Rovo MCP Server 使用工具時，都會在您組織的稽核記錄中記錄一個事件。管理員可以在 Atlassian 管理的 洞察 → 稽核記錄 下檢視這些記錄（篩選 Rovo MCP 使用者動作 或搜尋 MCP）。如需更多資訊，請參閱監控 Atlassian Rovo MCP 伺服器活動。

常見問題疑難排解

  • 「您的網站管理員必須授權此應用程式」錯誤： 網站管理員必須先完成 3LO 同意流程，其他使用者才能使用 MCP 應用程式。如需更多詳細資訊，請參閱 Atlassian Cloud 應用程式中的「您的網站管理員必須授權此應用程式」錯誤。
  • 「您沒有從此 IP 位址連線的權限。請向您的管理員要求存取權。」 這通常表示已啟用 IP 允許清單，且使用者目前的 IP 位址不被允許透過 Atlassian Rovo MCP Server 存取 Jira、Confluence、Jira Service Management、Bitbucket 或 Compass。請要求您的網站或組織管理員審查 IP 允許清單設定，並在適當情況下新增相關的網路或 VPN IP 範圍。
  • 應用程式未出現在已連結的應用程式中： 確保使用者使用的是正確的 Atlassian 帳戶和網站，並確認應用程式請求的是正確的 Atlassian 應用程式範圍（例如 Jira 範圍）。如果問題持續存在，請檢查管理您組織的 Marketplace 和第三方應用程式或聯絡 Atlassian 支援。同時在 Atlassian 管理中驗證使用者的產品權限。

安全性

模型上下文協定 (MCP) 讓 AI 代理程式能使用您帳戶的權限連線到工具和 Atlassian 資料，這創造了強大的工作流程，但也帶來了結構性風險。您啟用的任何 MCP 用戶端或伺服器（例如 IDE 外掛程式、桌面應用程式、託管的 MCP 伺服器或「一鍵式」整合）都可能導致 AI 代理程式代表您執行動作。

大型語言模型 (LLM) 容易受到提示注入和相關攻擊（例如間接提示注入和工具毒化）的影響。這些攻擊可以指示代理程式在沒有明確請求的情況下洩露資料或進行非預期的變更。

為了降低風險，請僅使用信任的 MCP 用戶端和伺服器，仔細審查每個代理程式可以存取的工具和資料，並應用最小權限（限定範圍的權杖、最小的專案/工作區存取權）。對於任何高影響力或破壞性的動作，要求人為確認，並監控稽核記錄中是否有異常活動。我們強烈建議您在 MCP 用戶端：了解潛在的安全風險 中檢閱 Atlassian 關於 MCP 風險的指引。

支援與意見回饋

我們使用您的意見回饋來改進 Atlassian Rovo MCP Server。如果您遇到錯誤或限制，或有任何建議：

免責聲明

MCP 用戶端可以使用您現有的權限，在 Jira、Confluence、Jira Service Management、Bitbucket 和 Compass 中執行動作。請使用最小權限，在確認前審查高影響力的變更，並監控稽核記錄中是否有異常活動。

了解更多：MCP 用戶端：了解潛在的安全風險。