Habilidade de Integração com Jira

Recupere, analise e atualize tickets do Jira diretamente do seu fluxo de trabalho de codificação de IA. Suporta ambas as abordagens: baseada em MCP (recomendada) e API REST direta.

Quando Ativar

• Buscar um ticket do Jira para entender os requisitos
• Extrair critérios de aceitação testáveis de um ticket
• Adicionar comentários de progresso a um issue do Jira
• Transicionar o status de um ticket (A Fazer → Em Andamento → Concluído)
• Vincular pull requests ou branches a um issue do Jira
• Pesquisar issues por consulta JQL

Pré-requisitos

Opção A: Servidor MCP (Recomendado)

Instale o servidor MCP mcp-atlassian. Isso expõe as ferramentas do Jira diretamente ao seu agente de IA.

Requisitos:

• Python 3.10+
• uvx (de uv), instalado via seu gerenciador de pacotes ou a documentação oficial de instalação do uv

Adicione à sua configuração MCP (por exemplo, ~/.claude.json → mcpServers):

{
  "jira": {
    "command": "uvx",
    "args": ["mcp-atlassian==0.21.0"],
    "env": {
      "JIRA_URL": "https://YOUR_ORG.atlassian.net",
      "JIRA_EMAIL": "your.email@example.com",
      "JIRA_API_TOKEN": "your-api-token"
    },
    "description": "Jira issue tracking — search, create, update, comment, transition"
  }
}

Segurança: Nunca codifique segredos diretamente. Prefira definir JIRA_URL, JIRA_EMAIL e JIRA_API_TOKEN no seu ambiente do sistema (ou em um gerenciador de segredos). Use o bloco MCP env apenas para arquivos de configuração locais e não commitados.

Para obter um token de API do Jira:

1. Acesse https://id.atlassian.com/manage-profile/security/api-tokens
2. Clique em Criar token de API
3. Copie o token — armazene-o no seu ambiente, nunca no código-fonte

Opção B: API REST Direta

Se o MCP não estiver disponível, use a API REST v3 do Jira diretamente via curl ou um script auxiliar.

Variáveis de ambiente necessárias:

Armazene-as no ambiente do seu shell, gerenciador de segredos ou em um arquivo de ambiente local não rastreado. Não as comite no repositório.

Para exemplos diretos de curl, mantenha as credenciais fora dos argumentos da linha de comando, passando a configuração do usuário do Jira via stdin:

jira_curl() {
  printf 'user = "%s:%s"\n' "$JIRA_EMAIL" "$JIRA_API_TOKEN" |
    curl -s -K - "$@"
}

Referência de Ferramentas MCP

Quando o servidor MCP mcp-atlassian estiver configurado, estas ferramentas estarão disponíveis:

Dica: Sempre chame jira_get_transitions antes de transicionar — os IDs de transição variam por fluxo de trabalho do projeto.

Referência da API REST Direta

Buscar um Ticket

jira_curl \
  -H "Content-Type: application/json" \
  "$JIRA_URL/rest/api/3/issue/PROJ-1234" | jq '{
    key: .key,
    summary: .fields.summary,
    status: .fields.status.name,
    priority: .fields.priority.name,
    type: .fields.issuetype.name,
    assignee: .fields.assignee.displayName,
    labels: .fields.labels,
    description: .fields.description
  }'

Buscar Comentários

jira_curl \
  -H "Content-Type: application/json" \
  "$JIRA_URL/rest/api/3/issue/PROJ-1234?fields=comment" | jq '.fields.comment.comments[] | {
    author: .author.displayName,
    created: .created[:10],
    body: .body
  }'

Adicionar um Comentário

jira_curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "body": {
      "version": 1,
      "type": "doc",
      "content": [{
        "type": "paragraph",
        "content": [{"type": "text", "text": "Your comment here"}]
      }]
    }
  }' \
  "$JIRA_URL/rest/api/3/issue/PROJ-1234/comment"

Transicionar um Ticket

# 1. Obter transições disponíveis
jira_curl \

…