---
title: "Report a Bug"
description: "Help us fix issues by reporting bugs with detailed information"
---
Found a bug in Jira MCP? Help us improve by providing detailed information about the issue.
## Before reporting
<Steps>
<Step title="Check for existing reports">
Search [existing issues](https://github.com/xcollantes/jira-mcp/issues) to see if the bug has already been reported. If it has, you can add your experience to the existing discussion.
</Step>
<Step title="Update to latest version">
Make sure you're using the latest version of Jira MCP. Bugs in older versions may already be fixed.
</Step>
</Steps>
## Create a bug report
<Steps>
<Step title="Open a new issue">
[Create a new GitHub Issue](https://github.com/xcollantes/jira-mcp/issues/new) with the "Bug" label.
</Step>
<Step title="Use a clear title">
Choose a descriptive title that summarizes the problem.
</Step>
<Step title="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.
</Step>
</Steps>
