Atlassian MCP Server (Jira & Confluence)

什么是 Atlassian MCP Server (Jira & Confluence)？

Atlassian MCP Server (Jira & Confluence) 即社区项目 mcp-atlassian：一个开源 MCP 服务器，让 AI 助手可以在 Atlassian Cloud 和 Server/Data Center 上搜索、读取、创建和更新 Jira 工单与 Confluence 页面。

该项目由 sooperset 在 GitHub 上维护（sooperset/mcp-atlassian），以 mcp-atlassian 发布在 PyPI 上，采用 MIT 许可证。它不是 Atlassian 官方产品；Atlassian 自己运营一个托管服务器，见下文替代方案部分。如果你需要一个自托管、同时支持本地部署 Jira 和 Confluence 的 Atlassian MCP，它是常见的选择。

如何使用 Atlassian MCP Server (Jira & Confluence)？

前置条件

• 已安装 uv，以便用 uvx 运行该包（也可以使用 Docker 或 pip）。
• 你的 Jira 和/或 Confluence 地址。
• 凭据。Cloud 版：在 https://id.atlassian.com/manage-profile/security/api-tokens 创建 API token，并配合账户邮箱使用。Server/Data Center 版：在个人资料中创建 Personal Access Token，用 JIRA_PERSONAL_TOKEN / CONFLUENCE_PERSONAL_TOKEN 代替用户名和 API token。此外也支持 mTLS 客户端证书和 OAuth 2.0。

可以只配置 Jira、只配置 Confluence，或两者都配置。用以下命令确认服务器可以启动：

uvx mcp-atlassian --help

Claude Desktop

编辑 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/，Windows：%APPDATA%\Claude\，Linux：~/.config/Claude/）：

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

对于 Server/Data Center，使用你自己的地址（例如 https://jira.your-company.com），并用 JIRA_PERSONAL_TOKEN / CONFLUENCE_PERSONAL_TOKEN 替换用户名和 API token。

Claude Code

通过 CLI 注册同一个 uvx 命令：

claude mcp add mcp-atlassian \
  -e JIRA_URL=https://your-company.atlassian.net \
  -e JIRA_USERNAME=your.email@company.com \
  -e JIRA_API_TOKEN=your_api_token \
  -e CONFLUENCE_URL=https://your-company.atlassian.net/wiki \
  -e CONFLUENCE_USERNAME=your.email@company.com \
  -e CONFLUENCE_API_TOKEN=your_api_token \
  -- uvx mcp-atlassian

Cursor

打开 Settings → MCP → + Add new global MCP server，粘贴与 Claude Desktop 相同的 JSON。

VS Code

项目文档将 VS Code（GitHub Copilot）列为通过 stdio 支持。在 .vscode/mcp.json 中把 uvx 命令添加为 stdio 服务器：

{
  "servers": {
    "mcp-atlassian": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

Docker 与 HTTP

项目发布了 Docker 镜像 ghcr.io/sooperset/mcp-atlassian:latest。在共享或远程场景下，可以把服务器作为 HTTP 服务运行：streamable-http 提供 /mcp 端点，sse 提供 /sse 端点：

uvx mcp-atlassian --transport streamable-http --port 9000 -vv

Atlassian MCP Server (Jira & Confluence) 的主要功能

• 同时支持 Cloud 与 Server/Data Center 上的 Jira 和 Confluence（Jira 8.14+，Confluence 6.0+）。
• 近 100 个工具（当前文档为 98 个），按工具集分组，可按需启用。
• 用 JQL 搜索 Jira 工单，用 CQL 搜索 Confluence 内容。
• 你只需编写 Markdown，服务器会在 Cloud 上转换为 ADF，在 Server/Data Center 上转换为 wiki markup。
• 四种认证方式：API token、Personal Access Token、mTLS 客户端证书和 OAuth 2.0。
• 通过 READ_ONLY_MODE=true、ENABLED_TOOLS、TOOLSETS、JIRA_PROJECTS_FILTER 和 CONFLUENCE_SPACES_FILTER 限制智能体可以查看和修改的范围。
• 支持 stdio、SSE 和 streamable-http 传输，包括无状态模式和多用户认证。
• 面向企业网络：支持代理、自定义请求头以及操作系统信任存储。

Atlassian MCP Server (Jira & Confluence) 工具

工具名以 jira_ 或 confluence_ 为前缀。TOOLSETS=default 包含六个核心工具集：jira_issues、jira_fields、jira_comments、jira_transitions、confluence_pages 和 confluence_comments。

• Jira 工单与搜索：jira_search（JQL）、jira_get_issue、jira_create_issue、jira_batch_create_issues、jira_update_issue、jira_assign_issue，以及用于变更状态的 jira_transition_issue。
• Jira 敏捷与项目：看板和 Sprint（jira_get_agile_boards、jira_get_sprint_issues、jira_create_sprint、jira_add_issues_to_sprint），版本、组件，以及 jira_link_to_epic 等工单链接。
• Jira 其他功能：工作日志、关注者、附件、Jira Service Management 队列与请求、SLA 和工单日期、开发信息。
• Confluence 页面：confluence_search（CQL）、confluence_get_page、confluence_create_page、confluence_update_page、confluence_update_page_section、confluence_move_page，以及页面历史和差异对比。
• Confluence 协作：评论、行内评论、标签、附件、模板（confluence_create_page_from_template）和权限检查。

confluence_get_page_views、jira_batch_get_changelogs 等少数工具仅适用于 Cloud。

Atlassian MCP Server (Jira & Confluence) 的使用场景

• 整理自己的待办：“Find issues assigned to me in PROJ project.”
• 根据聊天或日志提交缺陷：“Create a bug ticket for the login issue.”
• 无需打开 Jira 即可推进工作：“Update the status of PROJ-123 to Done.”
• 把 Confluence 当作知识库：“Search Confluence for onboarding docs.”
• 编写文档：让智能体根据 JQL 查询起草发布说明，并发布为 Confluence 页面。

Atlassian MCP Server (Jira & Confluence) 与替代方案对比

• Atlassian 官方 MCP 服务器（Rovo）：Atlassian 在 https://mcp.atlassian.com/v2/mcp 托管了自己的远程 MCP 服务器。它使用 OAuth 2.1 或 API token 登录，覆盖 Jira、Confluence、Jira Service Management、Bitbucket、Compass 和 Loom，但只支持 Atlassian Cloud。如果你想要厂商支持、无需安装的托管方案，选它；如果你需要 Server/Data Center、自托管部署或细粒度的工具过滤，选 mcp-atlassian。
• Atlassian Data Center MCP：mcp.so 上收录的社区服务器，面向 Data Center 版的 Bitbucket、Confluence 和 Jira。

Atlassian MCP Server (Jira & Confluence) 常见问题排查

• Cloud 上出现 401/403：请使用 API token，而不是账户密码。确认 JIRA_USERNAME / CONFLUENCE_USERNAME 是你的邮箱地址，且 token 未过期。
• Server/Data Center 认证失败：检查 Personal Access Token 是否有效。对于较旧的 Confluence 服务器，可以尝试使用 CONFLUENCE_USERNAME 和 CONFLUENCE_API_TOKEN 进行基本认证（此时 token 填写你的密码）。
• 自签名证书导致 SSL 错误：操作系统信任存储中的企业 CA 会被自动信任。对于其他自签名证书，设置 JIRA_SSL_VERIFY=false / CONFLUENCE_SSL_VERIFY=false。
• 客户端显示 0 个工具（例如 GitHub Copilot）：升级到 mcp-atlassian 0.16.0 或更高版本，或运行 uvx mcp-atlassian@latest。
• 需要更多调试信息：设置 MCP_VERBOSE=true 或 MCP_VERY_VERBOSE=true。在 macOS 的 Claude Desktop 中，可查看 ~/Library/Logs/Claude/mcp*.log。