MCP Atlassian

社区

面向 Confluence 与 Jira 的 Model Context Protocol 服务器

分类: 团队协作第 23 / 55
Stars: ★ 6.0k 非常热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Python · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 32 天前
工具数: 10

56FMRS · C

MCP Atlassian 是一个功能较全面的社区 MCP 服务器,提供约 98 个工具用于操作 Jira 和 Confluence 的 Cloud 及 Server/Data Center 部署,核心工具涵盖搜索、增删改查问题/页面及状态流转,但需要用户自行妥善管理 Atlassian API 凭证的安全性。

最强项 · 文档质量 14/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

9/20

维护活跃度

14/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 7/20: 仅有 README 文本，未提供服务器清单（manifest）、源代码或工具实现文件，无法核实所声称的“98 个工具”是否与真实行为一致，也无法验证 MCP 初始化/工具列表握手是否可复现。README 提到存在测试工作流徽章（Run Tests），但未提供实际 CI 工作流文件或测试用例内容，不满足静态校准要求的“可验证执行证据”标准，因此可靠性不能给高分。按静态审阅规则上限进一步下调，最终给 7 分，体现证据缺失带来的不确定性扣分。
安全与权限 9/20: README 仅泛泛提及“不要分享 API 令牌，保护好 .env 文件”，未说明权限范围控制（如是否支持只读模式、按项目/空间限权）、未说明对破坏性操作（如 jira_update_issue、jira_transition_issue、confluence_update_page 等写操作/状态变更工具）是否有二次确认或范围限制机制，也未披露具体的数据流向和外部网络访问边界。未发现示例中包含真实令牌或秘密（使用占位符 your_api_token），不构成红线问题，但风险点未被充分说明，故扣分明显，给 9 分。
维护活跃度 14/20: 仓库有 PyPI 版本/下载量徽章、自动化测试工作流徽章、独立文档站点，5742 星标、185 个未关闭 issue，说明项目有一定关注度和使用规模；MIT 许可证明确，未被标记为归档。但本次评审未见实际提交记录、发布节奏、依赖更新频率等直接证据，只能基于徽章和描述做间接判断，故不给满分，给 14 分。
文档质量 14/20: 文档结构分层清晰：安装（uvx/Docker/pip/源码）、认证（API Token/PAT/OAuth2.0）、配置、HTTP 传输、工具参考、故障排查均有独立页面链接，并提供 llms.txt/llms-full.txt 供 LLM 消费，体现了较高的文档意识。但具体文档内容托管在外部站点，本次评审未直接核实其内容深度、参数级说明与限制披露是否完整，只能基于目录结构判断，故给 14 分而非满分。
安装易用性 12/20: 提供了清晰的 JSON 配置示例和 uvx 一键命令，步骤简明（获取 API Token → 配置 IDE → 使用）。但根据静态审阅规则，若无可验证的执行证据（真实 CI 与覆盖关键路径的测试），安装易用性不能高于 15 分；且实际安装是否顺利、跨平台兼容性、失败时的诊断信息均未见验证证据，需要用户手动编辑配置文件，仍属人工/脆弱型安装，给 12 分。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

需要让 AI 助手直接读写 Jira 问题和 Confluence 页面的团队
同时使用 Atlassian Cloud 与 Server/Data Center 环境的组织
希望在 IDE 或聊天客户端中完成 JQL/CQL 搜索、工单创建与状态流转的开发者

不适合谁

没有 Atlassian Jira 或 Confluence 账号/实例的用户
需要官方 Atlassian 支持保证的场景(本项目并非 Atlassian 官方产品)
无法安全保存或轮换 API Token/.env 文件的环境

所需权限

Jira 和/或 Confluence 实例的 URL
Atlassian 账号邮箱 + API Token(Cloud),或 Personal Access Token(Server/Data Center)
对应账号在 Jira/Confluence 中实际拥有的读写权限(创建/更新问题、创建/更新页面、添加评论等操作需要写权限)

风险与副作用

API Token 或 PAT 一旦泄露,即可被用于以该账号身份读写 Jira/Confluence 数据
README 明确提醒需妥善保管 .env 文件,避免泄露凭证
创建/更新/流转问题及创建/更新页面等操作具有写入性质,配置不当的自动化可能产生非预期的数据变更
并非 Atlassian 官方维护,更新与安全响应依赖社区仓库维护者

安装接入

准备工作

运行环境：Python · Docker

JIRA_URL 必填你的 Jira 实例地址，如 https://your-company.atlassian.net。

JIRA_API_TOKEN 可选密钥 Jira API 令牌，在 https://id.atlassian.com/manage-profile/security/api-tokens 创建。

JIRA_PERSONAL_TOKEN 可选密钥 Server/Data Center 部署使用的个人访问令牌（PAT），替代用户名+API 令牌。

CONFLUENCE_URL 必填你的 Confluence 实例地址，如 https://your-company.atlassian.net/wiki。

CONFLUENCE_API_TOKEN 可选密钥 Confluence API 令牌，在 https://id.atlassian.com/manage-profile/security/api-tokens 创建。

其他可选配置项（2 个）

JIRA_USERNAME 可选你的 Atlassian 账户邮箱（Cloud 部署使用）。

CONFLUENCE_USERNAME 可选你的 Atlassian 账户邮箱（Cloud 部署使用）。

前往 https://id.atlassian.com/manage-profile/security/api-tokens 创建一个 API Token(Server/Data Center 用户需改用 Personal Access Token)。
在 Claude Desktop 或 Cursor 的 MCP 配置中添加一个 mcp-atlassian 条目,command 设为 uvx,args 设为 ["mcp-atlassian"],并在 env 中填入 JIRA_URL、JIRA_USERNAME、JIRA_API_TOKEN、CONFLUENCE_URL、CONFLUENCE_USERNAME、CONFLUENCE_API_TOKEN 等变量(Server/Data Center 使用 JIRA_PERSONAL_TOKEN 代替用户名+API Token)。
也可通过 Autohand Code 的 autohand mcp add mcp-atlassian env ... 命令配置同一个 uvx 服务器。
保存配置后重启客户端,即可让 AI 助手搜索、创建或更新 Jira 问题与 Confluence 页面。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add mcp-atlassian -e JIRA_URL=https://your-company.atlassian.net -e [email protected] -e JIRA_API_TOKEN=your_api_token -e CONFLUENCE_URL=https://your-company.atlassian.net/wiki -e [email protected] -e CONFLUENCE_API_TOKEN=your_api_token -- uvx mcp-atlassian

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Desktop 或 Cursor 的 MCP 工具列表中确认出现 jira_search、confluence_get_page 等工具，然后询问“PROJ 项目中分配给我的 issues 有哪些”以验证连接。

常见排障

确认 JIRA_URL / CONFLUENCE_URL 是否正确(Cloud 通常为 https://your-company.atlassian.net 及其 /wiki 路径)
Cloud 部署需使用邮箱 + API Token;Server/Data Center 部署需改用 JIRA_PERSONAL_TOKEN 而非用户名+Token
检查 API Token 是否过期或权限不足,可在 Atlassian 账号安全设置中重新生成
参考官方文档 mcp-atlassian.soomiles.com 的 Troubleshooting 页面获取更多调试步骤

试试这样问

连接成功后，可以直接对 AI 助手这样说：

查找 PROJ 项目中分配给我的 issues
在 Confluence 中搜索入职相关文档
为登录问题创建一个 bug 工单
把 PROJ-123 的状态更新为 Done

工具能力 10

jira_search 只读

使用 JQL(Jira 查询语言)搜索 Jira 问题

jira_get_issue 只读

获取指定 Jira 问题的详细信息

jira_create_issue 写入

创建新的 Jira 问题

jira_update_issue 写入

更新已有 Jira 问题的字段

jira_transition_issue 写入

变更 Jira 问题的工作流状态

confluence_search 只读

使用 CQL(Confluence 查询语言)搜索 Confluence 内容

confluence_get_page 只读

获取指定 Confluence 页面的内容

confluence_create_page 写入

创建新的 Confluence 页面

展开其余 2 个工具

confluence_update_page 写入

更新已有 Confluence 页面的内容

confluence_add_comment 写入

在 Confluence 页面上添加评论

使用场景

在 PROJ 项目中查找分配给自己的问题

在 Confluence 中搜索入职相关文档

为登录问题创建一个 Bug 工单

将 PROJ-123 的状态更新为 Done

支持客户端

Claude Desktop

Cursor

Autohand Code

依据项目文档列出，未经本站实测。

详细介绍

MCP Atlassian 是一个社区维护的 Model Context Protocol 服务器,让 AI 助手可以直接操作 Atlassian 的 Jira 和 Confluence 产品。它同时支持 Atlassian Cloud 和 Server/Data Center 部署(Confluence 6.0+、Jira 8.14+),提供共计 98 个工具,涵盖搜索、创建、更新问题/页面、状态流转和添加评论等常见操作。README 中列出的关键工具包括基于 JQL 的 Jira 搜索、问题详情获取、问题创建/更新/状态流转,以及基于 CQL 的 Confluence 搜索、页面获取/创建/更新和添加评论。认证支持 API Token(Cloud)、Personal Access Token(Server/Data Center)以及 OAuth 2.0(详见官方文档)。