MCP Atlassian Fcr

MCP Atlassian是一個為Atlassian產品（Confluence和Jira）提供模型上下文協議服務的集成工具，支持雲版和服務器/數據中心版部署，可實現內容搜索、頁面管理、問題跟蹤等功能。

知識管理與記憶開發者工具 #Atlassian集成 #團隊協作 #項目管理 #知識管理

評分 : 2分

下載量 : 11

更新時間 : 2025-04-23

什麼是MCP Atlassian?

MCP Atlassian 是一個集成模型上下文協議（MCP）的服務器，支持Confluence和Jira的雲和本地部署。它可以幫助用戶高效地管理和搜索企業知識庫及任務。

如何使用MCP Atlassian?

通過配置服務器連接到Confluence和Jira後，您可以搜索、創建、更新和刪除內容，以及管理任務和項目。

適用場景

適用於需要高效管理企業知識庫和任務的企業團隊，特別是那些使用Confluence和Jira進行協作的團隊。

主要功能

Confluence搜索通過CQL查詢搜索Confluence空間中的內容。

Jira任務管理支持創建、更新、刪除Jira任務，並管理任務狀態和工作日誌。

多傳輸模式支持標準輸入輸出（stdio）和服務器發送事件（SSE）兩種傳輸模式。

優勢與侷限性

優勢

支持Confluence和Jira的雲和本地部署。

提供多種查詢和操作工具，提高工作效率。

支持靈活的傳輸模式選擇。

侷限性

需要配置API密鑰，可能涉及安全風險。

對大規模數據的處理速度可能較慢。

如何使用

安裝MCP Atlassian

通過pip安裝或使用Docker鏡像啟動服務器。

配置服務器

設置Confluence和Jira的URL、用戶名和API密鑰。

開始使用

通過MCP客戶端連接服務器並執行查詢。

使用案例

搜索Confluence文檔查找特定開發空間中的文檔。

管理Jira任務更新一個Jira任務的狀態並添加備註。

常見問題

如何生成API密鑰？

是否支持本地部署？

如何切換傳輸模式？

相關資源

官方文檔

詳細的MCP Atlassian使用指南。

GitHub倉庫

源代碼和示例代碼。

安裝教程視頻

快速上手視頻。

安裝

複製以下命令到你的Client進行配置

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://confluence.your-company.com",
        "--confluence-personal-token=your_token",
        "--jira-url=https://jira.your-company.com",
        "--jira-personal-token=your_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://confluence.your-company.com",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_password"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "mcp-atlassian",
      "args": [
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/path/to/your/.env",
        "mcp/atlassian"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian-sse": {
      "url": "http://localhost:9000/sse"
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/your/mcp-atlassian",
        "run", "mcp-atlassian",
        "--confluence-url=https://your-domain.atlassian.net/wiki",
        "--confluence-username=your.email@domain.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-domain.atlassian.net",
        "--jira-username=your.email@domain.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

注意：您的密鑰屬於敏感信息，請勿與任何人分享。

🚀 MCP 協議（Claude）

MCP 協議（Claude）是用於與 Atlassian 產品（如 Confluence 和 Jira）進行交互的工具。它提供了一系列功能，包括安裝運行、配置服務器、資源訪問、工具集使用等，能幫助用戶高效地操作 Atlassian 相關服務。

🚀 快速開始

📦 安裝指南

使用 npm 包

npm install @modelcontextprotocol/mcp-atlassian
npx @modelcontextprotocol/mcp-atlassian

從源碼運行

git clone git@github.com:claude-mcp/mcp-atlassian.git
cd mcp-atlassian
npm install
node index.js

🔧 配置 MCP 服務器

使用包方式配置

在 ~/.cursor/mcp.json 中添加以下內容：

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "--directory",
        "/path/to/@modelcontextprotocol/mcp-atlassian",
        "run",
        "mcp-atlassian",
        "--confluence-url",
        "https://your-domain.atlassian.net/wiki",
        "--confluence-username",
        "your.email@domain.com",
        "--confluence-token",
        "your_api_token",
        "--jira-url",
        "https://your-domain.atlassian.net",
        "--jira-username",
        "your.email@domain.com",
        "--jira-token",
        "your_api_token"
      ]
    }
  }
}

使用 Docker 運行

FROM node:16
WORKDIR /app
COPY package*.json ./
RUN npm install @modelcontextprotocol/mcp-atlassian
CMD ["npx", "@modelcontextprotocol/mcp-atlassian"]

💻 使用示例

基礎用法

資源訪問

⚠️ 重要提示

MCP 服務器會根據用戶當前交互的 Confluence 空間和 Jira 項目進行過濾，僅顯示用戶有權限操作的內容。

confluence://{space_key}: 訪問特定的 Confluence 空間
jira://{project_key}: 訪問特定的 Jira 項目

工具集使用

工具	描述
`confluence_search`	使用 CQL 搜索 Confluence 內容
`confluence_get_page`	獲取特定 Confluence 頁面的內容
`confluence_get_page_children`	獲取特定頁面的子頁面
`confluence_get_page_ancestors`	獲取特定頁面的父頁面
`confluence_get_comments`	獲取特定頁面上的評論
`confluence_create_page`	創建新的 Confluence 頁面
`confluence_update_page`	更新現有 Confluence 頁面
`confluence_delete_page`	刪除現有 Confluence 頁面
`confluence_attach_content`	將內容附件到 Confluence 頁面上
`jira_get_issue`	獲取特定 Jira 問題的詳細信息
`jira_search`	使用 JQL 搜索 Jira 問題
`jira_get_project_issues`	獲取特定項目的全部 Jira 問題
`jira_get_epic_issues`	獲取與特定史詩相關聯的所有 Jira 問題
`jira_create_issue`	在 Jira 中創建新的問題
`jira_update_issue`	更新現有的 Jira 問題
`jira_delete_issue`	刪除現有的 Jira 問題
`jira_get_transitions`	獲取特定問題的過渡選項
`jira_get_boards`	獲取所有看板列表
`jira_get_board_columns`	獲取特定看板的列信息
`jira_search_issues`	使用查詢搜索 Jira 問題

高級用法

開發與調試

配置 MCP 服務器（開發模式）

在 ~/.cursor/mcp.json 中添加以下內容：

{
  "mcpServers": {
    "development": {
      "command": "npm",
      "args": ["run", "dev"],
      "options": {
        "cwd": "/path/to/@modelcontextprotocol/mcp-atlassian"
      }
    }
  }
}

示例代碼

const { MCPClient } = require('@modelcontextprotocol/mcp');
const client = new MCPClient('mcp-atlassian');

client.confluence_search(query => {
  return {
    title: query.title,
    content: query.content,
    comments: query.comments
  };
});