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

# Jira

> Connect Jira Cloud or Jira Server to let Felan research and manage issues for your team.

Felan supports Jira Cloud through OAuth and Jira Server or Data Center through a team-managed credential. A configured Jira integration lets Felan research issues and, when you explicitly ask, create issues, update them, or add comments.

## Jira Cloud setup

<Steps>
  <Step title="Open Integrations">
    Select the Felan team that should use Jira, then open **Integrations** from the main navigation.
  </Step>

  <Step title="Connect Jira Cloud">
    Find **Jira Cloud**, click **Connect**, select the Atlassian site, and complete the OAuth authorization flow.
  </Step>
</Steps>

## Jira Server or Data Center setup

<Steps>
  <Step title="Open the Jira Server configuration">
    On the same **Integrations** screen, find **Jira Server** and click **Configure**.
  </Step>

  <Step title="Enter credentials">
    Enter the Jira base URL, username, and either a personal access token or password. Enable **Private Connectivity** when Felan should reach the instance through your network connector.
  </Step>

  <Step title="Save optional webhook details">
    Save the connection. The configuration displays a team-scoped webhook URL and secret if Jira should send events to Felan automations.
  </Step>
</Steps>

## Supported behavior

* Search and read Jira issues
* Create issues, update issues, and add comments when requested
* Use supported Jira change events as team automation triggers

## Compatibility identifiers

| Connector                  | Provider ID   |
| -------------------------- | ------------- |
| Jira Cloud                 | `jira`        |
| Jira Server or Data Center | `jira-server` |

## Troubleshooting

**Cloud authorization fails** — Reconnect Jira Cloud from **Integrations** and select the intended Atlassian site.

**A private Jira instance is unreachable** — Confirm the base URL and the team's Private Connectivity configuration.

**Felan cannot change an issue** — Confirm that the connected user or server credential has permission in the target Jira project.