适合谁
- 需要让 AI 助手直接读写 Jira 问题和 Confluence 页面的团队
- 同时使用 Atlassian Cloud 与 Server/Data Center 环境的组织
- 希望在 IDE 或聊天客户端中完成 JQL/CQL 搜索、工单创建与状态流转的开发者
M
56FMRS · C
MCP Atlassian 是一个功能较全面的社区 MCP 服务器,提供约 98 个工具用于操作 Jira 和 Confluence 的 Cloud 及 Server/Data Center 部署,核心工具涵盖搜索、增删改查问题/页面及状态流转,但需要用户自行妥善管理 Atlassian API 凭证的安全性。
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(详见官方文档)。
工具能力
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 页面
confluence_update_page
更新已有 Confluence 页面的内容
confluence_add_comment
在 Confluence 页面上添加评论
安装接入
- 前往 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"}}}}
选型与风险
不适合谁
- 没有 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 官方维护,更新与安全响应依赖社区仓库维护者
常见排障
- 确认 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 页面获取更多调试步骤
使用场景
在 PROJ 项目中查找分配给自己的问题
在 Confluence 中搜索入职相关文档
为登录问题创建一个 Bug 工单
将 PROJ-123 的状态更新为 Done
支持客户端
Claude Desktop完整支持
Cursor完整支持
Autohand Code完整支持