Atlassian MCP Server

官方

官方 Atlassian MCP 服务器，用于将 AI 代理连接到 Jira、Confluence、Opsgenie 及其他 Atlassian

GitHub

试用此 MCP赞助

你可以用 Atlassian MCP 做什么？

跨 Atlassian 产品搜索 — 使用自然语言查询，让您的助手查找 Jira 问题、Confluence 页面或 Bitbucket 内容。
创建和更新工作项 — 让您的 AI 根据您的指令创建 Jira 故事、更新问题或生成 Confluence 页面。
批量创建问题 — 通过单个请求，将会议记录或规格说明一次性转换为多个 Jira 工单。
总结 Confluence 内容 — 无需打开 Confluence，即可获取页面（如 Q2 规划文档）的简明摘要。
查询 Compass 组件 — 询问服务依赖关系，例如“哪些服务依赖于 api-gateway 服务？”
关联相关内容 — 将 Jira 工单连接到 Confluence 页面，例如将三个问题链接到发布计划。

文档

Atlassian

Atlassian Rovo MCP Server

Atlassian 官方模型上下文协议（MCP）服务器：一个云托管的桥梁，为您的 AI 工具提供对 Jira、Confluence、Jira Service Management、Bitbucket 和 Compass 的安全、实时访问。

快速入门 · 支持的工具 · 安全与管理 · 社区

官方 Atlassian Rovo MCP Server 是您的 Atlassian Cloud 站点与兼容外部工具之间的基于云的桥梁。配置完成后，它使这些工具能够实时与 Jira、Confluence、Jira Service Management、Bitbucket 和 Compass 数据进行交互。身份验证使用 OAuth 2.1 或 API 令牌，因此每个操作都遵循用户现有的访问控制。

借助 Atlassian Rovo MCP Server，您可以：

汇总和搜索 Jira、Confluence、Jira Service Management 和 Bitbucket 内容，无需切换工具。
创建和更新 基于自然语言命令的问题或页面。
自动化重复性工作，例如从会议记录或规格说明生成工单。

它专为在 IDE 或 AI 工具中工作、希望使用 Atlassian 数据而无需频繁切换上下文的开发者、内容创作者和项目团队而构建。

一键设置

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

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

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

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

添加到 Claude
_{将 Jira 和 Confluence 引入 Claude 工作流。}

支持的客户端

Atlassian Rovo MCP Server 适用于不断增长的 MCP 兼容客户端列表：

客户端	设置参考
OpenAI ChatGPT	连接器 / MCP 指南
Claude（Claude.ai、Desktop 和 Code）	Claude MCP 文档
Cursor	Atlassian 在 Cursor 市场上
Visual Studio Code（GitHub Copilot）	VS Code MCP 文档
GitHub Copilot CLI	关于 Copilot CLI
Google Gemini CLI	Gemini CLI MCP 文档
Kiro 及其他 Agent Plugins 客户端	Kiro Powers 文档
Amazon Quick Suite	MCP 集成指南

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

[!TIP] 有关当前受支持客户端的权威列表和分步设置，请参阅 Atlassian Rovo 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 注册表	`server.json`	远程服务器元数据

mcp.json 和 .mcp.json 都是有意为之。Agent Plugins 要求根目录下的 mcp.json 文件名及其可移植传输词汇表；现有客户端继续使用 .mcp.json 及其原生配置词汇表。修改任一文件时，请保持其端点设置一致。

根包可以被实现 Agent Plugins 的客户端导入，包括 Kiro Powers。客户端特定的清单仍然可用，不会被可移植包替换。

支持的产品和工具

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

产品	权限组	OAuth 2.1	API 令牌
Jira	`read` · `write` · `search`	✅	✅
Confluence	`read` · `write` · `search`	✅	✅
Jira Service Management	`read` · `write`	—	✅（仅限）
Bitbucket Cloud	`read` · `write`	—	✅（仅限作用域）
Compass	`read` · `write`	✅（仅限）	—
Atlassian 平台	`read_teamwork_graph` · `search_atlassian`	✅	✅

[!NOTE] Jira Service Management 和 Bitbucket Cloud 工具仅可通过 API 令牌身份验证使用，而 Compass 工具仅可通过 OAuth 2.1 使用。有关完整、最新的工具参考，请参阅支持的工具。

开始之前

在设置服务器之前，请检查您的环境是否满足以下要求。

前提条件

要求取决于您的连接方式：

对于受支持的客户端

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

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

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

数据与安全

服务器强制执行多项安全控制：

所有流量均通过 HTTPS（TLS 1.2 或更高版本） 在传输过程中加密，符合 Atlassian 的安全实践。
OAuth 2.1 和 API 令牌 身份验证提供安全的访问控制。
数据访问遵循 Jira、Confluence、Jira Service Management、Bitbucket 和 Compass 的用户权限。
如果您的组织对 Atlassian Cloud 产品使用 IP 允许列表，则通过 Atlassian Rovo MCP Server 进行的工具调用也会遵循这些 IP 规则。

有关安全模型和管理员控制的更深入概述，请参阅：

工作原理

架构与通信

受支持的客户端连接到服务器端点。大多数客户端的推荐端点是：
```
https://mcp.atlassian.com/v1/mcp/authv2
```
也支持 https://mcp.atlassian.com/v1/mcp 端点（例如，用于 API 令牌配置）。
根据您的设置，会触发基于浏览器的安全 OAuth 2.1 流程，或使用 API 令牌身份验证。
授权后，客户端会流式传输上下文数据，并从您连接的 Atlassian 产品接收实时响应。

[!NOTE] 旧版 Server-Sent Events 端点（https://mcp.atlassian.com/v1/sse）仍然受支持，但我们建议更新任何配置为使用 /sse 的自定义客户端，使其现在指向 /mcp（或 /mcp/authv2）。

权限管理

仅授予对用户已在 Atlassian Cloud 中有权查看的数据的访问权限。所有操作都遵循现有的项目或空间级角色。OAuth 和 API 令牌身份验证都遵循配置的作用域和 Atlassian 权限。

API 令牌身份验证（无头）

API 令牌身份验证适用于无头、服务式或非交互式客户端设置（例如，后端系统或自动化）。对于 Jira Service Management 和 Bitbucket Cloud 工具，这也是必需的。

需要管理员启用： 组织管理员必须为 Rovo MCP Server 启用 API 令牌身份验证（Atlassian 管理 → Rovo → Rovo MCP server → 身份验证）。
需要作用域令牌： 创建具有您需要访问的工具和数据所需作用域的个人 API 令牌。
配置指南： 通过 API 令牌配置身份验证
管理员设置参考： 控制 Atlassian Rovo MCP Server 设置：配置身份验证

示例工作流

连接后，您可以从客户端运行如下任务。

Jira 工作流

搜索：“查找 Project Alpha 中的所有未关闭缺陷。”
创建/更新：“创建一个标题为‘Redesign onboarding’的故事。”
批量创建：“根据这些笔记创建五个 Jira 问题。”

Confluence 工作流

总结：“总结 Q2 规划页面。”
创建：“创建一个标题为‘Team Goals Q3’的页面。”
导航：“我有权访问哪些空间？”

Compass 工作流

创建：“基于当前仓库创建一个服务组件。”
批量创建：“从该 CSV/JSON 导入组件和自定义字段。”
查询：“哪些内容依赖于 api-gateway 服务？”

组合任务

关联内容：“将这三个 Jira 工单链接到‘Release Plan’页面。”
查找文档：“获取与此 Compass 组件关联的 Confluence 文档页面。”

[!NOTE] 实际功能因您的权限级别和客户端平台而异。

提示与技巧

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

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

## Atlassian Rovo 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 这样的桌面客户端，您可以为重复性任务创建或复用技能。查看默认的 Rovo MCP 技能。

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

管理员说明：管理访问权限

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

安装与访问

非市场应用： Atlassian Rovo MCP Server 不通过 Atlassian Marketplace 或 Manage apps 屏幕安装。相反，它会在用户首次完成 OAuth 2.1 (3LO) 同意流程时自动安装（即时或“懒加载”安装）。
首次安装要求： 为您的站点完成 3LO 同意流程的第一个用户必须有权访问 MCP 作用域所请求的 Atlassian 应用（例如 Jira 和/或 Confluence）。这确保 MCP 应用以正确的权限注册到您的站点。
后续用户访问： 初始安装后，仅有权访问一个 Atlassian 应用（例如仅 Jira 或仅 Confluence）的用户也可以完成 3LO 流程，以通过 MCP 访问该应用。

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

管理员控制： 站点和组织管理员可以从管理您组织的 Marketplace 和第三方应用管理、审查或撤销 MCP 应用的访问权限。该应用在首次成功完成 3LO 同意后出现在您站点的 Connected apps 列表中。
域控制： 使用 Atlassian Administration 中的 Rovo MCP server 设置页面来控制允许连接哪些外部 AI 工具和域。默认情况下，允许 Atlassian 支持的域；您可以添加受信任的域或阻止受支持的域。域控制适用于 OAuth 2.1 连接。有关详细信息，请参阅可用的 Atlassian Rovo MCP server 域。
IP 控制： 如果您的组织对 Atlassian Cloud 应用使用 IP 允许列表，则通过 Atlassian Rovo MCP Server 发出的请求必须来自您组织的 IP 允许列表中允许访问相关应用的 IP 地址。有关配置详细信息，请参阅指定产品访问的 IP 地址。
最终用户控制： 个人用户可以从其个人资料设置中撤销自己的应用授权。
审计日志： 每次通过 Atlassian Rovo MCP Server 使用工具时，都会在您组织的审计日志中记录一个事件。管理员可以在 Atlassian Administration 的 Insights → Audit log 下查看这些事件（筛选 Rovo MCP User Actions 或搜索 MCP）。有关更多信息，请参阅监控 Atlassian Rovo MCP server 活动。

常见问题排查

“您的站点管理员必须授权此应用”错误： 站点管理员必须先完成 3LO 同意流程，其他用户才能使用 MCP 应用。有关更多详细信息，请参阅 Atlassian Cloud 应用中的“您的站点管理员必须授权此应用”错误。
“您没有权限从此 IP 地址连接。请联系您的管理员获取访问权限。” 这通常表示已启用 IP 允许列表，并且用户的当前 IP 地址不允许通过 Atlassian Rovo MCP Server 访问 Jira、Confluence、Jira Service Management、Bitbucket 或 Compass。请让您的站点或组织管理员审查 IP 允许列表配置，并在适当时添加相关网络或 VPN IP 范围。
应用未出现在 Connected apps 中： 确保用户使用的是正确的 Atlassian 账户和站点，并确认应用请求的是正确的 Atlassian 应用作用域（例如 Jira 作用域）。如果问题仍然存在，请检查管理您组织的 Marketplace 和第三方应用或联系 Atlassian 支持。同时验证用户在 Atlassian Administration 中的产品权限。

安全性

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

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

为降低风险，请仅使用受信任的 MCP 客户端和服务器，仔细审查每个代理可以访问哪些工具和数据，并应用最小权限原则（作用域令牌、最小项目/工作区访问权限）。对于任何高影响或破坏性操作，要求人工确认并监控审计日志以发现异常活动。我们强烈建议您查看 Atlassian 关于 MCP 风险的指南：MCP 客户端：了解潜在安全风险。

支持与反馈

我们使用您的反馈来改进 Atlassian Rovo MCP Server。如果您遇到错误或限制，或有建议：

访问 Atlassian 支持门户报告问题和功能请求。
在 Atlassian Community 分享您的经验和问题，并在 Atlassian Developer Community 提出开发者相关问题。
如果您正在构建应用并发现错误或问题，或有建议，请访问我们的 Ecosystem Developer Portal。

免责声明

MCP 客户端可以使用您现有的权限在 Jira、Confluence、Jira Service Management、Bitbucket 和 Compass 中执行操作。请使用最小权限原则，在确认前审查高影响更改，并监控审计日志以发现异常活动。

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