MCP Atlassian

用于 Atlassian 产品（Confluence 和 Jira）的模型上下文协议 (MCP) 服务器。此集成支持 Confluence 和 Jira Cloud 以及 Server/Data Center 部署。

功能演示

<details> <summary>Confluence 演示</summary>

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

</details>

兼容性

产品	部署类型	支持状态
Confluence	Cloud	✅ 完全支持
Confluence	Server/Data Center	✅ 支持 (版本 6.0+)
Jira	Cloud	✅ 完全支持
Jira	Server/Data Center	✅ 支持 (版本 8.14+)

安装指南

1. 身份验证设置

首先，为 Confluence 和 Jira 生成必要的身份验证令牌：

对于 Cloud

1. 前往 https://id.atlassian.com/manage-profile/security/api-tokens
2. 点击 创建 API 令牌，命名它
3. 立即复制令牌

对于 Server/Data Center

1. 前往您的个人资料（头像）→ 个人资料 → 个人访问令牌
2. 点击 创建令牌，命名它，设置过期时间
3. 立即复制令牌

2. 安装

选择以下安装方法之一：

# 使用 uv (推荐)
brew install uv
uvx mcp-atlassian

# 使用 pip
pip install mcp-atlassian

# 使用 Docker
git clone https://github.com/sooperset/mcp-atlassian.git
cd mcp-atlassian
docker build -t mcp/atlassian .

# 使用 Smithery
npx -y @smithery/cli install mcp-atlassian --client claude

3. 配置和使用

您可以使用命令行参数配置 MCP 服务器。该服务器支持使用 Confluence、Jira 或同时使用这两种服务 - 仅包含您的用例所需的参数。

必需参数

对于 Cloud：

uvx 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

对于 Server/Data Center：

uvx 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

注意： 您可以仅配置 Confluence、仅配置 Jira 或同时配置这两种服务。只需包含您要使用的服务所需的参数即可。例如，要仅使用 Confluence Cloud，您只需要 --confluence-url、--confluence-username 和 --confluence-token。

可选参数

• --transport: 选择传输类型 (stdio [默认] 或 sse)
• --port: SSE 传输的端口号（默认值：8000）
• --[no-]confluence-ssl-verify: 切换 Confluence Server/DC 的 SSL 验证
• --[no-]jira-ssl-verify: 切换 Jira Server/DC 的 SSL 验证
• --confluence-spaces-filter: 以逗号分隔的空间键列表，用于过滤 Confluence 搜索结果（例如，“DEV,TEAM,DOC”）
• --jira-projects-filter: 以逗号分隔的项目键列表，用于过滤 Jira 搜索结果（例如，“PROJ,DEV,SUPPORT”）
• --read-only: 以只读模式运行（禁用所有写入操作）
• --verbose: 增加日志记录详细程度（可以多次使用，默认级别为 WARNING）
  • -v 或 --verbose: 将日志记录设置为 INFO 级别
  • -vv 或 --verbose --verbose: 将日志记录设置为 DEBUG 级别

注意： 所有配置选项也可以通过环境变量设置。有关可用环境变量的完整列表，请参阅存储库中的 .env.example 文件。

IDE 集成

Claude Desktop 设置

使用 uvx (推荐) - Cloud:

{
  "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"
      ]
    }
  }
}

<details> <summary>使用 uvx (推荐) - Server/Data Center </summary>

{
  "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"
      ]
    }
  }
}

</details>

<details> <summary>使用 uvx - Confluence with Basic Auth (older servers)</summary>

{
  "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"
      ]
    }
  }
}

</details>

<details> <summary>使用 uvx - Confluence only</summary>

{
  "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"
      ]
    }
  }
}

</details>

<details> <summary>使用 uvx - Jira only</summary>

{
  "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"
      ]
    }
  }
}

</details>

<details> <summary>使用 pip</summary>

注意：以下示例使用 Cloud 配置。对于 Server/Data Center，请使用相应的参数（--confluence-personal-token, --jira-personal-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"
      ]
    }
  }
}

</details>

<details> <summary>使用 docker</summary>

注意：以下示例使用 Cloud 配置。对于 Server/Data Center，请使用相应的参数（--confluence-personal-token, --jira-personal-token），如上面的配置部分所示。

有两种方法可以配置 Docker 环境：

1. 直接在配置中使用 cli 参数：

{
  "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"
      ]
    }
  }
}

2. 使用环境变量文件：

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

</details>

Cursor IDE 设置

1. 打开 Cursor 设置
2. 导航到 Features > MCP Servers (或直接到 MCP)
3. 点击 + Add new global MCP server

这将创建或编辑包含您的 MCP 服务器配置的 ~/.cursor/mcp.json 文件。

stdio 传输的 JSON 配置

对于 Cloud：

{
  "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"
      ]
    }
  }
}

<details> <summary>Server/Data Center 配置</summary>

{
  "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"
      ]
    }
  }
}

</details>

SSE 传输配置

对于 SSE 传输，首先使用通过命令行参数或服务器端环境变量（例如，来自 .env 文件）提供的配置启动服务器：

# 示例：使用 Cloud 配置启动服务器
uvx mcp-atlassian --transport sse --port 9000 \
  --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

然后在 Cursor 的 ~/.cursor/mcp.json 中仅配置 URL：

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

资源

注意： MCP 服务器会过滤资源，仅显示用户正在积极交互的 Confluence 空间和 Jira 项目，具体取决于他们的贡献和分配。

• confluence://{space_key}: 访问 Confluence 空间
• jira://{project_key}: 访问 Jira 项目

可用工具

工具	描述
confluence_search	使用 CQL 搜索 Confluence 内容
confluence_get_page	获取特定 Confluence 页面的内容
confluence_get_page_children	获取特定 Confluence 页面的子页面
confluence_get_page_ancestors	获取特定 Confluence 页面的父页面
confluence_get_comments	获取特定 Confluence 页面的评论
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	获取链接到特定 Epic 的所有问题
jira_create_issue	在 Jira 中创建新问题
jira_update_issue	更新现有的 Jira 问题
jira_delete_issue	删除现有的 Jira 问题
jira_get_transitions	获取 Jira 问题的可用状态转换
jira_transition_issue	将 Jira 问题转换为新状态
jira_add_comment	向 Jira 问题添加评论
jira_add_worklog	向 Jira 问题添加工作日志条目
jira_get_worklog	获取 Jira 问题的工作日志条目
jira_download_attachments	从 Jira 问题下载附件
jira_link_to_epic	将问题链接到 Epic
jira_get_agile_boards	按名称、项目键或类型获取 Jira agile boards
jira_get_board_issues	获取链接到特定 board 的所有问题
jira_get_sprints_from_board	按状态从 board 获取 Jira sprints
jira_get_sprint_issues	从 sprint 获取 Jira 问题

开发和调试

本地开发设置

如果您已克隆存储库并想要运行本地版本：

对于 Cloud：

{
  "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 Inspector
# 对于已安装的软件包
npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

# 对于本地开发版本
npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...

# 查看日志
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

安全

• 永远不要分享 API 令牌
• 保持 .env 文件安全和私密
• 有关最佳实践，请参阅 SECURITY.md

许可证

在 MIT 许可下获得许可 - 请参阅 LICENSE 文件。这不是 Atlassian 的官方产品。