Atlassian MCP Server

Atlassian MCP Server

Atlassian MCP 伺服器是一個開源的標準化整合伺服器，可以將 AI 助手和 IDE 連接到 Atlassian 產品，如 Jira 和 Confluence，使得通過與 MCP 兼容的應用程序，能無縫、安全和靈活地訪問 Atlassian 數據和操作。

Author: sooperset


查看協議

什麼是 Atlassian MCP 伺服器？

Atlassian MCP 伺服器是一個模型上下文協議 (MCP) 伺服器，旨在整合 Atlassian 產品 (Confluence 和 Jira，均支持 Cloud 和 Server/Data Center) 與 AI 驅動的助手和開發者工具。通過將 Jira 和 Confluence 的功能以可執行的函數（"工具"）形式暴露於 MCP 接口，它允許 LLM 和代理以編程方式自動化、搜索和互動 Atlassian 內容。它作為你的 Atlassian 實例和 MCP 托管應用之間的安全橋樑。

如何配置 Atlassian MCP 伺服器

  1. 身份驗證設置：根據部署類型選擇你喜歡的身份驗證方法：
    • 對於 Jira/Confluence Cloud：使用 API 令牌（推薦）或 OAuth 2.0
    • 對於 Server/Data Center：使用個人訪問令牌 (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 助手連接：在你的 IDE/助手設置中添加運行中的伺服器，提供適當的命令或 HTTP 端點。
  3. 調用工具：使用自然語言或自定義流來請求助手幫助進行 Jira 和 Confluence 的操作（例如：搜索、創建、更新、總結）。
  4. 控制訪問：過濾可用工具，啟用/禁用寫入操作，根據需要選擇每位用戶或全伺服器的身份驗證。
  5. 監視和調試：查看日誌，使用調試工具，監控互動以確保平穩運行。

主要特點

  • 支持 Jira 和 Confluence（Cloud 和 Server/DC），提供單一整合
  • 可執行工具：通過 MCP 將 Atlassian API 暴露為可調用的工具供 LLM 和代理使用
  • 無縫 IDE/助手整合：可在 Claude Desktop、Cursor 和類似平台中配置
  • 多身份驗證支持：支持 OAuth 2.0、API 令牌和 PAT，支持單用戶和多用戶身份驗證
  • 安全的內部部署：保持憑證和數據在你的環境內
  • 工具篩選和只讀模式：對可用行動和權限進行細粒度控制
  • 代理和日誌支持：企業級準備，具備定制代理、日誌和詳細調試選項
  • 可擴展的 HTTP 傳輸：可以作為持久的 HTTP 服務運行以支持共享或自動化用例

使用案例

  • AI 驅動的搜索：使用自然語言查詢迅速查找和總結項目文檔和問題
  • 自動化 Jira 更新：根據會議記錄或聊天命令創建、更新、轉換和評論 Jira 問題
  • 文檔生成：直接從你的 AI 助手或 IDE 創建和更新 Confluence 頁面或 Jira 工單
  • 報告和過濾：自動提取和總結緊急錯誤、狀態更新和項目指標
  • 多用戶工作流：為整個組織啟用對 Atlassian 操作的訪問，尊重每位用戶的權限，使用每用戶令牌

常見問題

問：支持哪些身份驗證方法？
答：伺服器支持 Atlassian API 令牌（Cloud）、個人訪問令牌（Server/DC）和 OAuth 2.0（Cloud，用於高級場景和多用戶支持）。

問：我可以限制 MCP 伺服器向我的助手提供哪些操作嗎？
答：可以，您可以通過 ENABLED_TOOLS 環境變數或命令行標誌來指定可用的工具，並設置 READ_ONLY_MODE 來禁用所有寫入操作。

問：我該如何處理 Server/Data Center 部署上的 SSL 證書問題？
答：如果你的 Atlassian 實例使用自簽證書，請在配置中設置 CONFLUENCE_SSL_VERIFY=false 或 JIRA_SSL_VERIFY=false。

問：可以為多個用戶使用各自的憑證運行伺服器嗎？
答：可以，使用 HTTP 傳輸（SSE 或可流式傳輸的 HTTP）並讓每個客戶端提供用戶特定的令牌（Cloud 用 OAuth 或 Server/DC 用 PAT）。

問：如果我的助手無法連接到 Jira 或 Confluence，該怎麼辦？
答：檢查身份驗證憑證、網絡/代理設置、URL 準確性和在 Atlassian 實例中的用戶權限。