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

# Connect Jira to Cogno

> Connect Jira so each Project works in the Jira projects you choose, and agents can read and update their issues.

<img src="https://mintcdn.com/genaxis/AWoMBbN1yOTNqJwY/images/integrations/jira.svg?fit=max&auto=format&n=AWoMBbN1yOTNqJwY&q=85&s=7203b2f011309f7e6f9801251de4894c" alt="Jira" width="56" height="56" noZoom data-path="images/integrations/jira.svg" />

## At a glance

|                    |                                                                           |
| ------------------ | ------------------------------------------------------------------------- |
| **Direction**      | Two-way — agents read issues, and can change them only when you allow it. |
| **Connect with**   | Atlassian OAuth — one click.                                              |
| **Who can set up** | Any workspace member except viewers.                                      |
| **You'll need**    | An Atlassian account with access to the Jira site you want to connect.    |

Connect Jira so each Project can choose the Jira projects it works in. Agent runs in that Project can then search and read those projects' issues, and — if you allow it — create, edit, comment on, and transition them. Nothing outside the Project's selected Jira projects is in reach.

## Before you start

* You're a member of the target workspace with a role other than viewer.
* You're signed in to the Atlassian account that can browse the Jira projects you want Cogno to use.

## Connect Jira in Cogno

<Steps>
  <Step title="Find Jira">
    Open **Integrations** and find **Jira**.
  </Step>

  <Step title="Authorize Atlassian">
    Click **Connect**. Cogno opens Atlassian's authorization screen in your browser. Choose the Jira site and approve.
  </Step>

  <Step title="Confirm the connection">
    Back in Cogno, the Jira page opens. The connection row shows your site (for example `acme.atlassian.net`) marked **Connected**.
  </Step>
</Steps>

## See the Jira projects Cogno can use

The **Jira projects** section lists the projects your connection can browse — each with its name, key, and type (**Software**, **Business**, or **Service management**) and a link that opens it in Jira. The connection row shows when the list was last refreshed (**Last synced** — or **Not synced yet**).

Cogno fills this list right after you connect and refreshes it every six hours. To refresh it now, open the **⋯** menu on the connection row and choose **Sync projects** — refreshing takes a few seconds.

## Choose Jira projects for a Project

Connecting Jira doesn't give any Project access by itself. Each Project picks its own Jira projects:

<Steps>
  <Step title="Open the Project's settings">
    Open the Project and go to its settings, then find **Jira** under **Project integrations**.
  </Step>

  <Step title="Select Jira projects">
    Expand **Jira** and choose the Jira projects this Project works in under **Projects**.
  </Step>
</Steps>

The picker offers the same projects as the **Jira projects** section on the integration page.

<Note>
  A Project that has selected no Jira projects can't reach any Jira issue: the Jira Tools refuse the call instead of searching the whole site.
</Note>

## Set agent tool access

The **Agent tools** section controls what Engine-managed runs may do through this connection. Choose **Block**, **Ask**, or **Allow** for each capability. Changes apply to the next run; disconnecting stops access immediately.

| Capability        | What it allows                                                                                                        | Default   |
| ----------------- | --------------------------------------------------------------------------------------------------------------------- | --------- |
| **Read Jira**     | Search and read issues, comments, and transitions in the Project's selected Jira projects.                            | **Allow** |
| **Write to Jira** | Create and edit issues, add comments, and move issues through their workflow in the Project's selected Jira projects. | **Block** |

Under each capability, **Tools** lists the exact Tools it grants. The workspace setting is the ceiling: a Project can inherit or reduce it for this connection, but can't raise it. See [Set Workspace Tool permissions](/docs/integrations#set-workspace-tool-permissions).

## Disconnect

Open the **⋯** menu on the connection row and choose **Disconnect**, then confirm.

## Common states

| State                                                        | Meaning                                                               | Next action                                                   |
| ------------------------------------------------------------ | --------------------------------------------------------------------- | ------------------------------------------------------------- |
| **No Jira projects yet.**                                    | The list hasn't been filled, or your account can't browse any project | Choose **Sync projects**; check your Jira project permissions |
| A project you just created is missing                        | Cogno hasn't refreshed since it was created                           | Choose **Sync projects**                                      |
| **Failed to load Jira projects.**                            | Cogno couldn't read the project list                                  | Reload the page                                               |
| An agent says the Project has not selected any Jira projects | The Project's Jira filter is empty                                    | Select Jira projects in the Project's settings                |

## Reference URLs

* [Atlassian: manage your connected apps](https://support.atlassian.com/atlassian-account/docs/manage-your-profile-and-connected-apps/)

## Related docs

* [Integrations](/docs/integrations)
* [Projects](/docs/projects)
* [Troubleshooting](/docs/troubleshooting)