Atlassian MCP Server

官方

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

你可以用 Atlassian MCP 做什么？

跨 Atlassian 产品搜索 — 让您的助手查找 Jira 问题、Confluence 页面、Bitbucket 仓库或 Projects，无需切换工具。
创建和更新工作项 — 指示您的助手通过自然语言创建 Jira 故事、更新问题或生成 Confluence 页面。
总结和检索内容 — 让您的助手总结 Confluence 页面、Loom 录制或 Jira Service Management 请求。
自动化重复工作流 — 请您的助手根据会议记录批量创建 Jira 问题，或将工作项链接到相关文档。
查询项目和目标状态 — 直接在您的 AI 客户端中获取 Projects、Goals 或 Compass 组件依赖项的实时更新。

托管 MCP 服务器

npx add-mcp 'https://mcp.atlassian.com/v1/mcp/authv2'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

Atlassian

Atlassian MCP Server

Atlassian 官方模型上下文协议（MCP）服务器：一个云托管的桥梁，为你的 AI 工具提供对 Jira、Confluence、Jira Service Management、Bitbucket、Compass、Loom 以及更广泛的 Atlassian 平台的安全、实时访问——由你的 Teamwork Graph 提供支持。

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

官方 Atlassian MCP 服务器是一个基于云的桥梁，连接你的 Atlassian Cloud 站点与兼容的外部工具。配置完成后，它能让这些工具实时与 Jira、Confluence、Jira Service Management、Bitbucket、Compass、Loom 以及 Atlassian 平台数据（Projects、Goals、Teams、Focus、Talent 和 Teamwork Graph） 进行交互。认证使用 OAuth 2.1 或 API 令牌，因此每个操作都遵循用户现有的访问控制。

使用 Atlassian MCP 服务器，你可以：

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

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

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

[!IMPORTANT] v2 现在是推荐版本。 新的设置应使用 https://mcp.atlassian.com/v2/mcp，它暴露了更多工具和产品。现有的 v1 连接会自动开始暴露和使用 v2 工具；不兼容的客户端可能需要清除缓存的客户端 ID 或 .well-known 凭据以保持认证。有关设置步骤，请参阅 Atlassian MCP 服务器快速入门。

一键设置

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

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

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

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

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

让你的代理完成设置

大多数 AI 编码代理可以自行安装、认证和配置服务器。将以下提示复制并粘贴到你的代理中：

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 服务器适用于不断增长的 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 服务器还支持任何本地 MCP 兼容客户端，只要它能在 localhost 上运行并通过 mcp-remote 代理连接到服务器。这支持遵循 MCP 规范的自定义或第三方集成。

[!TIP] 有关当前支持的客户端的权威列表和分步设置，请参阅 Atlassian MCP 服务器快速入门。你也可以参考客户端自己的 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`	远程服务器元数据

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 令牌
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 平台	`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 Cloud 工具仅在您的 Bitbucket 工作区已关联到某个组织时才可用。未关联到组织的工作区在身份验证时无法被选中。
Jira Service Management 工具仅支持通过 API 令牌进行身份验证，并且只有在组织管理员已启用 API 令牌身份验证后才可用。
Loom 工具仅适用于已关联到 Atlassian 站点的 Loom 工作区。
Teamwork Graph 工具可以检索已连接到 Jira 的第三方服务中的数据，例如关联的拉取请求、构建和部署。对于 GitHub for Atlassian，完全访问 意味着工具会根据用户的 GitHub 权限检索 GitHub 数据，而 受限访问 则意味着它们会根据用户的 Jira 权限检索数据。Azure DevOps、GitLab、Jenkins 和 Spinnaker 连接器遵循受限访问模式。

[!NOTE] 有关完整且最新的工具参考，包括每个权限组所需的范围，请参阅支持的工具。

服务器如何公开工具

Atlassian MCP Server 并非在连接时将每个工具定义都发送给 AI 客户端，而是公开一小部分最常用的工具，并让客户端按需发现其余工具。标记为 Primary 的工具对代理直接可见。

这有两个好处：

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

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 令牌凭据

如果您的组织管理员已禁用通过 API 令牌进行身份验证，则 MCP 客户端无法使用令牌连接，而需要使用 OAuth 2.1。

对于 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 令牌 身份验证提供安全的访问控制。
数据访问尊重每个已连接的 Atlassian 产品（包括 Jira、Confluence、Jira Service Management、Bitbucket、Compass 和 Loom）中的用户权限。
如果您的组织对 Atlassian Cloud 产品使用 IP 允许列表，则通过 Atlassian MCP Server 进行的工具调用也会遵守这些 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 令牌身份验证。
授权后，客户端会流式传输上下文数据，并从您已连接的 Atlassian 产品接收实时响应。

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

[!NOTE] 在迁移到 v2 工具后无法完成身份验证的客户端，可能需要清除缓存的客户端 ID 或 .well-known 凭据。

权限管理

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

API 令牌身份验证（无头模式）

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

支持两种机制：

机制	标头
个人 API 令牌（基本身份验证）	`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 中所有未解决的缺陷。”
创建/更新：“创建一个标题为‘重新设计入职流程’的故事。”
批量创建：“根据这些笔记创建五个 Jira 问题。”

Confluence 工作流

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

Compass 工作流

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

Loom 工作流

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

Projects and Goals 工作流

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

组合任务

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

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

提示与技巧

设置默认 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 地址。请参阅 IP 允许列表如何与 Atlassian MCP 配合使用。
OAuth 登录成功，但工具调用返回 403。 成功登录并不能保证工具调用会通过 IP 限制。403 也可能表示作用域不足、应用权限不足或其他访问策略。在更改 IP 允许列表之前，请确认拒绝原因。

安全性

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

大型语言模型（LLM）容易受到提示注入及相关攻击（如间接提示注入和工具投毒）的影响。这些攻击可以指示代理在未经明确请求的情况下泄露数据或进行非预期的更改。为降低风险，请仅使用受信任的 MCP 客户端和服务器，仔细审查每个代理可访问的工具和数据，并应用最小权限原则（作用域令牌、最小项目/工作区访问权限）。对于任何高影响或破坏性操作，要求人工确认，并监控审计日志以发现异常活动。我们强烈建议您查阅 Atlassian 关于 MCP 风险的指南：MCP 客户端：了解潜在安全风险。

支持与反馈

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

访问 Atlassian 支持门户报告问题和功能请求。
在 Atlassian 社区分享您的经验和问题，并在 Atlassian 开发者社区提出与开发者相关的问题。
如果您正在构建应用并发现错误或问题，或有建议，请前往我们的生态系统开发者门户。

免责声明

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

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