v2.3.0 — installable plugin file
Packages the tools and the skills as a single installable plugin.
Install
Download jira-mcp.plugin and open it. It appears as a preview you can browse and accept. Use this if your client says only packaged plugins are allowed.
If your client supports git marketplaces instead:
/plugin marketplace add wyckit/jira-mcp
/plugin install jira-mcp@wyckit
Set your credentials first
The plugin reads these from the environment, so no token is written into any config file and the plugin is shareable as-is. Run these yourself, then restart your terminal and Claude — setx only affects new processes.
setx JIRA_BASE_URL "https://your-jira-host"
setx JIRA_PAT "your-personal-access-token"
What's inside
- 21 MCP tools — core Jira read/write, schema discovery, history and traversal, aggregate analysis
jira-researchskill — the analysis ladder: learn the custom-field vocabulary before writing JQL, compare the workflow on paper against its real behaviour, treat aggregate output as candidates rather than conclusions, prefer median over mean for time-in-statusjira-setupskill — install path selection, credential setup, and error diagnosis (HTML response means WAF or VPN, 401 means the token, 403 means the network)
Requires Node 18+ on the machine. If nothing can be installed there, use the standalone jira-mcp.exe from v2.2.0 instead and point the MCP registration at it.
Fixed in this release
The jira-research skill description contained a colon-space, which in YAML splits a plain scalar into a key/value pair — the entire frontmatter block failed to parse and every field was silently dropped, so the skill would never have triggered. Caught by claude plugin validate. A validator now guards that class of bug and runs as part of the test suite.