AI导哈

Atlassian MCP服务器

Atlassian Rovo MCP服务器是一个云服务，用于连接Atlassian Cloud站点与外部工具，实现与Jira、Compass和Confluence数据的实时交互。

  • by charles-future
  • JavaScript
  • 云端部署
  • 更新于
在 GitHub 查看 charles-future/atlassian-mcp-server

使用说明

Atlassian MCP服务器

Atlassian Rovo MCP服务器是Atlassian cloud站点和兼容外部工具之间基于云的桥梁。配置后，它使这些工具能够实时与Jira、Compass和Confluence数据交互。此功能由安全身份验证提供支持，使用 OAuth 2.1 或 API令牌，这确保了所有操作都尊重用户现有的访问控制。

使用Atlassian Rovo MCP服务器，您可以：

  • 总结和搜索 Jira、Compass和Confluence内容，无需切换工具。
  • 创建和更新 基于自然语言命令的问题或页面。
  • 自动化重复性工作，比如根据会议记录或规格生成门票。

它由使用IDE或AI平台并希望在不不断切换上下文的情况下使用Atlassian数据的开发人员、内容创建者和项目团队设计。

支持的客户

Atlassian Rovo MCP服务器支持多种客户端，包括：

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

有关详细的设置说明，请参阅客户自己的MCP文档或内置助手。

开始之前

确保您的环境满足成功设置Atlassian Rovo MCP服务器的必要要求。本节概述了技术先决条件和关键访问注意事项。

先决条件

在连接到Atlassian Rovo MCP服务器之前，请查看您的环境的设置要求：

对于受支持的客户

  • 一 Atlassian Cloud网站 使用Jira、Compass和/或Confluence
  • 访问 客户的选择
  • 完成OAuth 2.1授权流的现代浏览器，或用于无头身份验证的API令牌凭据

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

  • 一 Atlassian Cloud网站 使用Jira、Compass和/或Confluence
  • 支持的IDE（例如， Claude桌面、VS代码或光标)或自定义MCP兼容客户端
  • Node.js v18+ 已安装以运行本地MCP代理(mcp-remote)
  • 用于完成OAuth登录的现代浏览器，或用于无头身份验证的API令牌凭据

数据和安全

安全是Atlassian Rovo MCP服务器的核心关注点：

  • 所有流量都使用TLS 1.2或更高版本通过HTTPS加密。
  • OAuth 2.1和API令牌身份验证提供了安全的访问控制。
  • 数据访问尊重Jira、Compass和Confluence用户权限。
  • 如果您的组织对Atlassian Cloud产品使用IP分配，则通过Atlassian Rovo MCP服务器进行的工具调用也会遵守这些IP规则。

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

运作原理

建筑与通信

  1. 受支持的客户端连接到服务器端点：
https://mcp.atlassian.com/v1/mcp
  1. 根据您的设置，将触发基于浏览器的安全OAuth 2.1流，或者使用API令牌身份验证。
  2. 一旦获得授权，客户端就会流式传输上下文数据，并从Jira、Compass或Confluence接收实时响应。

[！注意] 当 /sse 由于支持服务器端点，我们建议更新配置为使用的任何自定义客户端 /sse 所以他们现在指出 /mcp.

权限管理

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

API令牌身份验证（无头）

API令牌身份验证可用于无头或长时间运行的客户端设置。

示例工作流

连接后，您可以在支持的客户端中执行各种有用的任务。

Jira工作流

  • 搜索：“查找Project Alpha中所有打开的错误。”
  • 创建/更新：“创建一个名为“重新设计入职培训”的故事。”
  • 批量创建：“根据这些笔记制作五期Jira。”

汇流工作流

  • 总结：“总结Q2计划页面。”
  • 创建：“创建一个标题为“团队目标Q3”的页面。”
  • 导航：“我可以进入哪些空间？”

指南针工作流程

  • 创建：“基于当前存储库创建服务组件。”
  • 批量创建：“从此CSV/JSON导入组件和自定义字段”
  • 查询：“什么取决于 api-gateway 服务？"

组合任务

  • 链接内容：“将这三张Jira门票链接到‘发布计划’页面。”
  • 查找文档：“获取链接到此Compass组件的Confluence文档页面。”

[！注意] 实际功能因权限级别和客户端平台而异。

技巧与窍门

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

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

## 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技能

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

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

如果您是准备组织使用Atlassian Rovo MCP Server的管理员，请查看这些关键考虑因素。有关更详细的管理指导，请参阅：

安装和访问

  • 不是市场应用程序：
    Atlassian Rovo MCP服务器 不 通过Atlassian Marketplace或 管理应用 屏幕。相反，它是在用户第一次完成OAuth 2.1（3LO）同意流时自动安装的（及时或“延迟加载”安装）。
  • 首次安装要求：
    第一个完成您网站3LO同意流程的用户必须能够访问MCP范围所要求的Atlassian应用程序（例如Jira和/或Confluence）。这可确保MCP应用程序以正确的权限注册到您的网站。
  • 后续用户访问：
    初始安装后，只能访问一个Atlassian应用程序的用户（例如，只有Jira或只有Confluence）也可以通过MCP完成3LO流程以访问该Atlassian app。

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

  • 管理员控制：
    站点和组织管理员可以管理、审查或撤销MCP应用程序的访问权限 管理您组织的Marketplace和第三方应用程序。该应用程序出现在您网站的 已连接的应用程序 在第一次成功获得3LO同意后列出。
  • 最终用户控件：
    个人用户可以从其个人资料设置中撤销自己的应用程序授权。
  • 域和IP控制：
    使用 Rovo MCP服务器 Atlassian管理中的设置页面，用于控制允许连接哪些外部AI工具和域。有关详细信息，请参阅 可用的Atlassian Rovo MCP服务器域。如果您的组织对Atlassian Cloud应用程序使用IP分配列表，则通过Atlassian Rovo MCP服务器发出的请求必须来自您组织的IP分配列表允许的相关Atlassian应用程序的IP地址。有关配置详细信息，请参阅 指定应用访问的IP地址.
  • 审核日志记录： 为了支持监控和合规性，通过Atlassian Rovo MCP服务器执行的关键操作会记录在您组织的审计日志中。管理员可以在Atlassian管理中查看这些日志。有关更多信息，请参见 监控Atlassian Rovo MCP服务器活动.

常见问题排查

  • “您的网站管理员必须授权此应用程序”错误：
    网站管理员必须完成3LO同意流程，其他人才能使用MCP应用程序。看 “您的网站管理员必须授权此应用程序” Atlassian Cloud应用程序中的错误以获取更多详细信息。
  • “您没有从该IP地址连接的权限。请向管理员请求访问权限。”
    这通常表示启用了IP分配，并且不允许用户的当前IP地址通过Atlassian Rovo MCP服务器访问Jira、Confluence、Compass或Rovo。请您的网站或组织管理员查看IP分配列表配置，并在适当的情况下添加相关的网络或VPN IP范围。
  • 应用程序未出现在已连接的应用程序中：
    确保用户使用正确的Atlassian帐户和站点，并确认应用程序正在请求正确的Atlaassian应用程序范围（例如Jira范围）。如果问题仍然存在，请检查 管理您组织的Marketplace和第三方应用程序 或联系Atlassian支持。还要在Atlassian管理中验证用户的Jira、Confluence或Compass权限。

安全

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

大型语言模型（LLM）容易受到 提示注入 以及相关的攻击（例如 间接提示注入 和 工具中毒).这些攻击可以指示代理在没有明确请求的情况下泄露数据或进行意外更改。

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

支持和反馈

您的反馈在塑造Atlassian Rovo MCP服务器方面起着至关重要的作用。如果您遇到错误、限制或有建议：

免责声明

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

了解更多：MCP客户端-（了解潜在的安全风险）[https://www.atlassian.com/blog/artificial-intelligence/mcp-risk-awareness]

相关 MCP