v0.6.2 - Enhanced Error Messages

Enhanced Error Messages for Schema Fetching

Dramatically improved error messages when fetching project schemas to help users quickly diagnose and fix configuration issues.

Improved

• Enhanced Error Messages - Much more detailed error messages for project schema fetch failures
  • 404 errors now explain possible causes (project not found, permission denied, endpoint unavailable)
  • Empty project data errors provide actionable troubleshooting steps
  • Issue type not found errors list common types and note case-sensitivity
  • Better diagnostic information to help users resolve configuration issues
• Added test coverage for 404 endpoint response handling (342 total tests with 100% coverage)

Changed

• Updated error handling in JiraClient.get_project_schema() with context-specific messages
• Improved user experience when diagnosing Jira connection and permission issues

Error Message Examples

404 Response:

Project schema not found. Possible causes:
  - Project 'PROJ' does not exist
  - You don't have permission to access project 'PROJ'
  - Issue type 'Task' is not available in this project
  - The createmeta endpoint may not be available in your Jira version
Please verify the project key and issue type are correct.

Empty Project Data:

Project 'PROJ' returned no data. Possible causes:
  - Project exists but you don't have permission to create issues
  - Issue type 'Task' is not available in this project
Available projects: Check with your Jira administrator

Issue Type Not Found:

Issue type 'task' not found in project 'PROJ'.
Common issue types: Task, Bug, Story, Epic
Note: Issue type names are case-sensitive

Installation

pip install --upgrade fastmcp-jira-server

Full Changelog: v0.6.1...v0.6.2