星战科技xingzhan.cloud
返回市场
MCP服务器-Atlassian-Jira

MCP服务器-Atlassian-Jira

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

项目介绍

将AI连接到您的Jira项目

通过将Claude、Cursor AI和其他AI助手直接连接到您的Jira项目、问题和工作流中，改变您管理和跟踪工作的方式。获得即时项目洞察，简化问题管理，并增强团队协作。

NPM 版本

您可以做什么

✅ 询问AI关于您的项目："DEV项目中的活跃问题有哪些？"
✅ 获取问题洞察："显示PROJ-123的详细信息，包括评论"
✅ 跟踪项目进度："列出分配给我的所有高优先级问题"
✅ 管理问题评论："在PROJ-456上添加关于测试结果的评论"
✅ 跨项目搜索："在我的项目中查找所有正在进行的bug"
✅ 检查工作流状态："DEV项目的可用状态是什么？"

完美适用于

  • 开发者需要快速访问问题详情和开发上下文
  • 项目经理追踪进度、优先级和团队分配
  • Scrum Master管理冲刺和工作流状态
  • 团队负责人监控项目健康状况和问题解决情况
  • QA工程师追踪bug和测试状态
  • 任何人希望使用自然语言与Jira互动

快速开始

两分钟内启动并运行：

1. 获取您的Jira凭证

生成一个Jira API令牌：

  1. 前往Atlassian API令牌
  2. 点击创建API令牌
  3. 给它起个名字，如**"AI助手"**
  4. 立即复制生成的令牌（您不会再看到它了！）

2. 即刻尝试

# 设置您的凭证
export ATLASSIAN_SITE_NAME="your-company"  # 对应your-company.atlassian.net
export ATLASSIAN_USER_EMAIL="your.email@company.com"
export ATLASSIAN_API_TOKEN="your_api_token"

# 列出您的Jira项目
npx -y @aashari/mcp-server-atlassian-jira ls-projects

# 获取特定项目的详细信息
npx -y @aashari/mcp-server-atlassian-jira get-project --project-key-or-id DEV

# 搜索问题
npx -y @aashari/m-erver-atlassian-jira ls-issues --project-key-or-id DEV

连接到AI助手

对于Claude桌面用户

在您的Claude配置文件（~/.claude/claude_desktop_config.json）中添加以下内容：

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-jira"],
      "env": {
        "ATLASSIAN_SITE_NAME": "your-company",
        "ATLASSIAN_USER_EMAIL": "your.email@company.com",
        "ATLASSIAN_API_TOKEN": "your_api_token"
      }
    }
  }
}

重启Claude桌面，您将在状态栏中看到"🔗 jira"。

对于其他AI助手

大多数AI助手支持MCP。全局安装服务器：

npm install -g @aashari/mcp-server-atlassian-jira

然后配置您的AI助手以使用STDIO传输的MCP服务器。

替代方案：配置文件

创建~/.mcp/configs.json进行系统范围配置：

{
  "jira": {
    "environments": {
      "ATLASSIAN_SITE_NAME": "your-company",
      "ATLASSIAN_USER_EMAIL": "your.email@company.com",
      "ATLASSIAN_API_TOKEN": "your_api_token"
    }
  }
}

替代配置键：系统也接受"atlassian-jira"、"@aashari/mcp-server-atlassian-jira"或"mcp-server-atlassian-jira"代替"jira"。

实际案例

📋 探索您的项目

询问您的AI助手：

  • "列出我有权访问的所有项目"
  • "显示DEV项目的详细信息"
  • "哪些项目包含单词'平台'？"
  • "获取PROJ-123项目的详细信息"

🔍 搜索和跟踪问题

询问您的AI助手：

  • "找到DEV项目中的所有高优先级问题"
  • "显示分配给我且正在处理的问题"
  • "搜索过去一周报告的bug"
  • "列出移动团队的所有开放问题"

📝 管理问题详情

询问您的AI助手：

  • "获取问题PROJ-456的全部详细信息，包括评论"
  • "显示PROJ-789的开发信息"
  • "PROJ-123当前的状态和负责人是谁？"
  • "显示身份验证bug上的所有评论"

💬 问题沟通

询问您的AI助手：

  • "在PROJ-456上添加评论：'代码审查完成，准备测试'"
  • "对登录问题发表评论，已部署到staging环境"
  • "向问题PROJ-789添加测试结果"

🔄 工作流管理

询问您的AI助手：

  • "DEV项目的可用状态是什么？"
  • "显示所有可能的工作流状态"
  • "项目MOBILE的可用状态选项是什么？"
  • "列出问题转换的工作流状态"

故障排除

"认证失败"或"403禁止"

  1. 检查您的API令牌权限：

  2. 验证您的站点名称格式：

    • 如果您的Jira URL是https://mycompany.atlassian.net
    • 您的站点名称应该是mycompany

  3. 测试您的凭证：

    # 测试您的凭证是否有效
npx -y @aashari/mcp-server-atlassian-jira ls-projects

"项目未找到"或"问题未找到"

  1. 检查项目键拼写：

    # 列出您的项目以查看正确的键
npx -y @aashari/mcp-server-atlassian-jira ls-projects

  2. 验证访问权限：

    • 确保您在浏览器中有权访问该项目
    • 某些项目可能仅限某些用户访问

"搜索无结果"

  1. 尝试不同的搜索词：

    • 使用项目键而不是项目名称
    • 尝试更广泛的搜索条件

  2. 检查问题权限：

    • 您只能访问您有权查看的问题
    • 向管理员询问您是否有权访问特定项目

Claude桌面集成问题

  1. 更新配置文件后重启Claude桌面
  2. 检查状态栏是否有"🔗 jira"指示器
  3. 验证配置文件位置：
    • macOS: ~/.claude/claude_desktop_config.json
    • Windows: %APPDATA%\\Claude\\claude_desktop_config.json

如何获取帮助

如果您仍然遇到问题：

  1. 运行一个简单的测试命令来验证一切是否正常
  2. 查看GitHub问题以查找类似问题
  3. 创建一个新问题，附带您的错误消息和设置细节

常见问题

我需要什么权限？

您的Atlassian账户需要：

  • 访问Jira，具有查询所需项目的适当权限
  • API令牌，具有适当的权限（创建时自动授予）

我可以使用这个工具与Jira Server（本地部署）吗？

目前，此工具仅支持Jira Cloud。未来版本可能会增加对Jira Server/Data Center的支持。

我如何找到我的站点名称？

您的站点名称是Jira URL的第一部分：

  • URL: https://mycompany.atlassian.net → 站点名称: mycompany
  • URL: https://acme-corp.atlassian.net → 站点名称: acme-corp

哪些AI助手可以使用这个工具？

任何支持模型上下文协议（MCP）的AI助手：

  • Claude Desktop（最受欢迎）
  • Cursor AI
  • Continue.dev
  • 许多其他助手

我的数据安全吗？

是的！此工具：

  • 完全在您的本地机器上运行
  • 使用您自己的Jira凭证
  • 不会将您的数据发送给第三方
  • 只访问您授权其访问的内容

我可以跨多个项目搜索吗？

是的！当您不指定项目时，搜索会在您有权访问的所有项目中进行。您还可以使用JQL查询进行高级跨项目搜索。

支持

需要帮助？以下是获取帮助的方法：

  1. 查看上面的故障排除部分 - 大多数常见问题都在那里覆盖
  2. 访问我们的GitHub存储库获取文档和示例：github.com/aashari/mcp-server-atlassian-jira
  3. 在GitHub问题中报告问题
  4. 开始讨论以提出功能请求或一般问题

由❤️制作，适用于希望将AI引入项目管理流程的团队。