# Jira Connection as Context

## What is the Jira Connection?

Tabnine's AI Chat allows you to connect to Atlassian Jira and extend the context of your chat with Jira issues. This capability enables you to ask Tabnine chat how to implement specific Jira issues or to validate whether your implementation aligns with the requirements detailed in those Jira issues. By bringing Jira into your IDE, you can streamline your workflow and minimize context-switching between different tools.

{% hint style="info" %}
**Note**

Tabnine Enterprise customers can integrate with either[ Jira Cloud or Jira Data Center](/main/welcome/readme/integrations/atlassian-jira.md#supported-matrix). While the setup process differs for the Enterprise admin, the workflow and experience remain the same for end-users, as outlined on this page. **We do support multiple instances for Jira Cloud**.
{% endhint %}

## How to Use the Jira connection

### Step 1: Connect to Jira

First, you need to connect your Tabnine plugin in the IDE to your Jira account:

1. In your IDE, navigate to **Chat** **Settings.**
2. Under Settings, find the Jira section and click <mark style="background-color:green;">**Connect**</mark>**.**

<figure><img src="/files/ABBNRkMZDJK8DjBtem86" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Troubleshooting**\
If the browser doesn’t open automatically for the next step, manually paste the following URL into your browser:

`<Tabnine server URL>/app/auth/jira`\
For example: [`https://console.tabnine.com/app/auth/jira`](https://console.tabnine.com/app/auth/jira)
{% endhint %}

3. Next, authorize access to Jira. A browser window will open, directing you to your Jira account. You’ll be prompted to give Tabnine access to your Jira workspace. Click <mark style="background-color:blue;">**Accept**</mark> to confirm connecting Tabnine to your Jira workspace.

<figure><img src="/files/a7QTz6xMcCZKbbEVw1bt" alt="" width="563"><figcaption></figcaption></figure>

4. After authorization, you’ll be redirected to the Tabnine web application.

   <figure><img src="/files/ZD9MBsxmxWJkxerhiSv3" alt="" width="563"><figcaption></figcaption></figure>
5. Return to your IDE. In the chat settings, you can see that Jira has been successfully connected. There will also be an option to <mark style="color:red;">Disconnect</mark>.

<figure><img src="/files/uvef1rq9DmbGFLPGxr4k" alt=""><figcaption></figcaption></figure>

#### **Demo**

{% embed url="<https://youtu.be/KuTECwe1cv8?si=TjZRtm0RYDnk9kUr>" %}

You’re now ready to start using Jira in Tabnine Chat!

### Step 2: Mentioning Jira Issues in Tabnine Chat

Once the connection is established, all the Jira issues assigned to you as an individual user are available in Tabnine. Tabnine uses the existing Jira user permissions to ensure that only the issues assigned to you are available.

You can start referencing Jira issues in your chat prompts using any of these three triggers:

1. **Jira button:** Click the Jira button ( <img src="/files/6PSay4LjE2pRqHtiVzRj" alt="" data-size="line"> ) in Tabnine Chat.

<figure><img src="/files/WADEBwEQucQCQ1yn6Gvq" alt="" width="563"><figcaption></figcaption></figure>

2. **Mention button:** Click the mention button ( <img src="/files/YUmwJzkkRTrImPPHjgJA" alt="" data-size="line"> ) and choose Jira from the menu.

<figure><img src="/files/QagFLDEdKZ48SEt17N0K" alt="" width="563"><figcaption></figcaption></figure>

3. **Type directly:** Manually type **`@Jira:`** in the chat prompt.

<figure><img src="/files/k23g3GzkRftVppvfNOTH" alt="" width="563"><figcaption></figcaption></figure>

**For all triggers:**

* You’ll see a list of assigned Jira issues ordered by the last update.

<figure><img src="/files/WOtt2ja5fgoz8rJ4kKfp" alt="" width="563"><figcaption></figcaption></figure>

* You can filter the list by typing a prefix.

<figure><img src="/files/tqpBeDHE31ZN6k9nKyl7" alt="" width="563"><figcaption></figcaption></figure>

* **Hover for details:** See the issue title when hovering.
* **Multiple mentions:** Add more than one issue to a single prompt.

### Does the Jira connection work with any issue format?

The Jira connection is flexible and doesn’t require issues to follow a strict template, but certain formats are more effective for producing relevant results. Here are some guidelines:

**Optimized for:**

* Self-contained, smaller scope tasks
* Specific tasks that include enough detail
* Jira issues written in both formal and informal formats

**Not optimized for:**

* Large, broad issues that lack specificity
* General tasks without concrete details
* Complex, multistep tasks without clear breakdowns

#### Examples

**Not a good fit:**

<figure><img src="/files/kpFCrvo5Gu2z2AVZuyZt" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/NvXWa54FxdbPaYoxhVnG" alt="" width="563"><figcaption></figcaption></figure>

**Yes a good fit:**

<figure><img src="/files/JROijZyDE4LhvDUeb2SY" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/m0jhdXb0EYB4vUf88FzM" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/HZSRPBT0JOhx11FkR7Rm" alt="" width="563"><figcaption></figcaption></figure>

### Use Cases for Jira Mentions

#### Implementing a Jira Issue:

Possible prompts:

<figure><img src="/files/H29W0RLhHhzsQYIPPwje" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/7SyU4NRZdZzl0jIQ7bXX" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Gqpt18g30JDRg6qs93lv" alt=""><figcaption></figcaption></figure>

Demo:

{% embed url="<https://youtu.be/d8i7MEdvG2U?si=W5J7uGvKMZEvTVC3>" %}

#### Code Validation:

Possible prompts:

<figure><img src="/files/ck2ywZeZoyLalHSqN4Zr" alt=""><figcaption></figcaption></figure>

Demo:

{% embed url="<https://youtu.be/Gv_M8OVNB5I?si=c67pJXa3odTiPwzM>" %}

#### Multiple Issue Mentions:

Possible prompts:

<figure><img src="/files/XHZMnvVFkJnN4gKCd9G5" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tabnine.com/main/getting-started/tabnine-chat/chat-context/jira-connection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.