> ## Documentation Index
> Fetch the complete documentation index at: https://jira.xaviercollantes.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Report a Bug

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