Skip to main content
Found a bug in Jira MCP? Help us improve by providing detailed information about the issue.

​
Before reporting

1

Check for existing reports

Search existing issues to see if the bug has already been reported. If it has, you can add your experience to the existing discussion.
2

Update to latest version

Make sure you’re using the latest version of Jira MCP. Bugs in older versions may already be fixed.

​
Create a bug report

1

Open a new issue

Create a new GitHub Issue with the “Bug” label.
2

Use a clear title

Choose a descriptive title that summarizes the problem.
3

Provide detailed information

​
Description

  • What happened: Clear description of the bug
  • When it happens: Under what circumstances does this occur?
  • Impact: How does this affect your workflow?

​
Steps to reproduce

Provide step-by-step instructions to reproduce the issue:
  1. Step one
  2. Step two

​
Expected behavior

What should have happened instead?

​
Environment

  • OS: (e.g., macOS 14.0, Windows 11, Ubuntu 22.04)
  • Python version: (e.g., Python 3.11.5)
  • Jira MCP version: (e.g., v1.2.0)
  • AI tool: (e.g., Cursor, Claude Desktop, Windsurf)
  • Jira instance: (e.g., Jira Cloud, Jira Server/Data Center)

​
Logs and error messages

Include any relevant error messages, logs, or stack traces. Remember to redact any sensitive information like API keys or personal data.

​
Screenshots

If applicable, include screenshots that demonstrate the issue.