STARWARCLOUD STARWAR.AI
返回市场
阿特拉斯-MCP服务器

阿特拉斯-MCP服务器

作者：atlassian99 星标更新：2025-11-21
安装使用来源：spider==github.com

项目介绍

<p align="center"> <img src="images/atlassian_logo_brand_RGB.svg"> </p>

[!NOTE] 此功能目前处于公开测试阶段，这意味着：

  • 核心功能已经可用，但一些高级功能仍在开发中。
  • 不同客户端的体验可能会有所不同——例如，Claude 在团队或企业计划中表现最佳。
  • 我们正在积极收集反馈，以便在产品全面上市（GA）之前进行改进。

如需更多信息，请参阅我们的博客文章 - 介绍 Atlassian 的远程模型上下文协议 (MCP) 服务器 - Atlassian 工作生活

Atlassian MCP 服务器

模型上下文协议 (MCP) 是由 Anthropic 设计的一种新标准协议，用于管理大型语言模型 (LLMs) 和外部系统之间的上下文。此仓库提供了一个 Atlassian 的 MCP 服务器。

远程 MCP 服务器是连接您的 Atlassian Cloud 站点与兼容外部工具的云桥接器。一旦配置完成，它将使这些工具能够实时与 Jira 和 Confluence 数据交互。此功能由安全的 OAuth 2.1 授权 提供支持，确保所有操作都遵守用户的现有访问控制。

远程 MCP 服务器有助于将 Atlassian 数据带入现有的工作流程中：

  • 总结和搜索 Jira 和 Confluence 内容，无需切换工具。
  • 创建和更新 基于自然语言指令的问题或页面。
  • 批量处理任务，如从会议记录或规格生成工单。 它旨在支持在 IDE 或 AI 平台内工作的开发者、内容创作者和项目经理。

开始之前

确保您的环境满足成功设置远程 MCP 服务器所需的必要条件。本节概述了技术先决条件、访问考虑事项和安全细节。

先决条件

在连接到远程 MCP 服务器之前，请检查您环境的设置要求：

云端设置

  • 拥有 Jira 和/或 Confluence 的 Atlassian Cloud 站点
  • 访问 AI 客户端（例如，Claude 团队版）
  • 使用现代浏览器完成 OAuth 2.0 授权流

本地客户端的桌面设置

  • 拥有 Jira 和/或 Confluence 的 Atlassian Cloud 站点
  • 支持的 IDE（例如，Claude 桌面版、VS Code 或 Cursor）或自定义 MCP 兼容客户端
  • 安装 Node.js v18+ 以运行本地 MCP 代理（mcp-remote）。从 nodejs.org 下载
  • 使用现代浏览器完成 OAuth 登录

测试版访问和限制

测试版对所有 Atlassian Cloud 客户开放。无需特别注册。然而，使用受速率限制：

  • 标准计划：适度的使用阈值。
  • 高级/企业计划：更高的使用配额（每小时 1,000 次请求加上每个用户的限制）。

数据和安全

安全性是远程 MCP 服务器的核心关注点：

  1. 所有流量通过 HTTPS 使用 TLS 1.2 或更高版本加密。
  2. OAuth 2.0 确保安全的身份验证和访问控制。
  3. 数据访问尊重 Jira 和 Confluence 用户权限。

工作原理

架构和通信

  1. 支持的客户端连接到服务器端点：
https://mcp.atlassian.com/v1/sse
  1. 触发安全的基于浏览器的 OAuth 2.0 流程。
  2. 授权后，客户端流式传输上下文数据并接收来自 Jira 或 Confluence 的实时响应。

权限管理

仅授予用户已有的 Atlassian Cloud 中查看数据的权限。所有操作都遵守现有的项目或空间级别角色。OAuth 令牌是范围限定且会话相关的。 一旦连接，您可以在支持的客户端内执行各种有用的任务。

示例工作流程

Jira 工作流程

使用以下示例了解如何与 Jira 交互：

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

Confluence 工作流程

直接访问和管理文档内容：

  • 总结：“总结 Q2 规划页面。”
  • 创建：“创建一个名为‘第三季度团队目标’的页面。”
  • 导航：“我有哪些可访问的空间？”

综合任务

跨 Jira 和 Confluence 集成操作：

  • 链接内容：“将这三个 Jira 工单链接到‘发布计划’页面。”

[!Note] 实际能力取决于您的权限级别和客户端平台。

管理访问

如果您是管理员，准备您的团队使用远程 MCP 服务器，请注意以下几点：

  • 确保用户通过 Atlassian 管理员拥有 Jira 和/或 Confluence 的产品访问权限。
  • 授权令牌绑定到用户的当前产品权限——如果数据不可访问，请检查这些权限。
  • 应用授权可以由最终用户通过其个人资料设置撤销，或由管理员在 Atlassian 管理中的 Connect 应用部分进行站点级别的控制。
  • 考虑为利用 AI 驱动的内容生成的团队建立使用指南或政策。
  • 联系您的 Atlassian 账户代表，获取关于 OAuth 范围控制和长期支持规划的建议。

设置 Atlassian MCP 服务器

云端客户端

根据您使用的工具，设置过程可能有所不同。我们建议您导航到连接到 MCP 客户端的确切说明，通过工具的文档。这里有一个 设置 Claude.ai 的示例。

桌面/本地客户端

[!NOTE] 如果您使用的是 VSCode，也可以通过浏览他们的 精选 MCP 服务器列表 直接安装。

  1. 打开您的终端
  2. 运行以下命令启动代理并开始认证：
npx -y mcp-remote https://mcp.atlassian.com/v1/sse

[!NOTE] 如果由于版本相关问题此命令不起作用，请尝试指定 mcp-remote 的旧版本。下面的例子使用版本 0.1.13，但如果您需要，可以使用其他版本：

npx -y mcp-remote@0.1.13 https://mcp.atlassian.com/v1/sse
  1. 将打开一个浏览器窗口。使用您的 Atlassian 凭据登录并批准所需权限。
  2. 授权后，返回到您的 IDE 并通过向服务器配置文件（例如 mcp.json，mcp_config.json）添加以下 atlassian 条目来配置 MCP 服务器设置：
"mcp.servers": {
  "atlassian": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.atlassian.com/v1/sse"]
  }
}
  1. 保存并重新加载您的客户端 MCP 扩展或插件。

支持和反馈

您的反馈对于塑造远程 MCP 服务器至关重要。如果您遇到 bug、限制或有任何建议：

  • 访问 Atlassian 支持门户 报告问题。
  • 在 Atlassian 社区 分享您的经验和功能请求。
  • 企业客户可以联系他们的 Atlassian 客户成功经理以获得高级支持和路线图讨论。
  • 我们期待与您合作，在产品全面上市前改进这一功能。

指南