连接 AI 到您的 Jira 项目

通过将克洛德,Cursor AI,以及其他AI助手直接连接到你的Jira项目,问题和工作流程来转变你的管理和跟踪工作方式. 获得即时项目见解,精简议题管理,加强团队协作.

你能做什么吗

• 询问AI您的项目:"DEV项目中的活性问题是什么"
• 获得问题见解"给我看看PROJ-123的细节 包括评论"
• 跟踪项目进度"列出分配给我的所有高度优先问题"
• 管理问题评论:"向PROJ-456添加关于测试结果的评论"
• 跨项目搜索:"在我的项目中查找所有正在运行中的错误"
• 创建和更新问题:"在MOBILE计划中创建新错误"

完美为

• 开发者 需要迅速了解问题细节和发展背景的人
• 项目管理员 跟踪进展情况、优先事项和团队任务
• Scrum 大师 管理短跑和工作流程状态
• 团队领导 监测项目健康和解决问题
• QA 工程师 跟踪错误和测试状态
• 谁都行 希望用自然语言与吉拉互动

快速启动

两分钟后起床跑道:

1. 获得你的Jira证书

生成 Jira API 键 :

1. 转到 地图集API 键
2. 点击 创建 API 令牌
3. 给它一个名字像 阿联酋助理
4. 复制生成的令牌 立刻,你不会再看到它了

2. 立即尝试

# Set your credentials
export ATLASSIAN_SITE_NAME="your-company"  # for your-company.atlassian.net
export ATLASSIAN_USER_EMAIL="[email protected]"
export ATLASSIAN_API_TOKEN="your_api_token"

# List your Jira projects
npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/project/search"

# Get details about a specific project
npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/project/DEV"

# Get an issue with JMESPath filtering
npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/issue/PROJ-123" --jq "{key: key, summary: fields.summary, status: fields.status.name}"

连接到 AI 助理

对于 Claude 桌面用户

将此添加到您的 Claude 配置文件( E)~/.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": "[email protected]",
        "ATLASSIAN_API_TOKEN": "your_api_token"
      }
    }
  }
}

重新启动克洛德桌面,你可以看到状态栏中的jira服务器.

其他助理助理

大多数AI助手支持MCP. 在全球安装服务器 :

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

然后配置您的 AI 助手使用 STIO 传输的 MCP 服务器 .

选项: 配置文件

创建 ~/.mcp/configs.json 全系统配置:

{
  "jira": {
    "environments": {
      "ATLASSIAN_SITE_NAME": "your-company",
      "ATLASSIAN_USER_EMAIL": "[email protected]",
      "ATLASSIAN_API_TOKEN": "your_api_token"
    }
  }
}

替代配置密钥 : 系统还接受 "atlassian-jira", (中文(简体) ), "@aashari/mcp-server-atlassian-jira",或 "mcp-server-atlassian-jira" 改为 "jira"。 。 。 .

可用工具

这个MCP服务器提供了5个通用工具,可以访问任何Jira API端点:

常见 API 路径

项目:

• /rest/api/3/project/search - 列出所有项目
• /rest/api/3/project/{projectKeyOrId} - 获取项目细节

问题:

• /rest/api/3/search/jql - 与JQL的搜索问题(使用) jql 查询段落)
• /rest/api/3/issue/{issueIdOrKey} - 获取问题的细节
• /rest/api/3/issue - 创建(POST)
• /rest/api/3/issue/{issueIdOrKey}/transitions - 获得/完成过渡

评论:

• /rest/api/3/issue/{issueIdOrKey}/comment - 清单/补充评论
• /rest/api/3/issue/{issueIdOrKey}/comment/{commentId} - 获得/更新/删除评论

工作日志 :

• /rest/api/3/issue/{issueIdOrKey}/worklog - 清单/添加工作日志
• /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId} - 获得/更新/删除工作日志

用户状态( S) :

• /rest/api/3/myself - 获取当前用户
• /rest/api/3/user/search - 搜索用户(使用) query (第1款)
• /rest/api/3/status - 列出所有状态
• /rest/api/3/issuetype - 清单问题类型
• /rest/api/3/priority - 列出优先事项

JMESPath 过滤

所有工具都支持可选 JMESPath (jq过滤以提取具体数据:

# Get just project names and keys
npx -y @aashari/mcp-server-atlassian-jira get \
  --path "/rest/api/3/project/search" \
  --jq "values[].{key: key, name: name}"

# Get issue key and summary
npx -y @aashari/mcp-server-atlassian-jira get \
  --path "/rest/api/3/issue/PROJ-123" \
  --jq "{key: key, summary: fields.summary, status: fields.status.name}"

现实世界实例

探索您的项目

问你的人工智能助手:

• "列出我所有的项目"
• "告诉我关于DEV计划的细节"
• "什么项目里有‘平面'这个词?"

搜索和跟踪问题

问你的人工智能助手:

• "在DEV项目中找到所有高度优先的问题"
• "给我看看分配给我的问题"
• "搜索上个星期报告的虫子"
• "为机动队列出所有公开问题"

管理问题细节

问你的人工智能助手:

• 详细了解PROJ-456 包括评论
• "PROJ-123目前的状况和受让人是什么?"
• “ 忽略认证错误上的所有注释 ”

问题沟通

问你的人工智能助手:

• "给PROJ-456添加一则评论:"代码审查完成,准备测试"
• "关于登入问题的评论 它被部署在中转"

CLI 命令

CLI 镜像 MCP 直接终端访问的工具 :

# GET request
npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/project/search"

# GET with query parameters
npx -y @aashari/mcp-server-atlassian-jira get \
  --path "/rest/api/3/search/jql" \
  --query-params '{"jql": "project=DEV AND status=\"In Progress\"", "maxResults": "10"}'

# POST request (create an issue)
npx -y @aashari/mcp-server-atlassian-jira post \
  --path "/rest/api/3/issue" \
  --body '{"fields": {"project": {"key": "DEV"}, "summary": "New issue title", "issuetype": {"name": "Task"}}}'

# POST request (add a comment)
npx -y @aashari/mcp-server-atlassian-jira post \
  --path "/rest/api/3/issue/PROJ-123/comment" \
  --body '{"body": {"type": "doc", "version": 1, "content": [{"type": "paragraph", "content": [{"type": "text", "text": "My comment"}]}]}}'

# PUT request (update issue - full replacement)
npx -y @aashari/mcp-server-atlassian-jira put \
  --path "/rest/api/3/issue/PROJ-123" \
  --body '{"fields": {"summary": "Updated title"}}'

# DELETE request
npx -y @aashari/mcp-server-atlassian-jira delete \
  --path "/rest/api/3/issue/PROJ-123/comment/12345"

解决问题

"校正失败"或"403紫禁"

1. 检查您的 API 调试权限数字 :

   • 转到 地图集API 键
   • 确定你的代币还在使用中, 并且还没有过期

2. 校验您的站点名称格式数字 :

   • 如果你的吉拉URL是 https://mycompany.atlassian.net
   • 你的网站名应该只是 mycompany

3. 测试您的证书数字 :

   npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/myself"
   

"未找到资源"或"404"

1. 检查 API 路径数字 :

   • 路径对大小写敏感
   • 使用工程密钥( 例如 ), DEV(不是项目名称)
   • 问题键包括项目前缀(例如, DEV-123(中文(简体) )

2. 验证访问权限数字 :

   • 确保您在浏览器中访问工程
   • 一些项目可能仅限于某些用户

搜索时找不到结果

1. 尝试不同的搜索术语数字 :

   • 使用工程密钥而不是工程名称
   • 尝试更广泛的搜索标准

2. 检查 JQL 语法数字 :

   • 在 Jira 的高级搜索中先验证您的 JQL

Claude 桌面整合问题

1. 重新启动 Claude 桌面 更新配置文件后
2. 验证配置文件位置数字 :
   • 马可斯: ~/.claude/claude_desktop_config.json
   • 窗口 : %APPDATA%\Claude\claude_desktop_config.json

获取帮助

如果你仍然有问题:

1. 运行一个简单的测试命令来验证所有工作
2. 检查 GitHub 问题 类似的问题
3. 以错误消息创建新问题并设置细节

经常被问到的问题

我需要什么许可?

您的Atlassian账户需要:

• 进入吉拉 包含您想要查询的项目的适当权限
• API 令牌 拥有适当的许可(在创建时自动授予)

我可以用这个与Jira Server (premise)?

目前,此工具只支持 吉拉·云. Jira Server/Data Center的支持可在未来版本中添加.

我该怎么找到我的网站名?

您的网站名称是您的 Jira URL 的第一部分 :

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

人工智能助理是做什么工作的?

任何支持模式背景协议的AI助手:

• 克劳德桌面
• 光标AI
• 继续. dev
• 许多其他

我的数据安全吗?

没错! 此工具 :

• 完全运行在您的本地机器上
• 用你自己的Jira证书
• 从不向第三方发送数据
• 只访问您允许它访问的内容

我可以搜索多个项目吗?

没错! 使用JQL查询进行跨项目搜索. 例如:

npx -y @aashari/mcp-server-atlassian-jira get \
  --path "/rest/api/3/search/jql" \
  --query-params '{"jql": "assignee=currentUser() AND status=\"In Progress\""}'

从 v2.x 迁移

3.0版本用5个通用的HTTP方法工具来取代8+特定工具. 如果你从v2.x升级:

在(v2.x)之前:

jira_ls_projects, jira_get_project, jira_ls_issues, jira_get_issue,
jira_create_issue, jira_ls_comments, jira_add_comment, jira_ls_statuses, ...

在(v3.0)之后:

jira_get, jira_post, jira_put, jira_patch, jira_delete

移徙实例:

• jira_ls_projects - > (中文) jira_get 有路径 /rest/api/3/project/search
• jira_get_project - > (中文) jira_get 有路径 /rest/api/3/project/{key}
• jira_get_issue - > (中文) jira_get 有路径 /rest/api/3/issue/{key}
• jira_create_issue - > (中文) jira_post 有路径 /rest/api/3/issue
• jira_add_comment - > (中文) jira_post 有路径 /rest/api/3/issue/{key}/comment
• jira_ls_statuses - > (中文) jira_get 有路径 /rest/api/3/status

支助

需要帮忙吗? 如何获得援助:

1. 检查上面的故障排除区域 - 涉及最常见的问题
2. 访问 GitHub 仓库 文件和实例: github.com/aashari/mcp-server-atlassian-jira 页面存档备份,存于互联网档案馆
3. 报告问题 时间 GitHub 问题
4. 开始讨论 专题请求或一般问题

照顾希望将AI带入项目管理流程的团队.