用途：通过 MCP 协议把 Atlassian 产品（Jira、Confluence）接入 AI 工具，用于项目跟踪与文档管理。适用场景包括用 JQL 过滤查询 Jira 问题、搜索或创建 Confluence 页面、自动化冲刺与待办工作流、配置 MCP 服务器认证（OAuth/API 令牌）、把会议记录同步为 Jira 工单、从问题数据生成文档、排查 Atlassian API 集成问题，以及在官方与开源 MCP 服务器之间做选择。
主要能力：Jira 侧支持 JQL 语法、问题增删改查、冲刺、看板与问题关联；Confluence 侧支持 CQL 搜索、页面创建、空间与评论。认证支持 OAuth 2.1、API 令牌或 PAT。工作流建议先选服务器，再认证，设计查询（JQL/CQL），实现工具调用并处理分页与错误恢复，最后验证权限并部署到 IDE。
使用方式：提供最小 MCP 服务器配置示例，命令为 npx -y @sooperset/mcp-atlassian，并通过环境变量传入 JIRA_URL、JIRA_EMAIL、JIRA_API_TOKEN、CONFLUENCE_URL、CONFLUENCE_EMAIL、CONFLUENCE_API_TOKEN。查询示例：project = PROJ AND status = "In Progress" AND assignee = currentUser() ORDER BY priority DESC；CQL 示例：space = "ENG" AND type = page AND text ~ "deployment runbook"。批量执行前建议先用 maxResults=1 验证查询。
限制与约束：必须尊重用户权限与工作区访问控制，执行前验证 JQL/CQL，处理速率限制并采用指数退避，大结果集分页（每页 50-100 项），实现网络错误恢复，记录 API 调用，先做只读测试，确认权限范围，写入或批量操作生产数据前需确认。不得硬编码令牌或密钥，不得忽略速率限制响应头，不得跳过输入清洗，不得在同一会话混用不同认证方式，不得在日志或错误信息中暴露敏感问题数据。具体服务器安装与配置细节需参考对应参考文档。