适合谁
- 希望快速访问问题详情和开发上下文的开发者
- 需要跟踪进度、优先级和团队分配的项目经理
- 需要管理冲刺和工作流状态的 Scrum Master
- 监控项目健康度和问题解决情况的团队负责人
- 跟踪缺陷和测试状态的 QA 工程师
- 任何希望通过自然语言与 Jira 交互的用户
A
40FMRS · D
该 MCP 服务器提供了对 Jira Cloud 的全面访问，通过通用 HTTP 工具覆盖所有 REST API v3 端点。其 TOON 格式和 JMESPath 过滤功能提高了 AI 交互的效率。但仅支持云版本，且需要用户具备一定的 API 知识。
此 MCP 服务器为 AI 助手（如 Claude、Cursor AI）提供与 Atlassian Jira 交互的能力。它通过五个通用工具（jira_get、jira_post、jira_put、jira_patch、jira_delete）暴露 Jira REST API v3 的任意端点，支持项目列表、问题检索（JQL）、评论管理、工作日志操作等。默认使用 TOON 格式输出，可减少 30-60% 的 token 消耗，并支持 JMESPath 过滤。
工具能力
jira_get
向任何 Jira API 端点发送 GET 请求以读取数据。
jira_post
向任何端点发送 POST 请求以创建资源。
jira_put
向任何端点发送 PUT 请求以完全替换资源。
jira_patch
向任何端点发送 PATCH 请求以部分更新资源。
jira_delete
向任何端点发送 DELETE 请求以删除资源。
安装接入
- 在 Atlassian API Tokens 页面创建 API 令牌并复制。
- 设置环境变量：ATLASSIAN_SITE_NAME（例如 your-company）、ATLASSIAN_USER_EMAIL（您的邮箱）、ATLASSIAN_API_TOKEN（令牌）。
- 对于 Claude Desktop，将配置添加到 ~/.claude/claude_desktop_config.json，然后重启 Claude。
- 或者使用 npm 全局安装，并配置其他支持 MCP 的 AI 助手。
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 Server 或 Data Center（内部部署）支持的用户——目前仅支持 Jira Cloud
- 需要预定义专用工具（如 jira_ls_projects）的旧工作流程——v3 迁移为通用 HTTP 工具
- 期望无需 Jira API 令牌即可使用的用户
所需权限
- 需要 Atlassian 账户对目标项目具有适当的 Jira 权限
- 需要有效的 Atlassian API 令牌
- 服务器在本地运行，使用您自己的凭据
风险与副作用
- API 令牌泄露会导致未授权访问——请妥善保管
- 通用工具可能暴露超出预期的数据，需谨慎使用
- API 端点可能发生变更，导致工具失效
- 对于大型响应，会自动截断，原始数据保存到本地 /tmp/mcp 目录
常见排障
- 认证失败或 403：检查 API 令牌是否有效、站点名称是否正确（例如 mycompany vs mycompany.atlassian.net）
- 资源不存在或 404：检查 API 路径是否区分大小写，使用项目键而非名称
- 搜索无结果：尝试更广泛的条件，或先在 Jira 高级搜索中验证 JQL
- Claude Desktop 集成问题：重启 Claude，验证配置文件路径
使用场景
列出所有可访问的项目
使用 JQL 搜索问题，例如“DEV 项目中进行中的高优先级问题”
获取特定问题的详情，包括评论
添加评论到问题
跨项目搜索缺陷
创建或更新问题
跟踪工作日志和状态变更
支持客户端
Claude Desktop完整支持