Atlassian Rovo MCP Server

Name: Atlassian Rovo MCP Server
Author: atlassian.com

远程服务

support.atlassian.com生产力1.1k3 周前更新

代码仓库访问官网

关于 Atlassian Rovo MCP Server

Atlassian Rovo MCP Server 是 Atlassian 官方提供的云端 MCP 服务，可让兼容的 AI 工具安全访问 Jira、Confluence、Jira Service Management、Bitbucket、Compass 和 Loom 等数据。它面向开发者、内容创作者和项目团队，通过 OAuth 2.1 或 API 令牌认证，并遵循用户现有的权限设置。

主要功能

01访问 Jira、Confluence 等多个产品
02搜索、创建与更新工作项和页面
03Loom 录制内容检索与回顾
04OAuth 2.1 与 API 令牌认证
05按权限组控制工具访问
06按需发现工具以节省上下文

适用场景

01在 IDE 或 AI 工具中查询与创建 Jira 工作项
02基于会议记录或需求文档批量生成工作项
03在 AI 客户端中检索 Confluence 页面内容

MCP 相关

该服务是托管在云端的远程 MCP 服务，MCP 客户端通过 https://mcp.atlassian.com/v2/mcp 等端点连接，并调用其中暴露的工具。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.atlassian.com/v2/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-atlassian-atlassian https://mcp.atlassian.com/v2/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-atlassian-atlassian":{"type":"http","url":"https://mcp.atlassian.com/v2/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-atlassian-atlassian":{"type":"http","url":"https://mcp.atlassian.com/v2/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-atlassian-atlassian":{"type":"http","url":"https://mcp.atlassian.com/v2/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-atlassian-atlassian":{"serverUrl":"https://mcp.atlassian.com/v2/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

Streamable HTTPhttps://mcp.atlassian.com/v2/mcp

Streamable HTTPhttps://mcp.atlassian.com/v1/mcp/authv2

工具

详细介绍

Atlassian

Atlassian MCP 服务

Atlassian 官方 Model Context Protocol（MCP）服务：一个托管于云端的桥接服务，让你的 AI 工具能够安全、实时地访问 Jira、Confluence、Jira Service Management、Bitbucket、Compass、Loom 以及更广泛的 Atlassian 平台，并由你的 Teamwork Graph 提供支持。

Getting started · Supported tools · Security & admin · Community

官方 Atlassian MCP 服务是连接 Atlassian Cloud 站点与兼容外部工具的云端桥梁。配置完成后，这些工具便可实时与 **Jira、Confluence、Jira Service Management、Bitbucket、Compass、Loom 以及 Atlassian 平台数据（Projects、Goals、Teams、Focus、Talent 和 Teamwork Graph）**交互。身份验证使用 OAuth 2.1 或 API tokens，因此每项操作都会遵循用户现有的访问控制。

借助 Atlassian MCP 服务，你可以：

无需切换工具，即可汇总和搜索 Jira、Jira Service Management、Confluence、Bitbucket、Projects、Goals 等内容。
检索和查看 Loom 中的视频和会议录制内容。
根据自然语言命令创建和更新工作项或页面。
自动处理重复性工作，例如根据会议记录或规格说明生成工作项。

只需连接一次，然后描述你的需求——无需切换标签页，也无需复制粘贴。你的 AI 会选择并执行合适的操作。

该服务面向开发者、内容创作者和项目团队，适合在 IDE 或 AI 工具中工作并希望使用 Atlassian 数据、避免频繁切换上下文的用户。

重要

**v2 现已成为推荐版本。**新配置应使用 https://mcp.atlassian.com/v2/mcp，它提供更多工具和更多产品。现有 v1 连接会自动开始提供和使用 v2 工具；不兼容的客户端可能需要清除缓存的客户端 ID 或 .well-known 凭据，才能继续进行身份验证。设置步骤请参阅开始使用 Atlassian MCP 服务。

一键设置

在下方选择你的 AI 客户端，以安装官方 Atlassian MCP Server。每个按钮都会使用客户端原生的安装链接，因此无需手动编辑任何 JSON 配置。

添加到 Cursor
_{在代码库中引用问题并记录工作。}

添加到 VS Code
_{通过 GitHub Copilot 搜索并创建 Jira 问题。}

添加到 ChatGPT
_{直接在 ChatGPT 中搜索、总结和创建。}

添加到 Claude
_{在 Claude 工作流中使用 Jira 和 Confluence。}

让你的 Agent 完成设置

大多数 AI 编码 Agent 都可以自行安装、验证身份并配置服务。将此提示词复制并粘贴到你的 Agent 中：

Set up Atlassian MCP for this agent using the official setup guide at
https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/
and the MCP server URL https://mcp.atlassian.com/v2/mcp. Then start the Atlassian MCP
authentication flow so I can sign in.

或者使用客户端自己的命令手动添加服务：

客户端	命令或配置
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`
Claude Desktop	设置 → 扩展 → 浏览扩展 → 插件，然后搜索 Atlassian
Codex Desktop	插件或连接器，然后安装 Atlassian Rovo
VS Code / GitHub Copilot	扩展视图 → 搜索 `@mcp Atlassian` → 安装
Cursor	适用于 Cursor 的 Atlassian MCP 插件 → 添加到 Cursor
Windsurf	Cascade → MCP 服务 → 添加服务 → 添加自定义服务，将 `serverUrl` 设为 `https://mcp.atlassian.com/v2/mcp`
任何其他 MCP 客户端	使用服务 URL `https://mcp.atlassian.com/v2/mcp`

支持的客户端

Atlassian MCP Server 支持的 MCP 兼容客户端列表不断扩展：

客户端	设置参考
OpenAI ChatGPT	连接器 / MCP 指南
OpenAI Codex（CLI 和桌面版）	Codex MCP 文档
Claude（Claude.ai、桌面版和 Code）	Claude MCP 文档
Cursor	Cursor 市场中的 Atlassian
Visual Studio Code（GitHub Copilot）	VS Code MCP 文档
GitHub Copilot CLI	关于 Copilot CLI
Google Gemini CLI	Gemini CLI MCP 文档
Windsurf	Windsurf MCP 文档
Docker	Docker MCP 目录与工具包
Kiro 和其他 Agent Plugins 客户端	Kiro Powers 文档
Amazon Quick Suite	MCP 集成指南

Atlassian MCP Server 还支持任何可在 localhost 上运行，并通过 mcp-remote 代理连接到服务的本地 MCP 兼容客户端。这使得遵循 MCP 规范的自定义或第三方集成成为可能。

提示

如需查看当前权威的支持客户端列表及分步设置说明，请参阅开始使用 Atlassian MCP Server。你也可以参考客户端自身的 MCP 文档或内置助手。

插件打包与兼容性

本仓库以多种打包格式发布相同的 MCP 服务和技能，供客户端使用各自原生的发现和安装流程：

格式	清单与配置	共享组件
Agent Plugins v1	`plugin.json` 和 `mcp.json`	`skills/`
Claude Code 插件	`.claude-plugin/plugin.json` 和 `.claude-plugin/marketplace.json`	`.mcp.json` 和 `skills/`
Cursor 插件	`.cursor-plugin/plugin.json`	`.mcp.json` 和 `skills/`
Gemini 扩展	`gemini-extension.json`	嵌入清单中的 MCP 服务配置
MCP Registry	`server.json`	远程服务元数据

skills/ 中的技能面向 /v2/mcp 端点，是每个打包插件都会安装的内容。上一代技能归档在 skills/v1/ 中，供仍在使用 v1 端点的用户使用；任何插件都不会安装这些技能，需手动设置。差异请参阅 skills/README.md。

mcp.json 和 .mcp.json 均有意保留。Agent Plugins 要求根目录文件名为 mcp.json，并使用可移植的传输术语；现有客户端则继续使用 .mcp.json 和各自原生的配置术语。修改任一文件时，请保持它们的端点设置一致。

采用 Agent Plugins 的客户端（包括 Kiro Powers）可以导入根目录打包内容。客户端专用清单仍然可用，不会被可移植打包内容取代。

支持的产品和工具

工具按产品和用途（读取、写入、搜索、删除或管理）进行组织。组织管理员可在权限组级别授予或撤销访问权限，每个工具继承其所属权限组的访问权限。

产品	权限组	OAuth 2.1	API token
Jira	`read_jira` · `write_jira` · `search_jira`	✅	✅
Jira（管理员启用）	`delete_jira` · `manage_jira`	✅	✅
Confluence	`read_confluence` · `write_confluence` · `search_confluence`	✅	✅
Bitbucket Cloud	`read_bitbucket` · `write_bitbucket`	✅	✅
Jira Service Management	`read_jsm` · `write_jsm`	—	✅（仅限此方式）
Atlassian platform	`read_teamwork_graph` · `write_teamwork_graph` · `search_atlassian`	✅	✅
Loom	`read_loom` · `write_loom`	✅	✅
Goals	`read_goals` · `write_goals`	✅	✅
Projects	`read_projects` · `write_projects`	✅	✅
Teams	`read_teams` · `write_teams`	✅	✅
Focus	`read_focus` · `write_focus`	✅	✅
Talent	`read_talent` · `write_talent`	✅	✅
Compass	`read_compass` · `write_compass`	✅（仅限此方式）	—

产品特定条件：

delete_jira 和 manage_jira 默认处于禁用状态，必须由管理员启用后才能使用。
只有当 Bitbucket 工作区关联到组织时，才能使用 Bitbucket Cloud 工具。未关联到组织的工作区在身份验证时无法选择。
Jira Service Management 工具仅支持通过 API token 进行身份验证，且只有组织管理员启用了 API token 身份验证后才能使用。
只有关联到 Atlassian 站点的 Loom 工作区才能使用 Loom 工具。
Teamwork Graph 工具可从连接到 Jira 的第三方服务检索数据，例如关联的拉取请求、构建和部署。对于 GitHub for Atlassian，完全访问权限表示工具根据用户的 GitHub 权限检索 GitHub 数据，而有限访问权限表示工具根据用户的 Jira 权限检索数据。Azure DevOps、GitLab、Jenkins 和 Spinnaker 连接器遵循有限访问权限模式。

说明

如需完整且最新的工具参考（包括每个权限组所需的范围），请参阅支持的工具。

服务器如何公开工具

Atlassian MCP Server 不会在连接时向 AI 客户端发送所有工具定义，而是公开一小组最常用的工具，并让客户端按需发现其余工具。标记为 Primary 的工具会直接展示给 Agent。

这样做有两项好处：

客户端的上下文可以留给当前任务，而不会被工具定义占满。
新工具可直接使用，无需客户端重新连接。

MCP 网关

如果你使用 MCP 网关，或者需要预先提供所有工具，而不是使用发现和执行方法，请使用 tools=all 覆盖选项，以分页的扁平工具列表形式公开所有工具：

https://mcp.atlassian.com/v2/mcp?tools=all

开始之前

设置服务器前，请确认你的环境满足以下要求。

前提条件

具体要求取决于连接方式：

对于受支持的客户端

一个 Atlassian Cloud 站点，其中包含一个或多个 Jira、Confluence、Jira Service Management、Bitbucket 或 Compass
可访问所选客户端
用于完成 OAuth 2.1 授权流程的现代浏览器，或用于无头身份验证的 API token 凭据

如果组织管理员已禁用通过 API token 进行身份验证，MCP 客户端就无法使用 token 连接，必须改用 OAuth 2.1。

适用于 IDE 或本地客户端（桌面端设置）

一个 Atlassian Cloud 站点，其中包含一个或多个受支持的产品
一个受支持的 IDE（例如 Claude Desktop、VS Code 或 Cursor）或自定义的 MCP 兼容客户端
已安装 Node.js v18+，用于运行本地 MCP 代理（mcp-remote）
用于完成 OAuth 登录的现代浏览器，或用于无头身份验证的 API token 凭据

数据与安全

该服务实施了多项安全控制：

根据 Atlassian 的安全实践，所有流量均通过 **HTTPS（TLS 1.2 或更高版本）**加密传输。
OAuth 2.1 和 API token 身份验证可提供安全的访问控制。
数据访问遵循用户在每个已连接 Atlassian 产品中的权限，包括 Jira、Confluence、Jira Service Management、Bitbucket、Compass 和 Loom。
如果你的组织对 Atlassian Cloud 产品使用 IP 允许列表，通过 Atlassian MCP 服务发起的工具调用也会遵循这些 IP 规则。

如需深入了解安全模型和管理员控制，请参阅：

工作原理

架构与通信

受支持的客户端连接到服务端点。建议所有客户端使用以下端点：
```
https://mcp.atlassian.com/v2/mcp
```
v1 端点（https://mcp.atlassian.com/v1/mcp/authv2 和 https://mcp.atlassian.com/v1/mcp）仍受支持，现有的 v1 连接会自动开始公开并使用 v2 工具。
根据你的设置，将触发安全的基于浏览器的 OAuth 2.1 流程，或使用 API token 身份验证。
获得授权后，客户端会流式传输上下文数据，并从已连接的 Atlassian 产品接收实时响应。

警告

2026 年 6 月 30 日之后，旧版 Server-Sent Events 端点（https://mcp.atlassian.com/v1/sse）将不再受支持。 请更新所有配置为使用 /sse 的自定义客户端，将其指向 /mcp，最好使用 https://mcp.atlassian.com/v2/mcp。

说明

切换到 v2 工具后无法完成身份验证的客户端，可能需要清除缓存的客户端 ID 或 .well-known 凭据。

权限管理

用户只能访问自己原本就有权在 Atlassian Cloud 中查看的数据。所有操作均遵循现有的项目级或空间级角色。OAuth 和 API token 身份验证都会遵循已配置的范围和 Atlassian 权限。

API 令牌认证（无头模式）

API 令牌认证适用于无头、服务式或非交互式客户端设置（例如后端系统或自动化）。Jira Service Management 工具也必须使用此认证方式。

支持以下两种机制：

机制	请求头
个人 API 令牌（Basic 认证）	`Authorization: Basic <base64(email:api_token)>`
服务账户 API 密钥（Bearer 令牌）	`Authorization: Bearer <api_key>`

需要管理员启用： 组织管理员必须为 Atlassian MCP Server 启用 API 令牌认证（Atlassian Administration → Rovo → Rovo MCP server → Authentication）。
需要限定范围的令牌： 创建个人 API 令牌，或向管理员申请服务账户 API 密钥，并确保其具有访问所需工具和数据的权限范围。
配置指南： 通过 API 令牌配置认证
管理员设置参考： 控制 Atlassian MCP Server 设置：配置认证

示例工作流

连接后，你可以通过客户端执行以下任务。

Jira 工作流

搜索：“查找 Project Alpha 中所有未解决的 Bug。”
创建/更新：“创建一个标题为‘重新设计引导流程’的故事。”
批量创建：“根据这些笔记创建五个 Jira 问题。”

Confluence 工作流

总结：“总结 Q2 规划页面。”
创建：“创建一个标题为‘团队 Q3 目标’的页面。”
导航：“我可以访问哪些空间？”

Compass 工作流

创建：“根据当前代码库创建一个服务组件。”
批量创建：“从此 CSV/JSON 导入组件和自定义字段。”
查询：“api-gateway 服务依赖于什么？”

Loom 工作流

检索：“查找上周设计评审的 Loom 录制内容。”
总结：“总结这段 Loom 演示，并列出行动事项。”

Projects and Goals 工作流

状态：“Checkout Revamp 项目的当前状态是什么？”
汇总：“本季度哪些目标有风险，原因是什么？”

组合任务

关联内容：“将这三个 Jira 工作项关联到‘发布计划’页面。”
查找文档：“获取此 Compass 组件链接的 Confluence 文档页面。”
推动工作进展：“将 PROJ-456 移至‘审核中’，并添加评论说明 PR 已提交。”

说明

实际功能因你的权限级别和客户端平台而异。

技巧与窍门

设置默认 CloudId、Jira 项目和 Confluence 空间

使用下面的 Markdown 更新你的 AGENTS.md，以减少发现工具调用、节省时间和令牌，并设置最大的搜索结果数量。

## Atlassian MCP

When connected to atlassian-rovo-mcp:
- **MUST** use Jira project key = YOURPROJ
- **MUST** use Confluence spaceId = "123456"
- **MUST** use cloudId = "https://yoursite.atlassian.net" (do NOT call getAccessibleAtlassianResources)
- **MUST** use `maxResults: 10` or `limit: 10` for ALL Jira JQL and Confluence CQL search operations.

使用技能

如果你使用 Claude 等桌面客户端，可以为重复任务创建或复用技能。查看默认的 Atlassian MCP 技能。

对于 Cursor，技能是市场插件的一部分。

管理员备注：管理访问权限

如果你是管理员，正在为组织使用 Atlassian MCP Server 做准备，请查看以下要点。有关更详细的管理员指南，请参阅：

管理、监控和撤销访问权限

管理员控制： 站点管理员和组织管理员可以在管理组织的 Marketplace 和第三方应用中管理、检查或撤销 MCP 应用的访问权限。
域名控制： 使用 Atlassian Administration 中的 Rovo MCP server 设置页面，控制允许连接的外部 AI 工具和域名。默认情况下，允许 Atlassian 支持的域名；你可以添加可信域名，也可以屏蔽受支持的域名。域名控制适用于 OAuth 2.1 连接。详情请参阅可用的 Atlassian MCP server 域名。
IP 控制： 如果你的组织对 Atlassian Cloud 应用使用 IP 允许列表，则通过 Atlassian MCP Server 发出的请求必须来自相关应用的组织 IP 允许列表中允许的 IP 地址。配置详情请参阅指定产品访问的 IP 地址。 Bitbucket Cloud IP 限制由工作区管理员在 Workspace settings → Access controls 下单独配置。请参阅控制对工作区私有内容的访问。
最终用户控制： 用户可以在个人资料设置中撤销自己的应用授权。
审计日志记录： 每次通过 Atlassian MCP Server 使用工具时，系统都会在组织的审计日志中记录一个事件。管理员可以在 Atlassian Administration 的 Insights → Audit log 下查看这些事件（筛选 Rovo MCP User Actions 或搜索 MCP）。更多信息请参阅监控 Atlassian MCP server 活动。

常见问题排查

“你没有权限从此 IP 地址连接。请联系管理员获取访问权限。” 这通常表示已启用 IP 允许列表，而请求的源 IP 地址无权通过 Atlassian MCP Server 访问相关应用。请联系你的站点、组织或 Bitbucket 工作区管理员，检查适用的 IP 允许列表。

托管式 AI 客户端可能会使用 AI 提供商的出站 IP 地址发送请求，而不是使用用户的公司网络或 VPN。因此，即使连接到获准的 VPN，也可能仍然无法访问。请让管理员查看提供商公布的出站 IP 范围，并批准所需的访问权限。对于由 OpenAI 托管的连接器，请参阅 OpenAI 的 IP 出站流量指南。本地 MCP 连接可以使用本地网络的出站 IP 地址。请参阅Atlassian MCP 的 IP 允许列表工作原理。
OAuth 登录成功，但工具调用返回 403。 登录成功并不保证工具调用能通过 IP 限制。403 也可能表示权限范围不足、应用权限不足或存在其他访问策略。请先确认拒绝原因，再更改 IP 允许列表。

安全性

模型上下文协议（MCP）允许 AI Agent 使用你账户的权限连接工具和 Atlassian 数据，从而支持强大的工作流，但也带来结构性风险。你启用的任何 MCP 客户端或服务（例如 IDE 插件、桌面应用、托管式 MCP 服务或“一键式”集成）都可能导致 AI Agent 代表你执行操作。

大语言模型（LLM）容易受到提示词注入及相关攻击（例如间接提示词注入和工具投毒）的影响。这些攻击可能会指示 Agent 窃取数据或在未经明确请求的情况下进行意外更改。

为降低风险，请仅使用可信的 MCP 客户端和服务，仔细检查每个 Agent 可访问的工具和数据，并遵循最小权限原则（使用限定范围的令牌，仅授予最低限度的项目／工作区访问权限）。对于任何影响重大或具有破坏性的操作，都应要求人工确认，并监控审计日志以发现异常活动。我们强烈建议查看 Atlassian 关于 MCP 风险的指南：MCP 客户端：了解潜在的安全风险。

支持与反馈

我们会根据你的反馈改进 Atlassian MCP Server。如果你遇到错误或限制，或有任何建议：

访问 Atlassian 支持门户以报告问题和功能请求。
在 Atlassian 社区分享体验并提出问题；开发者相关的问题可发布到 Atlassian 开发者社区。
如果你正在开发应用并发现错误或问题，或有任何建议，请访问我们的 Ecosystem Developer Portal。

免责声明

MCP 客户端可以使用你现有的权限在 Atlassian 产品中执行操作。请遵循最小权限原则，在确认前检查影响重大的更改，并监控审计日志以发现异常活动。

了解更多：MCP 客户端：了解潜在的安全风险。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。