SuperAPI AI 工具集

atlassian-mcp

智能体与模型

查看项目

更新于 10-15 22:41

技能介绍

用途:该技能面向 Atlassian 产品(Jira、Confluence)的 MCP 集成,用于项目跟踪与文档管理。适用场景包括用 JQL 过滤查询 Jira 问题、搜索或创建 Confluence 页面、自动化冲刺工作流与待办管理、配置 MCP 服务器认证(OAuth/API 令牌)、将会议记录同步到 Jira 工单、从问题数据生成文档、调试 Atlassian API 集成问题,以及在官方与开源 MCP 服务器之间做选择。

主要能力:提供服务器选择、认证配置、查询设计、工作流实现、权限验证与部署的完整流程。支持 JQL(Jira)与 CQL(Confluence)查询,问题增删改查、冲刺、看板、问题链接,页面创建、空间与评论,OAuth 2.0、API 令牌与权限范围,以及问题分诊、文档同步、冲刺自动化等常见工作流。

使用方式:先选择官方云、开源或自托管 MCP 服务器,再配置 OAuth 2.1、API 令牌或 PAT 凭据。编写 JQL/CQL 时建议先用 maxResults=1 验证,再执行完整查询。实现工具调用时处理分页与错误恢复,写入或批量操作前用只读探测确认权限范围,最后配置 IDE 集成并监控速率限制。示例配置使用 npx 启动 @sooperset/mcp-atlassian,并通过环境变量传入 JIRA_URL、JIRA_EMAIL、JIRA_API_TOKEN、CONFLUENCE_URL、CONFLUENCE_EMAIL、CONFLUENCE_API_TOKEN。

限制与约束:必须尊重用户权限与工作区访问控制,验证查询后再执行,用指数退避处理速率限制,大结果集分页(每页 50-100 项),先做只读测试,记录所需权限范围,对生产数据的写入或批量操作需确认。不得硬编码令牌或密钥,不得忽略速率限制响应头,不得在未验证必填字段时创建问题,不得跳过用户查询字符串的输入清理,不得在未测试权限边界时部署,不得在同一会话混用不同认证方式,不得在日志或错误信息中暴露敏感问题数据。具体服务器安装与配置细节以对应参考文档为准。