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

> Conecta Atlassian Jira a Myrmex con un token de API: crea el token y agrega la integración.

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

Conecta **Jira** para que Myrmex pueda leer y trabajar con tus proyectos, issues, workflows y boards. Myrmex opera la API REST de Jira en vivo usando un token de API, leyendo y actuando bajo demanda, sin almacenar nada del lado de Myrmex.

## Qué puede hacer Myrmex

<CardGroup cols={2}>
  <Card title="Leer proyectos e issues" icon="magnifying-glass">
    Inspecciona proyectos, issues, workflows y boards, junto con su estado.
  </Card>

  <Card title="Consultar el trabajo" icon="list-check">
    Verifica la actividad de las issues y el estado actual bajo demanda para investigaciones.
  </Card>

  <Card title="Actualizar issues" icon="pen">
    Crea y actualiza issues, con aprobación para los cambios, mediante [Hydra](/es/documentation/multi-agent-system/integration-specialist-agent).
  </Card>

  <Card title="Correlacionar" icon="link">
    Vincula issues con hallazgos de seguridad y otras integraciones.
  </Card>
</CardGroup>

## Antes de comenzar

* La **URL del sitio** de tu Jira (por ejemplo `your-domain.atlassian.net`).
* Una cuenta de Atlassian con acceso a los proyectos que Myrmex debe ver.
* Permiso para crear un **token de API** en esa cuenta.

## Paso 1 — Crear el token de API en Jira

Jira se autentica con un token de API que Myrmex envía como bearer token.

<Steps>
  <Step title="Inicia sesión en Atlassian">
    Inicia sesión con la cuenta que Myrmex debe usar.
  </Step>

  <Step title="Abre la gestión de tokens de API">
    Ve a **Account Settings → Security → Create and manage API tokens**.
  </Step>

  <Step title="Crea y copia el token">
    Crea un token, dale una etiqueta (por ejemplo `Myrmex`), establece una expiración y cópialo: se muestra solo una vez.
  </Step>
</Steps>

<Tip>
  El token hereda los permisos de la cuenta. Usa una cuenta dedicada acotada a los proyectos correctos para el mínimo privilegio.
</Tip>

## Paso 2 — Agregar la integración en Myrmex

Desde el **Directory**, elige **Add Integration → Jira** y luego completa:

| Field           | Descripción                                                                                                                |
| --------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Name**        | Un nombre único para esta instancia de Jira.                                                                               |
| **Description** | Nota opcional para identificarla.                                                                                          |
| **API Token**   | El token del Paso 1.                                                                                                       |
| **URL**         | El host del sitio de tu Jira (por ejemplo `your-domain.atlassian.net`).                                                    |
| **Protocol**    | `https` (por defecto).                                                                                                     |
| **Port**        | Puerto de la API (por defecto `443`).                                                                                      |
| **Collector**   | [Collector](/es/documentation/agent-endpoint-security/collector-mode) opcional si se accede a Jira desde dentro de tu red. |

## Conectar

Haz clic en **Connect** para validar la conexión y finalizar. Jira aparecerá entonces en **Environment → Integrations**. ¿Nuevo en las integraciones? Consulta la [visión general de Integraciones](/es/documentation/integrations/overview).