使用说明
Jira MCP技能
一个命令安装程序 为了 mcp澳大利亚 为AI编码代理配置Jira/Confluence集成。
支持的代理： Kiro CLI•克劳德桌面•光标
⚡ 快速开始
npx @andrekurait/jira-mcp-skill
系统将提示您输入Jira URL、电子邮件和 API令牌.
就是这样！ 重新启动AI代理并开始使用Jira工具。
✨ 特性
| 特性 | 描述 |
|---|---|
| 🚀 一个命令设置 | 自动安装和配置所有内容 |
| 🤖 多代理支持 | 适用于Kiro、Claude Desktop和Cursor |
| 📚 项目背景 | 可定制的SKILL.md，用于特定项目的指导 |
| 🔄 自动更新 | Kiro hook会在更新可用时通知您 |
| 🔐 安全 | 凭据存储在代理配置中，而不是代码中 |
📦 安装什么
- mcp澳大利亚 -提供Jira/Confluence工具的MCP服务器
- 代理配置 -自动配置检测到的AI代理
- 版本检查挂钩 -（仅限Kiro）检查代理生成的更新
代理配置路径
| 代理 | 配置位置 |
|---|---|
| 基罗 | ~/.kiro/settings/mcp.json |
| 克劳德桌面 | ~/Library/Application Support/Claude/claude_desktop_config.json |
| 光标 | ~/.cursor/mcp.json |
🛠️ 可用工具
安装后，您的AI代理可以访问这些工具：
Jira工具
jira_search-执行JQL查询jira_get_issue-获取问题详细信息jira_create_issue-创建新问题jira_update_issue-更新现有问题jira_transition_issue-更改问题状态
汇流工具
confluence_search-执行CQL查询confluence_get_page-获取页面内容confluence_create_page-创建新页面confluence_update_page-更新现有页面
🔧 安装选项
交互模式（推荐）
npx @andrekurait/jira-mcp-skill
自动模式（CI/CD）
npx @andrekurait/jira-mcp-skill \
--url https://yourcompany.atlassian.net \
--email your@email.com \
--token YOUR_API_TOKEN \
--project MYPROJECT
使用自定义项目指南
npx @andrekurait/jira-mcp-skill --guide ./my-project-guide.md
CLI选项
| 选项 | 描述 |
|---|---|
--url |
Jira实例URL |
--email |
Jira帐户电子邮件 |
--token |
Jira API代币 |
--project |
默认项目密钥 |
--guide |
项目特定技能的路径.md |
--version, -v |
显示版本 |
--help, -h |
显示帮助 |
📖 为您的项目进行自定义
创建一个 SKILL.md 包含项目特定上下文的文件：
# My Project Jira Guide
## Project Details
- **Key:** MYPROJ
- **Board ID:** 123
## Custom Fields
- Story Points: `customfield_10032`
## Common JQL
- My open issues: `project = MYPROJ AND assignee = currentUser() AND status != Done`
然后安装：
npx @andrekurait/jira-mcp-skill --guide ./SKILL.md
导轨安装到 ~/.jira-mcp-skill/SKILL.md 并与Kiro的指导目录符号链接。
🔍 发现命令
使用这些来探索您的Jira实例：
# List all epics
jira_search("project = MYPROJ AND issuetype = Epic")
# Get project metadata
jira_get_project("MYPROJ")
# Find custom field IDs
jira_get_fields()
# Get active sprints
jira_get_board_sprints("BOARD_ID", state="active")
🐛 故障排除
MCP未加载
安装后重新启动AI代理。
身份验证错误
- 在验证API令牌 大西洋API代币
- 检查电子邮件是否与您的Atlassian帐户匹配
- 确保URL没有尾随斜线
工具未出现
确保 uvx 已安装：
curl -LsSf https://astral.sh/uv/install.sh | sh
🤝 贡献
欢迎投稿！请在上打开问题或PR GitHub.
📄 许可证
麻省理工学院
🙏 学分
- 索珀塞特/mcp澳大利亚 -MCP服务器
- 管弦乐队研究/人工智能研究技能 -技能模式灵感
