十月七日的 Atlassian Team '26 Europe 大会上，官方 MCP Server 迎来一次大版本扩张：连接工具数从几十个跳到 200 多个，覆盖 Jira、Confluence、Jira Service Management、Bitbucket、Compass、Loom 与平台对象（项目、目标、团队等），官方称这条通道每天承载百万级工具调用。同场发布的还有两件对企业更关键的事：Agent Session Tracking 把 AI 智能体的运行记录直接放进 Jira 可审计可协作，Non-Human Identity 让组织能给智能体发独立身份、独立授权、随时吊销。对使用者来说，接入动作本身很简单：官方远程端点 https://mcp.atlassian.com/v2/mcp，OAuth 2.1 或 API token 认证，所有操作沿用授权者本人的权限。本篇按官方仓库与支持文档，把各客户端接入、验证、权限治理与 v1 迁移一次走完。
先理解：远程托管与端点时间线
官方 MCP 是云托管服务，你不需要跑任何本地进程：客户端连官方端点，初回连接弹浏览器完成 OAuth 2.1 同意页，之后智能体能看到的、能改的，都限定在你这个账号既有权限范围内——你无权看的项目它也看不到。工具按意图分组（读取、检索、写入），覆盖从 JQL 查询、工单创建流转到 Confluence 页面读写、JSM 告警处理的全套动作。
端点有个必须知道的时间线：旧端点 /v1/sse 按官方文档将于 2026 年 6 月 30 日后不再支持，官方 IDE 设置文档建议过渡端点用 /v1/mcp/authv2；而新接入一律用 v2 端点 /v2/mcp——更多工具、更多产品，官方仓库的技能包（skills/）也全部瞄准 /v2/mcp。已有的 v1 连接会自动开始暴露 v2 工具，少数不兼容的客户端需要清理缓存的 client ID 与 .well-known 凭证才能继续完成认证。
网上旧教程多为 v1 端点，直接照抄会踩坑。2026 年 6 月 30 日后 /v1/sse 停用；配置时认准 https://mcp.atlassian.com/v2/mcp，存量 v1 用户按官方迁移说明处理缓存与重定向。
Step 1：Claude Code 接入
# 添加官方远程 MCP（HTTP 传输）
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp
# 进入会话后运行 /mcp，
# 按提示完成 OAuth 浏览器授权（登录 Atlassian 账号并同意）授权完成后，/mcp 面板会显示 atlassian 已连接、工具列表已加载。此时在会话里说「查一下最近七天分配给我的 Jira 问题」，智能体就会调用对应的 JQL 检索工具并返回结构化结果——整条链路没有任何本地组件需要维护。
Step 2：Codex、Cursor 与桌面客户端
# Codex CLI
codex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp
# Cursor：插件市场装 Atlassian plugin（带 MCP）后 Add to Cursor
# VS Code：扩展面板搜索 @mcp Atlassian 后 Install
# Claude Desktop：Settings 里的 Extensions 与 Plugins 入口搜 Atlassian
# Windsurf：Cascade 的 MCP servers 里 Add custom server，
# serverUrl 填 https://mcp.atlassian.com/v2/mcp
# ChatGPT：Connectors 按官方 MCP 指南接入官方仓库同时以多种形态发布同一个服务：Claude Code 插件、Cursor 插件、Gemini 扩展、Agent Plugins v1 清单，以及 MCP Registry 的 server.json。能走插件市场就别手写 JSON——插件包里除了连接配置还带着官方技能包，里面写好了「什么任务用哪组工具」的路由经验，工具命中率比裸配置更稳。
不支持远程 HTTP 的老客户端走 mcp-remote 代理。命令形态：npx -y mcp-remote@latest 加 v2 端点 URL；代理进程要保持运行，token 过期重跑一次即可。这是官方 IDE 设置文档明确给出的兜底路径，别为老工具硬写直连配置。
Step 3：验证与实战场景
# 官方示例动作（直接当提示词用）：
# 1) 检索：「Find all issues assigned to me
# in the last 7 days」
# 2) 造页：「Create a page titled
# Engineering Roadmap Q4」
# 3) 交叉：「Link the two most recent bugs
# to the Sprint 45 page」验证顺序建议从只读开始：检索、汇总、跨产品交叉引用，确认它对你们站点结构的理解正确，再放写操作。高频落地场景都有现成模式——晨会前拉过去 24 小时的状态流转生成站会摘要；sprint 结束把已解决工单汇总成 Confluence 发布说明页；JSM 严重告警自动创建关联事故工单。这些流程的原料全是现成的 JQL/CQL 查询，迁移成本很低。
Step 4：权限治理
# 认证两条路：
# OAuth 2.1 —— 交互式，按人授权，日常推荐
# API token —— 管理员开启后用于非交互式自动化场景
# 治理清单：
# 1) 用最小权限账号完成授权，别拿站点管理员连智能体
# 2) 高影响动作（状态流转、批量编辑）逐次确认
# 3) 定期看 Atlassian 审计日志里的异常动作
# 4) 企业路线：关注 Agent Session Tracking 与
# Non-Human Identity 的全面可用节奏官方免责声明把话说得很直白：MCP 客户端能以你的权限在 Jira、Confluence、Compass 里执行动作，请最小权限、审阅高影响变更、盯审计日志。Team '26 发布的 Non-Human Identity 是把这件事制度化——智能体从「借用某人账号」升级为「可独立追踪的数字工人」，权限独立收放、动作可追溯到身份；个人自用 OAuth 足够，企业接入值得把 NHI 与 Agent Session Tracking 排进规划。
API token 不是普通密钥，别进代码库。非交互场景用 token 时同样遵循最小权限；token 落在环境变量或密钥管理服务里，泄露后立即在 Atlassian 账户安全页吊销。
Step 5：从个人工具到团队标配
# 团队落地顺序建议：
# 1) 限定一到两个试点项目先跑
# （授权粒度在账号侧，用专属账号圈定范围）
# 2) 沉淀高频提示词：站会摘要 / 发布说明 / 工单分诊
# 3) 写操作分级放开：评论先开，建页次之，
# 状态流转与批量编辑最后200 多个工具全量暴露给客户端也会带来上下文负担——这与站内讲过的工具分级思路一致：客户端侧一般支持工具开关，按角色启用子集（开发只用 Jira 检索与代码关联、文档岗只开 Confluence 读写）既省 token 也缩攻击面。提示词库建议进仓库维护，和技能包、审计策略一起当团队资产。
Step 6：升级与迁移注意
# v1 转 v2 检查清单：
# 1) 客户端配置端点改为
# https://mcp.atlassian.com/v2/mcp
# 2) 连不上时清理客户端缓存的 client ID
# 与 .well-known 凭证后重新认证
# 3) 老 v1 连接会自动暴露 v2 工具，
# 不重装也能先尝鲜
# 4) 技能包面向 /v2/mcp；旧的 skills/v1 已归档，
# 不随插件安装，需要时手动引入官方仓库迭代很快，端点细节、工具清单、插件形态都可能随版本调整；本篇命令按 2026 年 10 月的官方仓库 README 与 support 文档书写，动手前扫一眼仓库 README 的当前状态总是值得的。迁移期间新老端点并存，不用赶在一天内切换，但别把 v1 端点写进任何新配置。
工具数量与产品覆盖以实际连接为准。「200+ 工具」是大会上口径，具体到你的站点与订阅档位，可用工具可能不同；文档与 changelog 有出入时，以 support.atlassian.com 的当前页面为准。
常见问题 FAQ
Q：要额外付费吗？官方 MCP Server 随 Atlassian Cloud 提供，接入本身不单独收费；具体功能档位与订阅计划的关系以官方定价页为准。
Q：自托管 Data Center 版 Jira 能用吗？官方远程 MCP 面向 Atlassian Cloud 站点；DC 版用户请以官方对 DC 的支持声明为准，不要强行桥接。
Q：这次扩张还带了什么？Artifacts 应用给 AI 产出物固定 URL 可嵌进 Confluence 与 Jira；Code Search 用自然语言搜 Bitbucket 与 GitHub 代码库；Atlassian Insights 汇聚结构化数据上下文——都围绕 Teamwork Graph 展开。
Q：智能体会看到我无权看的数据吗？不会。所有动作按授权用户既有权限走，项目权限、空间权限照常生效；这也是「授权账号要最小权限」的原因——它的视野上限就是你的。