​

Jira Integration for Release Notes

​

Current Status

TypeError: cannot specify both default and default_factory

​

Available Solutions

​

Option 1: Use the Node.js Scripts (Recommended for Quick Use)

​

1. List Available Fix Versions

# List all projects and their versions
node scripts/jira-list-versions.js

# List versions for a specific project
node scripts/jira-list-versions.js FLOWX

​

2. Generate Release Notes from Fix Version

# Generate release notes for a specific fix version
node scripts/jira-release-notes.js "5.2.1"

• Fetch all issues with the specified fix version
• Group them by type (Features, Improvements, Bug Fixes)
• Display them in an organized format
• Generate an MDX template for your release notes

• Issue summaries and descriptions
• Status, priority, and components
• Links to Jira issues
• Ready-to-use MDX template

​

Option 2: Fix the MCP Atlassian Server

​

Current Configuration

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--jira-url=https://flowxai.atlassian.net",
        "[email protected]",
        "--jira-token=ATATT3xFfGF0nEdzfekswbvRec_2yfVr7fGWqIBC0CtB5kadoxysWfWouWGWFk3Y3ylQV1OLuq_8H9oJjeBQw3N3JSkJ7exXiniW87fCTWJx0-L6xntAT6rVwqN1luDYRbUz_i3SVx2HmvwqfauCy3nzrlMYGCP_n1nXgesyw5_qss6QCjpd8HY=FFAC67A5"
      ]
    }
  }
}

​

Steps to Fix

1. Update the mcp-atlassian package:

# Clear uvx cache
rm -rf ~/.cache/uv/

# Update the package
uvx --reinstall mcp-atlassian --version

2. Alternative: Use a specific version:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian@latest",
        "--jira-url=https://flowxai.atlassian.net",
        "[email protected]",
        "--jira-token=YOUR_TOKEN_HERE"
      ]
    }
  }
}

3. Restart Cursor after making changes
4. Check the logs:

tail -f ~/.cursor/MCP:\ user-mcp-atlassian.log

​

Option 3: Manual Jira API Queries

# List projects
curl -u "[email protected]:YOUR_TOKEN" \
  -H "Accept: application/json" \
  "https://flowxai.atlassian.net/rest/api/3/project"

# Search for issues by fix version
curl -u "[email protected]:YOUR_TOKEN" \
  -H "Accept: application/json" \
  "https://flowxai.atlassian.net/rest/api/3/search?jql=fixVersion='5.2.1'"

​

Troubleshooting

​

Error: “Site temporarily unavailable”

1. Jira is temporarily down
2. Authentication credentials need to be refreshed
3. API endpoint URL needs adjustment

• Check if you can access https://flowxai.atlassian.net in your browser
• Verify your API token is still valid
• Generate a new API token if needed: https://id.atlassian.com/manage-profile/security/api-tokens

​

MCP Server Won’t Start

1. Check the logs: tail -50 ~/.cursor/MCP:\ user-mcp-atlassian.log
2. Clear the UV cache: rm -rf ~/.cache/uv/
3. Restart Cursor

​

API Token Expired

1. Go to: https://id.atlassian.com/manage-profile/security/api-tokens
2. Create a new API token
3. Update the token in:
   • ~/.cursor/mcp.json (for MCP server)
   • /scripts/jira-release-notes.js (for Node.js scripts)

​

Usage Examples

​

Example 1: Generate Release Notes for Version 5.2.1

node scripts/jira-release-notes.js "5.2.1" > release-notes-5.2.1.txt

​

Example 2: Find All Unreleased Versions

node scripts/jira-list-versions.js FLOWX | grep "🚧 Unreleased"

​

Example 3: Copy Output to Clipboard (macOS)

node scripts/jira-release-notes.js "5.2.1" | pbcopy

​

Next Steps

1. Test the scripts: Try running node scripts/jira-list-versions.js to verify connectivity
2. Generate sample release notes: Run node scripts/jira-release-notes.js "<version>" with a known version
3. Fix MCP server (optional): If you want Cursor integration, follow the MCP server fix steps above

​

Security Note

const JIRA_TOKEN = process.env.JIRA_API_TOKEN || 'YOUR_TOKEN_HERE';

export JIRA_API_TOKEN="your-token-here"

​

Support

1. Check the Jira REST API documentation
2. Verify your Jira Cloud instance is accessible
3. Test authentication with a simple curl command
4. Check if your API token has the required permissions