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

# Jira Connector

> Learn how to set up a Jira connector as a data source.

For the setup of the Jira connector

## 1. Export Your Jira Credentials

> [!NOTE]
>
> **Please provide us the following information.** We will set up the service connection credentials for you. When creating a new Jira knowledge source you will have to select the assigned service connection.

**You will need the following things to set up and connect Jira:**

* Server URL,
* User account e-mail &
* User account access token;

**or a combination of**

* Personal Access Token (PAT) &
* Server URL.

If you provide us with a user account, make sure the user account has the access rights to your project or generally your relevant data.

## 2. Select your scope

When setting up a new Jira knowledge source, a JQL statement is needed. A JQL usually consits of three parts:

1. Field: The item to search against (e.g., project, status, assignee)
2. Operator: The comparison word (e.g., =, !=, IN, >).
3. Value: The specific item you're looking for (e.g., a project name, status, or user).

#### How to Find the JQL Statement in Jira

For our Jira connector, you will select your relevant scope using a JQL statement. JQL (Jira Query Language) is a structured search method that allows you to filter and locate specific issues across your Jira projects using precise logical criteria. In Jira, select your project, go to "All Work" (German: Alle Vorgänge), click the Filter-Button on the top left above your list of issues / tasks:

1. Apply your needed filters to end up with the selection of issues relevant for your Agent,
2. In the same filter pop-up window, you can then click on JQL to receive and export your needed JQL statement.

> [!TIP]
>
> Example for project-number: Each task has a process number, e.g., PROJ-2223. The prefix “PROJ” is sufficient as the project name. <kbd>project="PROJ"</kbd> would be the resulting JQL statement if you want to have every issue from the project exported to Genow.

![](https://mintcdn.com/genowgmbh/1OjrPf1PybZtB8uU/images/jira_jql.png?fit=max\&auto=format\&n=1OjrPf1PybZtB8uU\&q=85\&s=8de6136e5e67f15b12795efe8a4ce97c)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.