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

# Jira

> Connect Atlassian Jira to Myrmex with an API token — create the token and add the integration.

import { Steps, Step, CardGroup, Card, Tip } from '@mintlify/components';

Connect **Jira** so Myrmex can read and work with your projects, issues, workflows, and boards. Myrmex operates the Jira REST API live using an API token — reading and acting on demand, with nothing stored on the Myrmex side.

## What Myrmex Can Do

<CardGroup cols={2}>
  <Card title="Read projects & issues" icon="magnifying-glass">
    Inspect projects, issues, workflows, and boards, along with their status.
  </Card>

  <Card title="Look up work" icon="list-check">
    Check issue activity and current status on demand for investigations.
  </Card>

  <Card title="Update issues" icon="pen">
    Create and update issues — with approval for changes, via [Hydra](/documentation/multi-agent-system/integration-specialist-agent).
  </Card>

  <Card title="Correlate" icon="link">
    Tie issues to security findings and other integrations.
  </Card>
</CardGroup>

## Before You Start

* Your Jira **site URL** (for example `your-domain.atlassian.net`).
* An Atlassian account with access to the projects Myrmex should see.
* Permission to create an **API token** on that account.

## Step 1 — Create the API Token in Jira

Jira authenticates with an API token that Myrmex sends as a bearer token.

<Steps>
  <Step title="Sign in to Atlassian">
    Log in with the account Myrmex should use.
  </Step>

  <Step title="Open API token management">
    Go to **Account Settings → Security → Create and manage API tokens**.
  </Step>

  <Step title="Create and copy the token">
    Create a token, give it a label (for example `Myrmex`), set an expiry, and copy it — it's shown only once.
  </Step>
</Steps>

<Tip>
  The token inherits the account's permissions. Use a dedicated account scoped to the right projects for least privilege.
</Tip>

## Step 2 — Add the Integration in Myrmex

From the **Directory**, choose **Add Integration → Jira**, then fill in:

| Field           | Description                                                                                                              |
| --------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Name**        | A unique name for this Jira instance.                                                                                    |
| **Description** | Optional note to identify it.                                                                                            |
| **API Token**   | The token from Step 1.                                                                                                   |
| **URL**         | Your Jira site host (for example `your-domain.atlassian.net`).                                                           |
| **Protocol**    | `https` (default).                                                                                                       |
| **Port**        | API port (default `443`).                                                                                                |
| **Collector**   | Optional [Collector](/documentation/agent-endpoint-security/collector-mode) if Jira is reached from inside your network. |

## Connect

Click **Connect** to validate the connection and finish. Jira then appears under **Environment → Integrations**. New to integrations? See the [Integrations overview](/documentation/integrations/overview).