Atlassian(Jira / Confluence)官方远程 MCP 怎么配:OAuth 授权、查工单写文档与团队权限边界

Atlassian 官方推出远程 MCP 服务器 v2 端点 https://mcp.atlassian.com/v2/mcp,打通 Jira、Confluence 与 Bitbucket。本文整理多端配置、OAuth 授权、查单写文档用法与权限边界。

NNathaniel bigo··原创首发·AI 辅助撰写
11 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 免费账号 账号

结论先说

  1. Atlassian 官方远程 MCP 当前标准地址是 https://mcp.atlassian.com/v2/mcp,连接一次即可在对话里同时调用 Jira、Jira Service Management、Confluence、Bitbucket 与 Loom。
  2. 主流客户端均采用 Streamable HTTP 加浏览器 OAuth 2.1 授权,无需在本地运行自建桥接容器或在明文配置里塞全局密码。
  3. 权限边界严格继承你当前登录的 Atlassian 个人账号权限:你本人没权限查看的私有 Jira 项目或受限 Confluence 页面,AI 通过 MCP 同样无法读取或修改。
  4. 旧版 /v1/mcp 用户建议主动切到 /v2/mcp:切换地址时若报认证冲突,需清理本地缓存的旧客户端凭证后重新发起登录。
  5. 主力模型订阅与账号配套入口:跑通 MCP 工具链与多文件智能体编码依赖稳定的底层大模型配额,国内免境外卡自助开通可见本站 Claude Code 订阅页、ChatGPT Plus 充值页 与 AI 会员充值总览。

Atlassian 官方远程 MCP v2 多端配置方式对照

图:本站根据 Atlassian 官方文档:Get started with the Atlassian MCP server 整理的示意图

本文根据 Atlassian 官方支持文档《Get started with the Atlassian MCP server》及 Claude Code 文档整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Atlassian 或 Anthropic 官方网站。

适用于谁

  • 想在 Claude Code、Cursor、VS Code 或 Claude Desktop 里直接查 Jira 工单(如 PROJ-1234)、读取或撰写 Confluence 技术文档的研发团队;
  • 不清楚应该填旧版 /v1/mcp 还是新版 /v2/mcp 地址,或者升级后遇到凭证报错的用户;
  • 关心企业级数据隔离,想确认 AI 会不会越权读到受限 Confluence 空间或保密项目的管理员与开发者。

一、多端接入 https://mcp.atlassian.com/v2/mcp 步骤

1. Claude Code 命令行配置

  1. 在终端运行命令添加 v2 远程服务器:
bash
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp
  1. 打开 claude 会话后输入 /mcp,选中 atlassian 拉起浏览器登录 Atlassian 云端账号并确认目标站点(Site)。作用域管理细节见 Claude Code MCP 配置教程。日常让 Claude 对照 Confluence 架构文档重构代码消耗额度较多时,可在本站查看 Claude Code 订阅充值。

2. Cursor、Claude Desktop 与 VS Code 配置

在 Cursor(.cursor/mcp.json)或 Claude Desktop 配置文件中直接写入远程地址:

json
{
  "mcpServers": {
    "atlassian": {
      "url": "https://mcp.atlassian.com/v2/mcp"
    }
  }
}

也可以在 Cursor 插件市场搜索官方 Atlassian 插件一键添加,或在 VS Code 扩展视图输入 @mcp Atlassian 安装后按提示完成 OAuth 登录。配置文件排错可参考 Cursor MCP 配置教程 与 Claude Desktop MCP 配置教程。

二、查 Jira 工单与写 Confluence 文档高频场景

依托 Atlassian 底层协作图谱(Teamwork Graph),连上后无需手动拼复杂 JQL 或 CQL 就能跨应用联动:

  • 查单与跟进状态:直接输入「查看 PROJ-1234 的当前状态、经办人和最新三条评论」,或在提完 PR 后让助手「把 PROJ-456 流转到 In Review 并补一条评论说明分支已提交」;
  • 读方案与拆任务:输入「读取 Confluence 里的《Q4 结算服务改造方案》,按里面的验收标准在 Jira 对应项目下拆出 4 个开发子工单(先列出草稿给我确认再创建)」;
  • 总结讨论与写复盘文档:排查完线上故障后,让助手把当前终端的修复原因整理成结构化复盘草稿,新建到指定的 Confluence 团队空间下。

Atlassian 远程 MCP 团队权限边界与报错排查

图:本站根据 Atlassian 官方文档:Get started with the Atlassian MCP server 整理的示意图

编程订阅与高配额省心方案:在 Cursor、Claude Code 或 Codex 里挂载外部工具做长链路开发时,固定月费订阅通常比纯按量 API 更易控成本。本站支持支付宝、微信支付与 AlipayHK 免密自助兑换 Claude Pro、Claude Max 与 ChatGPT Pro,团队协作亦可定制 ChatGPT Business 团队版。

三、团队权限边界与企业安全管控

很多研发团队担心接上 MCP 后会把管理层保密空间或未公开人事页面暴露给大模型,Atlassian 官方架构对此有三层边界:

  1. 完全遵循用户级权限(User-level permissions):每次检索和写入都以当前 OAuth 授权员工的身份执行,Jira 项目权限方案(Permission Schemes)与 Confluence 页面级限制照常生效,不存在绕过权限的超级后台通道。
  2. 支持站点与组织级统一开关:企业管理员可在 admin.atlassian.com 管控 Rovo MCP Server 的启用状态及允许接入的客户端范围。
  3. 无头自动化使用受限令牌(Scoped API Tokens):若在容器或后台巡检代理中无法做网页交互登录,需组织管理员先在后台开启 API Token 认证许可,再由个人账号生成限定权限范围的 Scoped Token 调用,遵循最小权限原则。选型与安全核查清单见 MCP 服务器怎么选、去哪找、装之前怎么审。

常见问题

问:此前的 /v1/mcp 配置还能继续用吗?

答:官方说明旧 v1 地址会在过渡期内继续工作,并计划于 2027 年 3 月 1 日自动暴露和切换至 v2 工具;新配置建议直接写 https://mcp.atlassian.com/v2/mcp,升级后若遇登录循环,清除客户端缓存的旧 clientIds 或重新添加服务名即可。

问:Jira 本地私有化部署版(Data Center)能连这个地址吗?

答:mcp.atlassian.com 面向 Atlassian Cloud 云端产品(如 xxx.atlassian.net)。自建内网 Data Center 实例不在该官方云端远程端点覆盖范围内。

问:怎么避免 AI 不小心改乱现网 Confluence 规范页?

答:在客户端关闭写类工具的「始终允许」,并在提示词里约定「所有文档输出先新建为个人草稿或子页面,禁止直接覆盖原有主文档」。即使发生误改,Confluence 页面本身也保留历史版本记录(Page History),可在网页端一键回滚到修改前的版本。

问:团队成员离职或换电脑后怎么收回 MCP 授权?

答:个人可前往 Atlassian 账号安全设置里的已连接应用(Connected apps)撤销对应客户端的 OAuth 访问权限;组织管理员也可在 admin.atlassian.com 统一审查或关停成员令牌。

问:配置好开发环境后,国内没有外币卡怎么开通 Claude 或 ChatGPT 编程订阅?

答:可在 本站充值中心 自助选购卡密开通 Claude Code(Pro / Max) 或 ChatGPT Plus / Pro,全程无需交出账号密码,支持开具增值税发票;实时价格与售后边界(封号不在质保范围)以对应商品页为准。

相关教程

参考资料

  • Atlassian 官方支持文档:Get started with the Atlassian MCP server — https://support.atlassian.com/atlassian-ai-gateway/docs/get-started-with-the-atlassian-remote-mcp-server/
  • Atlassian 开发者文档:Rovo MCP Server — https://developer.atlassian.com/cloud/rovo-mcp/
  • Claude Code 官方文档:Connect Claude Code to tools via MCP — https://code.claude.com/docs/en/mcp

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    用 ChatGPT 速读英文产品手册、开源文档与 GitHub Issue 并沉淀团队中文内训手册

    团队引入海外 SaaS 工具或开源框架时,全英文文档晦涩冗长、真正的坑全藏在几十页 GitHub Issue 讨论里。本文分享速读拆解英文手册、归类 Issue 排障库以及重构团队中文内训 SOP 的完整实战流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 写油猴脚本(Tampermonkey)与浏览器书签小工具解决网页繁琐重复操作实战

    每天在后台系统里重复勾选几十个复选框、手工复制网页表格或清理遮挡阅读的侧边栏,既枯燥又浪费时间。本文分享不会写 JS 也能用 F12 配合 ChatGPT 写出油猴脚本与书签小工具的完整实战流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 写高质量 SQL 窗口函数(RANK / LAG / SUM OVER)做留存与漏斗分析实战

    做用户留存率、复购间隔与有序转化漏斗时,多层自连接既难读又拖垮数据库,窗口函数则是高效解法。本文整理数据库方言喂数规范、CTE 分层提示词以及用内置沙盒先验证再上线的完整实战流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 连接 Canva、Figma、Linear、Jira、Dropbox 等第三方应用搜不到数据或授权失效怎么办

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 后,明明显示已连接却搜不到文件工单,或老提示授权失效怎么办?本文拆解账号错绑、OAuth 范围漏选、权限继承与管理员拦截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  6. 06

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~