【免费下载链接】atlassian-mcp-server
Official remote MCP server for Atlassian. Securely connect Jira, Confluence, Jira Service Management, Bitbucket, and Compass to Claude, ChatGPT, Cursor, VS Code, and other AI tools using OAuth 2.1 or API tokens.
Atlassian MCP Server(官方仓库 atlassian-mcp-server)是 Atlassian 推出的官方远程 MCP 服务器,它能把Jira、Confluence、Jira Service Management、Bitbucket、Compass、Loom等 Atlassian 产品安全地接入 Claude、ChatGPT、Cursor、VS Code 等 AI 工具。你只需一次 OAuth 2.1 或 API Token 认证,就能用自然语言搜索、创建和更新工作项,全程尊重你现有的权限体系。
为什么需要 Atlassian MCP Server?
传统工作流里,在 Jira 里查任务、去 Confluence 查文档、回到 IDE 写代码,需要不断切换标签页。接入 MCP 之后,连接一次,用嘴说需求即可,AI 会自动选择并执行正确的操作:
- 🔍搜索与摘要:跨 Jira、Confluence、Bitbucket 等项目数据搜索、汇总,不用切换工具
- 📝创建与更新:用自然语言创建/更新工作项、页面
- 🎬Loom 视频:检索和复盘会议录像
- ⚙️自动化重复劳动:从会议笔记或规格文档批量生成工作项
它是云托管的远程服务,不需要本地部署,核心服务端点统一为:
https://mcp.atlassian.com/v2/mcp💡v2 是推荐版本。新接入请使用
/v2/mcp,它能暴露更多工具和产品;已有的 v1 连接也会自动升级为 v2 工具。
支持的产品与权限一览
工具按「读取、写入、搜索、删除、管理」分组,管理员可按权限组授权。核心产品支持情况如下:
| 产品 | 权限组 | OAuth 2.1 | API Token |
|---|---|---|---|
| Jira | read_jira·write_jira·search_jira | ✅ | ✅ |
| Confluence | read_confluence·write_confluence·search_confluence | ✅ | ✅ |
| Bitbucket Cloud | read_bitbucket·write_bitbucket | ✅ | ✅ |
| Jira Service Management | read_jsm·write_jsm | — | ✅(仅支持) |
| Loom / Goals / Projects / Teams 等 | 各自的read_*·write_* | ✅ | ✅ |
| Compass | read_compass·write_compass | ✅(仅支持) | — |
⚠️ 两个注意点:
delete_jira和manage_jira默认关闭,需要管理员显式开启- JSM(Jira Service Management)工具只支持 API Token认证
一键安装:四大主流客户端
每个客户端都有原生安装入口,无需手写任何 JSON 配置。
1️⃣ Claude:把 Jira 和 Confluence 带进工作流
打开 Claude.ai 的连接器目录,搜索Atlassian,点击连接,走一遍 OAuth 登录即可。Claude Desktop 用户也可走Settings → Extensions → Plugins,搜索Atlassian安装。
2️⃣ Cursor:在代码库里引用并记录 Issue
前往 Cursor 的插件市场找到Atlassian插件,点击Add to Cursor。之后在写代码时可以直接引用 Jira Issue、提交工作记录,不用切窗口。
3️⃣ VS Code(GitHub Copilot):搜索并创建 Jira Issue
在扩展视图(Extensions)中搜索@mcp Atlassian,点击Install。这是 VS Code 的原生 MCP 发现机制,安装后 Copilot 聊天即可直接调用 Jira 工具。
4️⃣ ChatGPT:对话中直接搜索、汇总、创建
在 ChatGPT 的Connectors中添加 Atlassian Rovo 连接器,完成授权后就能在对话里直接查询 Jira 状态、总结 Confluence 页面。
其他客户端快速对照表
| 客户端 | 安装方式 |
|---|---|
| Claude Code | claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp,然后在会话里执行/mcp完成认证 |
| Codex | codex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp |
| Windsurf | Cascade → MCP servers → Add custom server,serverUrl填https://mcp.atlassian.com/v2/mcp |
| 其他 MCP 客户端 | 直接使用服务端点https://mcp.atlassian.com/v2/mcp |
| 本地 MCP 客户端 | 通过mcp-remote代理连接(需 Node.js v18+) |
让 AI Agent 帮你自动完成安装
如果你用的是 AI 编程 Agent(Claude Code、Codex 等),可以直接把下面这段提示词丢给它,它会自行完成安装、认证和配置:
Set up Atlassian MCP for this agent using the official setup guide and the MCP server URL https://mcp.atlassian.com/v2/mcp. Then start the Atlassian MCP authentication flow so I can sign in.粘贴后按提示在浏览器中登录 Atlassian 账号,认证即告完成。
认证方式:OAuth 2.1 还是 API Token?
| 方式 | 适用场景 | 说明 |
|---|---|---|
| OAuth 2.1 | 桌面 IDE、网页客户端等交互式场景 | 默认推荐,现代浏览器完成授权流程 |
| API Token | 无头/服务化/自动化场景 | 需管理员在Atlassian Administration → Rovo → Rovo MCP server → Authentication中开启;JSM 工具必须用此方式 |
所有流量均走HTTPS(TLS 1.2+),且数据访问严格受限于你在 Atlassian Cloud 中已有的权限——MCP 不会让你看到原本看不到的内容。
接好之后能做什么?实用工作流示例
Jira 场景
- 搜索:"找出 Project Alpha 里所有未关闭的 Bug"
- 创建:"创建一个标题为 'Redesign onboarding' 的 Story"
- 批量:"把这份笔记拆成 5 个 Jira Issue"
Confluence 场景
- 摘要:"总结一下 Q2 规划页面"
- 创建:"创建一个名为 'Team Goals Q3' 的页面"
组合任务
- 把 3 个 Jira 工作项链接到 "Release Plan" 页面
- 把
PROJ-456移到 "In Review" 并评论 PR 已提交
附赠:官方 Skills 技能包
仓库自带一组针对 v2 端点的技能包,覆盖会议笔记转任务、生成状态报告、Sprint 看板、Issue 分诊等常见工作流,安装打包好的插件时会一并带上:
- skills/capture-tasks-from-meeting-notes/SKILL.md — 从会议笔记中提取待办任务
- skills/generate-status-report/SKILL.md — 自动生成状态报告(附 JQL 构建脚本 jql_builder.py)
- skills/jira-sprint-dashboard/SKILL.md — Sprint 进度看板
- skills/spec-to-backlog/SKILL.md — 规格文档转待办清单
- skills/triage-issue/SKILL.md — Issue 自动分诊
- skills/search-company-knowledge/SKILL.md — 公司知识检索
v1 与 v2 的工具命名差异(如 Confluence 工具从*Page改名为*Content)详见 skills/README.md。
仓库关键文件导航
| 文件 | 作用 |
|---|---|
| mcp.json | Agent Plugins 标准 MCP 服务器配置(streamable-http指向 v2 端点) |
| server.json | MCP Registry 元数据(com.atlassian注册名、v2/v1 双端点) |
| plugin.json | 插件打包清单,声明名称、关键词(jira、confluence 等) |
| gemini-extension.json | Gemini 扩展格式,MCP 配置内嵌于清单 |
| CONTRIBUTING.md | 贡献指南 |
| SECURITY.md | 安全策略说明 |
安全与常见问题速查
🔒安全提示:MCP 客户端会以你的权限执行操作。建议只使用可信客户端和服务器、遵循最小权限原则(缩小 Token 作用域),对高影响操作保留人工确认。
常见报错排查:
| 现象 | 可能原因与处理 |
|---|---|
| "You don't have permission to connect from this IP address" | 组织开启了 IP 白名单,而托管型 AI 客户端走的是服务商出口 IP。请管理员核对提供商的出口 IP 段 |
| OAuth 登录成功,但工具调用返回 403 | 可能是 IP 限制、权限 scope 不足或应用权限问题,先确认拒绝原因再调整白名单 |
| 升级 v2 后认证失败 | 客户端可能缓存了旧的 client ID 或.well-known凭据,清除缓存后重新认证 |
写在最后
Atlassian MCP Server 的接入路径已经非常平滑:四大主流客户端支持一键安装,其余客户端一行命令,连"让 AI 自己装"都可以。5 分钟完成认证后,Jira、Confluence、Bitbucket 的数据就成了你 AI 助手的"随手可查"资源——省掉的是每天几十次标签页切换的功夫。
⏰ 小提示:旧的 Server-Sent Events 端点
/v1/sse将于 2026 年 6 月 30 日后停用,自定义客户端请尽早切换到/v2/mcp。
【免费下载链接】atlassian-mcp-server
Official remote MCP server for Atlassian. Securely connect Jira, Confluence, Jira Service Management, Bitbucket, and Compass to Claude, ChatGPT, Cursor, VS Code, and other AI tools using OAuth 2.1 or API tokens.
相关推荐
如何把 Angular CLI 的 MCP Server 接入 Cursor、VS Code 或 Antigravity 等 AI 助手?
如何把 Angular CLI 的 MCP Server 接入 Cursor、VS Code 或 Antigravity 等 AI 助手? Angular CL
前端Web框架如何把 Next AI Draw.io MCP Server 接入 Claude Desktop、Cursor 或 Claude Code CLI
如何把 Next AI Draw.io MCP Server 接入 Claude Desktop、Cursor 或 Claude Code CLI Next A
AI 应用大模型前端后端MCP 服务AOCI-CODE 快速上手教程:5 分钟把 Codex 和 Claude Code 接入你的项目并建立索引
AOCI CODE 快速上手教程:5 分钟把 Codex 和 Claude Code 接入你的项目并建立索引 AOCI CODE 是一个本地优先的代码认知索引工
人工智能MCP 服务开发工具
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考