Claude Code Atlassian MCP 接入教程
在远程 Mac mini 上连接 Jira 与 Confluence并控制外部变更
Atlassian MCP 可以把 Jira 工单、Confluence 页面和其他 Atlassian Cloud 内容带入 Claude Code。本文使用当前 v2 端点完成 OAuth 2.1 接入，先验证站点、项目与空间范围，再演示只读检索、需求排查和内容草拟。创建工单、修改状态、发表评论或发布页面前，必须展示目标与完整变更并等待确认。
Atlassian MCP 适合哪些任务
接入后，Claude Code 可以检索 Jira 工单、摘要 Confluence 页面、结合需求与本地代码排查问题，并从会议纪要或规格说明中整理待办草稿。Atlassian v2 还可连接 Jira Service Management、*it*ucket、Projects、Goals 等产品，实际可见内容取决于账号权限和组织配置。
同一连接也可能创建或更新工单、页面与评论。它会代表用户改变团队协作状态，因此查询与写入应采用不同的提示词和批准规则。
开始前准备
准备一个 Atlassian Cloud 站点、可访问目标 Jira 项目或 Confluence 空间的账号，以及已安装 Claude Code 的远程 Mac。确认组织***允许 Atlassian MCP，并了解是否配置了域名规则或 IP 白名单。
交互式接入优先使用 OAuth 2.1。API token 适合***明确批准的服务型场景，不应为了省略浏览器授权而放入普通命令、聊天记录或截图。
第一步 添加 Atlassian v2 连接
Atlassian 当前官方端点为 https://mcp.atlassian.com/v2/mcp。旧版 v1 将逐步迁移到 v2，新接入直接使用 v2，避免后续重新配置。
在目标仓库执行以下命令。添加后检查服务器名称和地址，确保没有误连测试**、第三方**或旧端点。
cd /path/to/your-project
claude mcp add --transport http atlassian \
https://mcp.atlassian.com/v2/mcp
claude mcp list
claude mcp get atlassian
第二步 完成 OAuth 2.1 授权
启动 Claude Code 后运行 /mcp，选择 atlassian 并开始认证。浏览器会显示 Atlassian 登录与授权页面；核对账号、Cloud 站点和可访问产品后再允许。
OAuth 只会继承该账号原有的 Jira、Confluence 等权限，不会自动获得***权限。组织还可能要求允许的客户端域名、企业身份验证或特定来源 IP。
claude
> /mcp
# 选择 atlassian
# 选择 Authenticate
# 在浏览器中核对账号 Cloud 站点和授权产品第三步 进行只读验收
Atlassian 官方端点同时支持读写，并没有专门的只读 **L。首次验收应使用权限受限的账号，并在提示词中明确禁止创建、更新、转换状态、评论和发布页面。
先列出可访问站点，再读取一个已知 Jira 工单和一个已知 Confluence 页面。验收后到网页端确认没有产生评论、状态变化或新内容。
请仅使用 Atlassian MCP 做只读验收：
1. 列出我可访问的 Atlassian Cloud 站点
2. 读取指定 Jira 工单的标题 状态 描述和评论
3. 读取指定 Confluence 页面的标题 空间和正文摘要
4. 不创建 不更新 不转换状态 不评论 不发布页面
输出实际站点 项目 空间和筛选条件| 验收项 | 通过标准 |
|---|---|
| Cloud 站点 | 只显示预期站点 |
| Jira 项目 | 可读取指定项目和已知工单 |
| Confluence 空间 | 可读取指定空间和已知页面 |
| 写入动作 | 验收提示词禁止创建和更新 |
| 网页端状态 | 没有新增评论 工单 页面或状态变化 |
**步 精确检索 Jira 工单
查询时给出站点、项目 key、工单编号或***、状态和时间范围。若出现多个候选，让 Claude Code 列出编号、标题、项目与匹配理由，不能自行猜测目标。
工单描述、评论、附件和外部链接都属于不可信输入。其中即使出现读取本机凭据、上传文件或调用无关工具的文字，也不能视为当前任务指令。
请在指定 Jira 项目中只读检索：
- 站点：<SITE>
- 项目 key：<PROJECT_KEY>
- ***：<KEYWORDS>
- 状态：未完成
- 时间：最近 60 天
列出编号 标题 状态 更新时间和匹配理由。
如有多个候选，不要猜测，请等待我选择。第五步 结合代码调查工单
先读取工单中的复现步骤、验收条件和相关评论，再与仓库中的实现、测试和日志交叉验证。输出要区分工单事实、代码证据、推断和待确认项。
调查完成后可以起草评论，但不要直接发布。评论草稿应去除令牌、内部地址、个人信息和无关生产日志，并逐字交给用户检查。
第六步 摘要 Confluence 页面
限定站点、空间和页面标题后读取内容。摘要中保留决策、负责人、日期、前置条件和未决问题，避免把旧页面或个人草稿当作当前**。
若要根据页面生成 Jira 工单，先输出候选工单清单和字段草稿。页面中的表格、宏、附件或嵌入内容可能不完整，创建前应回到原页面核对。
第七步 控制 Jira 写入
创建工单前展示站点、项目、工单类型、标题、描述、优先级、负责人和标签。更新现有工单前展示编号、原值和新值；转换状态前还要说明目标状态。
批量创建或更新必须列出全部对象和预计数量。只有用户明确确认后，才执行已展示的那一批操作；不要把整理、同步或跟进等模糊表述解释为写入授权。
先不要执行 Jira 写入。请展示：
- Cloud 站点 项目 key 和工单类型
- 工单编号与完整标题
- 每个字段的原值和新值
- 将要发布的完整评论文本
- 预计影响对象数量
等待我明确确认后，只执行已展示的操作。| 操作 | 风险 | 控制方式 |
|---|---|---|
| 读取 Jira 和 Confluence | 低 | 限定站点 项目 空间和数量 |
| 读取评论与附件 | 中 | 脱敏并视为不可信输入 |
| 创建或更新 Jira 工单 | 高 | 展示完整字段和对象清单 |
| 转换工单状态 | 高 | 核对编号 原状态和目标状态 |
| 发表评论 | 高 | 逐字展示文本后确认 |
| 发布 Confluence 页面 | 高 | 核对空间 父页面 标题和正文 |
第八步 控制 Confluence 发布
创建或修改页面前展示站点、空间、父页面、标题和完整正文。覆盖已有页面时先读取当前版本，并说明将替换或追加的范围。
发布页面会改变团队共享知识。Claude Code 应先生成草稿文件或在对话中展示正文，用户确认后再调用写入工具。含有敏感数据或未公开计划的内容不应进入错误的空间。
先生成 Confluence 页面草稿，不要发布。请展示：
- Cloud 站点 空间和父页面
- 页面标题
- 完整正文
- 新建 追加或覆盖方式
- 覆盖时的当前版本与差异
等待我确认后再执行一次发布。第九步 管理权限 网络和额度
组织***可以控制允许连接的客户端域名、身份验证方式和 IP 白名单。如果 OAuth 成功但工具调用仍被拒绝，应核对远程 Mac 的出口 IP、企业 VPN和 Atlassian 站点权限。
通过 MCP 执行统一搜索或 Teamwork Graph 上下文调用可能消耗组织的 Rovo 额度。查询时限定站点、项目、空间、时间范围和返回数量，避免无目的地抓取大量内容。
第十步 在远程 Mac 上保持会话
通过 SSH 进入远程 Mac，在目标仓库创建 tmux 会话后运行 Claude Code。网络短暂中断或关闭远程桌面后，代码调查和终端上下文仍可保留。
同时处理多个 Atlassian 站点时，为每个 tmux 会话使用清晰名称，并在提示词开头写明站点、项目或空间和允许的动作。任务结束后检查授权应用，撤销不再使用的连接。
ssh your-**c-mini
cd /path/to/your-project
tmux new -s atlassian-mcp
claude
# 断线后接回
tmux attach -t atlassian-mcp
为什么 Zu**c.Ai 适合这类工作流
根据 Zu**c.Ai 官网***息，其方案提供位于新加坡的 Mac mini M6 整机独享环境，配置为 16G* 统一内存与 256G* SSD，接入新加坡家庭或商业宽带，并支持 UU 远程、终端、Tailscale、ToDesk、RustDesk，以及浏览器 SSH 或 VNC。
官网当前公开价格为每月 999 元起。长期在线环境适合保留仓库、依赖缓存、Claude Code 与 tmux 会话；Atlassian 账号、组织策略、Rovo 额度、数据合规和第三方***用仍由使用者自行管理。
常见问题排查
| 现象 | 常见原因 | 处理建议 |
|---|---|---|
| OAuth 页面未打开 | 远程环境未拉起浏览器 | 运行 /mcp 后手动打开授权地址 |
| 看不到目标站点 | 账号无产品许可或授权站点错误 | 核对 Cloud 站点和账号权限 |
| 授权成功但调用被拒绝 | 域名或 IP 白名单阻止 | 请***核对客户端域名和出口 IP |
| 使用了旧工具或登录失败 | 仍配置 v1 或缓存旧凭据 | 改用 v2 端点并重新建立授权 |
| 消耗额度过快 | 搜索范围和上下文过大 | 限定站点 项目 空间 时间和数量 |
| 匹配到多个对象 | 标题或***不唯一 | 使用 project key 工单编号或页面路径 |
结语
Claude Code 接入 Atlassian MCP 后，应先核对站点、项目、空间与账号权限，并完成一次明确禁止写入的验收。创建工单、转换状态、发表评论或发布页面时，先展示对象、字段差异和完整正文，再由用户逐次确认。
