---
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>
