Skip to content

v2.3.0 — installable plugin file

Choose a tag to compare

@wyckit wyckit released this 28 Jul 01:14

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-research skill — 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-status
  • jira-setup skill — 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.