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

> Conecte o Atlassian Jira ao Myrmex com um token de API — crie o token e adicione a integração.

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

Conecte o **Jira** para que o Myrmex possa ler e trabalhar com seus projetos, issues, workflows e boards. O Myrmex opera a API REST do Jira ao vivo usando um token de API — lendo e atuando sob demanda, sem armazenar nada do lado do Myrmex.

## O Que o Myrmex Pode Fazer

<CardGroup cols={2}>
  <Card title="Ler projetos e issues" icon="magnifying-glass">
    Inspecione projetos, issues, workflows e boards, junto com seu status.
  </Card>

  <Card title="Consultar trabalho" icon="list-check">
    Verifique a atividade das issues e o status atual sob demanda para investigações.
  </Card>

  <Card title="Atualizar issues" icon="pen">
    Crie e atualize issues — com aprovação para alterações, via [Hydra](/pt/documentation/multi-agent-system/integration-specialist-agent).
  </Card>

  <Card title="Correlacionar" icon="link">
    Vincule issues a descobertas de segurança e outras integrações.
  </Card>
</CardGroup>

## Antes de Começar

* A **URL do site** do seu Jira (por exemplo `your-domain.atlassian.net`).
* Uma conta Atlassian com acesso aos projetos que o Myrmex deve ver.
* Permissão para criar um **token de API** nessa conta.

## Passo 1 — Crie o Token de API no Jira

O Jira autentica com um token de API que o Myrmex envia como bearer token.

<Steps>
  <Step title="Faça login na Atlassian">
    Faça login com a conta que o Myrmex deve usar.
  </Step>

  <Step title="Abra o gerenciamento de tokens de API">
    Vá em **Account Settings → Security → Create and manage API tokens**.
  </Step>

  <Step title="Crie e copie o token">
    Crie um token, dê um rótulo (por exemplo `Myrmex`), defina uma expiração e copie-o — ele é mostrado apenas uma vez.
  </Step>
</Steps>

<Tip>
  O token herda as permissões da conta. Use uma conta dedicada restrita aos projetos certos para o menor privilégio.
</Tip>

## Passo 2 — Adicione a Integração no Myrmex

No **Directory**, escolha **Add Integration → Jira** e preencha:

| Field           | Descrição                                                                                                                     |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Name**        | Um nome único para esta instância do Jira.                                                                                    |
| **Description** | Nota opcional para identificá-la.                                                                                             |
| **API Token**   | O token do Passo 1.                                                                                                           |
| **URL**         | O host do site do seu Jira (por exemplo `your-domain.atlassian.net`).                                                         |
| **Protocol**    | `https` (padrão).                                                                                                             |
| **Port**        | Porta da API (padrão `443`).                                                                                                  |
| **Collector**   | [Collector](/pt/documentation/agent-endpoint-security/collector-mode) opcional se o Jira for alcançado de dentro da sua rede. |

## Conectar

Clique em **Connect** para validar a conexão e concluir. O Jira então aparece em **Environment → Integrations**. Novo em integrações? Veja a [visão geral de Integrações](/pt/documentation/integrations/overview).