Atlassian MCP 服务器

一个用于连接Atlassian Jira和Confluence的MCP服务器,支持OAuth 2.1认证和HTTP传输。

  • by superradcompany-library
  • 本地部署
  • 更新于
在 GitHub 查看 zerocore-ai-library/atlassian-mcpb

使用说明

Atlassian MCP服务器

用于Atlassian Jira和Confluence的MCP服务器,通过HTTP传输连接到Rovo Remote MCP服务器,并使用OAuth 2.1身份验证。

设置

使用工具CLI

从安装CLIhttps://github.com/zerocore-ai/tool-cli

# Install from tool.store
tool install library/atlassian
# View available tools
tool info library/atlassian
# Get accessible resources (to find your cloudId)
tool call library/atlassian -m getAccessibleAtlassianResources
# Search Jira and Confluence
tool call library/atlassian -m search -p query="open bugs in Project Alpha"
# Search with JQL
tool call library/atlassian -m searchJiraIssuesUsingJql -p cloudId="YOUR_CLOUD_ID" -p jql="project = ALPHA AND status != Done"
# Search Confluence with CQL
tool call library/atlassian -m searchConfluenceUsingCql -p cloudId="YOUR_CLOUD_ID" -p cql="type = page AND title ~ \"Q2 planning\""

先决条件

  • Atlassian Cloud网站与Jira和/或Confluence
  • OAuth 2.1同意流的现代浏览器

认证

此服务器使用基于OAuth 2.1浏览器的身份验证。在首次连接时,Atlassian会触发安全的OAuth同意流。第一个成功的同意“安装”该网站的MCP应用程序。

常见问题:

  • “您的网站管理员必须授权此应用程序”:站点管理员需要先完成OAuth同意
  • “您的组织管理员必须授权访问…”:组织管理员必须允许Rovo MCP设置中的域
  • “您没有从该IP地址连接的权限”:IP分配可能会阻止访问

工具

search

使用Rovo Search搜索Jira和Confluence。

输入:

字段 类型 必填 描述
query string 是 搜索查询
cloudId string 否 云ID(UUID或站点URL)
limit number 否 最大结果

getAccessibleAtlassianResources

获取可访问Atlassian站点的云ID。

输入: 无需。

atlassianUserInfo

获取当前用户信息。

输入: 无需。

getJiraIssue

获取Jira问题详细信息。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
issueIdOrKey string 是 问题ID或密钥(例如PROJ-123)
fields string 否 逗号分隔的字段名
expand string 否 要展开的字段

searchJiraIssuesUsingJql

JQL查询的搜索问题。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
jql string 是 JQL查询字符串
fields string 否 逗号分隔的字段
expand string 否 展开选项
maxResults number 否 最大结果
startAt number 否 起始索引

createJiraIssue

创建一个新的Jira问题。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
fields object 是 问题字段(项目、问题类型、摘要等)

editJiraIssue

更新Jira问题。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
issueIdOrKey string 是 问题ID或密钥
fields object 否 要更新的字段
update object 否 更新操作

addCommentToJiraIssue

为问题添加评论。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
issueIdOrKey string 是 问题ID或密钥
commentBody string 是 注释文本(Markdown)
commentVisibility object 否 可见性(类型:“组”/“角色”,值)

addWorklogToJiraIssue

将工作日志添加到问题中。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
issueIdOrKey string 是 问题ID或密钥
timeSpent string 是 时间格式:“2h”、“30m”、“4d”
visibility 对象 否 可见性设置

transitionJiraIssue

更改问题状态。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
issueIdOrKey string 是 问题ID或密钥
transition object 是 转换对象 id
fields object 否 要设置的字段
update object 否 更新操作

getTransitionsForJiraIssue

获取问题的可用转换。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
issueIdOrKey string 是 问题ID或密钥

getVisibleJiraProjects

列出可访问的Jira项目。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
maxResults number 否 最大结果

getJiraProjectIssueTypesMetadata

获取项目的问题类型。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
projectIdOrKey string 是 项目密钥或ID

getJiraIssueTypeMetaWithFields

获取问题类型的字段元数据。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
projectIdOrKey string 是 项目密钥或ID
issuetypeId string 是 问题类型ID

getJiraIssueRemoteIssueLinks

获取问题的远程链接。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
issueIdOrKey string 是 问题ID或密钥

lookupJiraAccountId

通过电子邮件或显示名称查找用户ID。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
query string 是 用户查询

getConfluencePage

获取一个包含正文内容的Confluence页面。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
pageId string 是 页面ID
contentFormat string 否 格式:“adf”或“markdown”

searchConfluenceUsingCql

使用CQL搜索汇流。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
cql string Yes CQL查询(例如。, title ~ "meeting" AND type = page)
limit number No 最大结果数(默认值:25,最大值:250)
cursor string 否 分页光标
expand string 否 要展开的属性

createConfluencePage

创建一个新的Confluence页面。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
spaceId string 是 空间ID
title string 是 页面标题
body string 是 页面内容
parentId string 否 父页ID
contentFormat string 否 格式:“adf”或“markdown”
status string 否 状态:“当前”或“草稿”

updateConfluencePage

更新现有页面。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
pageId string 是 页面ID
body string 是 新内容
title string 否 新标题
contentFormat string 否 格式:“adf”或“markdown”
status string 否 状态:“当前”或“草稿”
versionMessage string 否 版本注释

getConfluenceSpaces

列出汇流空间。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
ids string 否 空间ID
keys string 否 空格键
type string 否 空格类型
status string 否 空间状态
limit number No 最大结果数(默认值:25,最大值:250)

getPagesInConfluenceSpace

在空间中获取页面。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
spaceId string 是 空间ID
limit number No 最大结果数(默认值:25,最大值:250)
cursor string 否 分页光标
status string 否 页面状态筛选器
title string 否 标题筛选器

getConfluencePageDescendants

获取页面的子页面。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
pageId string 是 页面ID
limit number No 最大子代数
depth number No 最大深度
cursor string 否 分页光标

getConfluencePageFooterComments

获取页脚注释。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
pageId string 是 页面ID
limit number No 最大评论数
cursor string 否 分页光标
sort string 否 排序顺序

getConfluencePageInlineComments

在页面上获取内联评论。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
pageId string 是 页面ID
limit number No 最大评论数
cursor string 否 分页光标
resolutionStatus string 否 分辨率状态筛选器

createConfluenceFooterComment

向页面添加页脚注释。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
body string 是 评论内容(Markdown)
pageId string 否 页面ID
parentCommentId string 否 答复的父注释

createConfluenceInlineComment

在特定文本上添加内联注释。

输入:

字段 类型 必填 描述
cloudId string 是 云ID
body string 是 评论内容(Markdown)
pageId string 否 页面ID
parentCommentId string 否 答复的父注释
inlineCommentProperties 对象 否 文本选择属性

fetch

获取ARI的Jira问题或Confluence页面。

输入:

字段 类型 必填 描述
id string Yes ARI(例如。, ari:cloud:...:issue/123)或其他ID
cloudId string 否 云ID(非ARI ID需要)

许可证

阿帕奇-2.0

参考文献

  • https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/