> ## 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

> Collega Atlassian Jira a Myrmex con un token API: crea il token e aggiungi l'integrazione.

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

Collega **Jira** in modo che Myrmex possa leggere e lavorare con i tuoi progetti, issue, workflow e board. Myrmex opera l'API REST di Jira in tempo reale usando un token API, leggendo e agendo su richiesta, senza che nulla venga memorizzato dalla parte di Myrmex.

## Cosa può fare Myrmex

<CardGroup cols={2}>
  <Card title="Leggere progetti e issue" icon="magnifying-glass">
    Ispeziona progetti, issue, workflow e board, insieme al loro stato.
  </Card>

  <Card title="Consultare il lavoro" icon="list-check">
    Verifica l'attività delle issue e lo stato corrente su richiesta per le indagini.
  </Card>

  <Card title="Aggiornare le issue" icon="pen">
    Crea e aggiorna issue, con approvazione per le modifiche, tramite [Hydra](/it/documentation/multi-agent-system/integration-specialist-agent).
  </Card>

  <Card title="Correlare" icon="link">
    Collega le issue ai risultati di sicurezza e ad altre integrazioni.
  </Card>
</CardGroup>

## Prima di iniziare

* L'**URL del sito** Jira (ad esempio `your-domain.atlassian.net`).
* Un account Atlassian con accesso ai progetti che Myrmex deve vedere.
* Il permesso di creare un **token API** su quell'account.

## Passaggio 1 — Crea il token API in Jira

Jira si autentica con un token API che Myrmex invia come bearer token.

<Steps>
  <Step title="Accedi ad Atlassian">
    Accedi con l'account che Myrmex deve usare.
  </Step>

  <Step title="Apri la gestione dei token API">
    Vai su **Account Settings → Security → Create and manage API tokens**.
  </Step>

  <Step title="Crea e copia il token">
    Crea un token, assegnagli un'etichetta (ad esempio `Myrmex`), imposta una scadenza e copialo: viene mostrato una sola volta.
  </Step>
</Steps>

<Tip>
  Il token eredita i permessi dell'account. Usa un account dedicato e limitato ai progetti corretti per i privilegi minimi.
</Tip>

## Passaggio 2 — Aggiungi l'integrazione in Myrmex

Dalla **Directory**, scegli **Add Integration → Jira**, quindi compila:

| Field           | Description                                                                                                                            |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**        | Un nome univoco per questa istanza Jira.                                                                                               |
| **Description** | Nota facoltativa per identificarla.                                                                                                    |
| **API Token**   | Il token dal Passaggio 1.                                                                                                              |
| **URL**         | L'host del tuo sito Jira (ad esempio `your-domain.atlassian.net`).                                                                     |
| **Protocol**    | `https` (predefinito).                                                                                                                 |
| **Port**        | Porta dell'API (predefinita `443`).                                                                                                    |
| **Collector**   | [Collector](/it/documentation/agent-endpoint-security/collector-mode) facoltativo se Jira viene raggiunto dall'interno della tua rete. |

## Connessione

Fai clic su **Connect** per convalidare la connessione e completare. Jira comparirà quindi in **Environment → Integrations**. È la tua prima integrazione? Consulta la [panoramica sulle integrazioni](/it/documentation/integrations/overview).