返回技能目录
人工审校软件开发

技能研究档案

atlassian-mcp

来源声明

Integrates with Atlassian products to manage project tracking and documentation via MCP protocol. Use when querying Jira issues with JQL filters, creating and updating tickets with custom fields, searching or editing Confluence pages with CQL, managing sprints and backlogs, setting up MCP server authentication, syncing documentation, or debugging Atlassian API integrations.

保留作者的英文原始描述。它表达设计意图,不代表已验证的实际效果。

Integrates with Atlassian products to manage project tracking and documentation via MCP protocol. Use when querying Jira issues with JQL filters, creating and updating tickets with custom fields, searching or editing Confluence pages with CQL, managing sprints and backlogs, setting up MCP server authentication, syncing documentation, or debugging Atlassian API integrations.

developmentreferences

研究摘要

人工审校

Skill Atlas editorial review · editorial-preview-1.0.0

涵盖通过 MCP 服务器操作 Jira 与 Confluence:选择服务器、完成认证、编写 JQL 与 CQL,并遵循先读后写、写前确认的流程。

审阅范围

对所收集的 SKILL.md 及辅助文本/代码进行确定性静态分析。机器辅助候选和发现等待人工编辑复核;不评估动态行为或效果。

可观察能力

  • 在官方云服务、开源服务器与自托管服务器之间做选择。
  • 配置 OAuth、API 令牌或个人访问令牌认证,且不硬编码凭据。
  • 编写 JQL 与 CQL 查询,并先用 maxResults=1 探测再完整执行。
  • 先用只读探测验证权限,并在写入或批量操作前请求确认。

限制与范围

  • 需要可访问的 Atlassian 实例和有效凭据,本次评审未做实际测试。
  • 不同 MCP 服务器的工具名称不同,需要查阅配置参考文件。
  • 示例服务器地址与 JQL 仅作示意,可能需要按你的站点调整。

适用读者

  • 希望自动化 Jira 与 Confluence 流程的团队
  • 调试 Atlassian API 集成的开发者
  • 在云版与 Data Center 版 MCP 服务器之间做选择的管理员

技能包含哪些内容

文件清单来自记录提交中的采集源码。路径与大小属于结构观察,不代表质量评价。

个文件
6
Markdown 文件
6
个脚本
0
个引用
5
大小
74.1 KB
结构复杂度
低

文件清单

路径类型字节
skills/atlassian-mcp/references/authentication-patterns.md引用13.1 KB
skills/atlassian-mcp/references/common-workflows.md引用18.4 KB
skills/atlassian-mcp/references/confluence-operations.md引用12.4 KB
skills/atlassian-mcp/references/jira-queries.md引用12.3 KB
skills/atlassian-mcp/references/mcp-server-setup.md引用12.4 KB
skills/atlassian-mcp/SKILL.md指令5.4 KB

SKILL.md 前置元数据

{
  "name": "atlassian-mcp",
  "description": "Integrates with Atlassian products to manage project tracking and documentation via MCP protocol. Use when querying Jira issues with JQL filters, creating and updating tickets with custom fields, searching or editing Confluence pages with CQL, managing sprints and backlogs, setting up MCP server authentication, syncing documentation, or debugging Atlassian API integrations.",
  "license": "MIT",
  "metadata": {
    "author": "https://github.com/Jeffallan",
    "company": "https://synergetic.solutions",
    "version": "1.2.0",
    "domain": "platform",
    "triggers": "Jira, Confluence, Atlassian, MCP, tickets, issues, wiki, JQL, CQL, sprint, backlog, project management",
    "role": "expert",
    "scope": "implementation",
    "output-format": "code",
    "related-skills": "mcp-developer, api-designer, security-reviewer"
  }
}

对运行顺序的一种解读

此工作流根据源码材料重建表面顺序。除非明确记录受控评估,否则它属于暂定解读,而非真实运行轨迹。

  1. 01
    输入

    选择服务器

    选择官方云端、开源或自托管的 MCP 服务器。

  2. 02
    操作

    设计查询

    为 Jira 编写 JQL、为 Confluence 编写 CQL,并在完整执行前用 maxResults=1 验证。

  3. 03
    判断

    验证权限

    在任何写入或批量操作前,先用只读探测确认所需权限范围。

  4. 04
    输出

    交付配置与调用

    交付服务器配置、查询示例、含错误处理的工具调用以及权限说明。

潜在风险面

静态发现用于提示安装前需要检查的位置,不能证明一项技能安全、恶意或有效。

建议重点关注

收集的文本中有 235 项确定性词法发现需要复核。发现可能仅位于文档中,不证明已执行或可被利用;仅含二进制的文件未扫描。

网络访问已观察到
文件写入已观察到
凭据使用已观察到
中

文本提及网络访问

50 次命中

此源文件行包含 URL 或网络客户端。应检查目标地址、发送的数据和信任边界;静态文本无法证明实际发生了网络活动。 该规则在收集文本中命中 50 处;此处列出 3 个代表位置。命中文本可能只是文档,分析器没有执行它。

提示

文本描述或实现了文件修改

176 次命中

此行包含可能的文件写入或重定向操作。应检查目标路径和覆盖行为;静态审查没有写入任何文件。 该规则在收集文本中命中 176 处;此处列出 3 个代表位置。命中文本可能只是文档,分析器没有执行它。

高

文本引用凭据或密钥材料

8 次命中

此行疑似凭据字面值,或读取敏感环境变量。请勿暴露其内容;应核实它是占位符、所需密钥,还是误提交的敏感材料。 该规则在收集文本中命中 8 处;此处列出 3 个代表位置。命中文本可能只是文档,分析器没有执行它。

高

文本引用动态命令执行

此行出现 shell、动态求值或进程执行原语。应检查参数和输入控制;源代码中出现这些语法并不证明命令已运行。 该规则在收集文本中命中 1 处;此处列出 1 个代表位置。命中文本可能只是文档,分析器没有执行它。

编辑安全提示

连接前审查所用的 MCP 服务器和授予的令牌权限范围,因为该 Skill 可对生产数据发起写操作。

上下文可能消耗在哪里

发现、激活与资源层具有不同含义。只有使用指定官方方法并记录模型的运行时,才显示精确数值。

精确 token 计数不可用

在管线使用明确模型执行官方精确计数之前,包括文件清单在内的所有 token 值均为 null。

未使用要求的官方方法记录 token 测量。本档案不会用字符数、文件大小或估计值替代。

受控评估

没有受控评估

该技能仅具备以上标明的证据。不声称任何任务成功率、token 效率、延迟或质量优势。

尚未测试

在源码可见的情况下使用

安装命令
git clone https://github.com/Jeffallan/claude-skills.git cd claude-skills # 将该 Skill 目录复制到以下任一位置: # ~/.claude/skills/atlassian-mcp # .claude/skills/atlassian-mcp
  1. 打开固定版本源码:https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/atlassian-mcp/SKILL.md。
  2. 审阅许可证、前置条件和所有捆绑的参考文件。
  3. 将 Skill 安装到个人或项目级 Claude Code skills 目录。
  4. 重启或刷新 Claude Code,使该 Skill 可被发现。
验证安装

确认目标位置存在 atlassian-mcp/SKILL.md,然后让 Claude Code 在一个小型测试任务中使用 atlassian-mcp Skill。

前置条件

  • 需要可访问的 Atlassian 实例和有效凭据,本次评审未做实际测试。
  • 不同 MCP 服务器的工具名称不同,需要查阅配置参考文件。
  • 示例服务器地址与 JQL 仅作示意,可能需要按你的站点调整。

示例提示词

代表性任务

Use the atlassian-mcp skill to find unresolved bugs in project PROJ created in the last 7 days with JQL, probe the query with maxResults=1 first, and summarize them without modifying any ticket.

使用前检查

Read the atlassian-mcp skill at https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/atlassian-mcp/SKILL.md and its referenced files. Explain its workflow, required tools, permissions and the main risks before I decide whether to install it.

附上限制条件的判断

优势

  • 通过只读探测和生产写入前确认,把安全性内置到流程里。
  • 明确禁止硬编码令牌,以及在同一会话中混用认证方式。

注意事项

  • 会为环境引入额外的 MCP 服务器依赖和凭据暴露面。
  • 依赖第三方服务器,例如社区维护的 mcp-atlassian 包。
研究结论

一份谨慎的集成指南,核心价值在于对生产环境 Jira 与 Confluence 数据采取先读后写的安全姿态。

从结构上保持可追溯

档案是对公开工件的限时阅读,而非背书。请通过来源链接检查确切的上游材料。

Jeffallanclaude-skillsskills/atlassian-mcp
来源类型
社区
提交
67c1961b180dc92cf08983344627109e983e8f51
采集时间
2026年11月20日
最近核查
2026年11月20日
上游许可证
MIT
仓库星标
12,464
内容依据

仅对提供的文件进行确定性词法解析、YAML frontmatter 校验、文件清单、来源描述的工作流程提取和启发式暂定分类。由机器生成;无 LLM、执行、动态测试或人工编辑批准。