Jira MCP no Claude Code: como conectar o board e levar o ticket direto pra sessão

Fala aí, beleza? Copiar a descrição do ticket, colar no chat, explicar de novo o que é aquele campo, lembrar o critério de aceite que ficou num comentário lá embaixo… esse vai e volta é retrabalho puro de contexto

O Jira MCP no Claude Code existe justamente pra matar esse ritual

A ponte se chama Atlassian Rovo MCP Server, o servidor oficial mantido no repositório atlassian/atlassian-mcp-server. Ele conecta Jira, Confluence, Jira Service Management, Bitbucket e Compass a clientes como Claude, ChatGPT, Cursor e VS Code, usando OAuth 2.1 ou API tokens

Na prática: o agente lê a issue direto do board, dentro da sessão onde você já está codando

Neste post tu vai ver a instalação real (comando por comando), o que dá pra fazer com o ticket dentro da sessão e, principalmente, onde isso NÃO serve. Bora?

O que você precisa antes de conectar o Jira

Antes de sair rodando comando, três coisas precisam estar de pé

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

1. Um site Atlassian Cloud ativo

Essa é a pegadinha que derruba muita gente logo no começo. O Rovo MCP Server é projetado e suportado apenas para produtos Atlassian Cloud e exige um site Cloud ativo

Jira Server e Data Center ficam de fora. Não é questão de configurar melhor, é que não atende mesmo

2. Claude Code instalado

A conexão é feita pela CLI, então o Claude Code precisa estar funcionando na sua máquina

3. Liberação do admin da organização

Esse aqui costuma ser o gargalo em empresa. O acesso ao Rovo MCP Server é controlado pelo admin dentro da Atlassian Administration, no caminho Atlassian Administration > (organização) > Rovo > Rovo MCP server

Lá existem as abas de Permissions, Authentication e Add domain, ou seja: permissões de leitura e escrita, método de autenticação e domínios permitidos passam todos pela mão do admin

Se tu não é admin, já adianta a conversa com quem é. Vai economizar uma tarde

E quem roda Jira autogerenciado?

Tem saída, só não é a oficial

Para Jira self-hosted existe o servidor mantido pela comunidade sooperset/mcp-atlassian, que suporta tanto Cloud quanto Server/Data Center e usa Personal Access Token no caso autogerenciado

O mesmo projeto da comunidade cobre Confluence Server/DC 6.0+, caso a tua documentação também more no autogerenciado

Passo a passo: conectando o Atlassian Rovo MCP Server ao Claude Code

A conexão em si é curta. O que enrola é errar o endpoint ou esquecer de autenticar, e os dois erros são clássicos

1. Adicione o servidor pela CLI

claude mcp add --transport http atlassian https://mcp.atlassian.com/v1/mcp/authv2

Esse é o endpoint canônico documentado, de Streamable HTTP com autenticação v2

O erro comum deste passo: copiar de tutorial velho e apontar pro endpoint legado https://mcp.atlassian.com/v1/sse, do transporte HTTP+SSE. Ele foi descontinuado e a Atlassian manteve compatibilidade apenas até 30 de junho de 2026, com recomendação de migrar pro Streamable HTTP. Se tu ver /v1/sse num passo a passo, o passo a passo está datado

2. Autentique de dentro da sessão

Abra o Claude Code e rode:

/mcp

É por aí que a autenticação acontece depois que o servidor foi adicionado

O erro comum deste passo: adicionar o servidor e ficar esperando a conexão se resolver sozinha. Não se resolve. O /mcp dentro da sessão aberta é parte da instalação, não um extra

3. Confira o estado da conexão

claude mcp list
claude mcp get atlassian

O claude mcp list mostra o estado de cada servidor: Connected, Needs authentication ou Failed to connect. O claude mcp get <nome> detalha um servidor específico

O erro comum deste passo: assumir que "apareceu na lista" significa "está funcionando". Aparecer na lista com Needs authentication é exatamente o cenário do passo 2 não ter sido feito

4. Compartilhe a configuração com o time

claude mcp add --scope project --transport http atlassian https://mcp.atlassian.com/v1/mcp/authv2

Com escopo de projeto, o Claude Code grava a configuração num arquivo .mcp.json (com ponto no começo) na raiz do repositório, sob a chave mcpServers. Esse arquivo pode ser versionado e compartilhado

Ou seja: quem clonar o repo já pega o servidor configurado, sem repassar comando no Slack

5. Remova quando precisar

claude mcp remove atlassian

Útil pra refazer a configuração do zero quando algo ficou torto, ou pra tirar o acesso de uma máquina

E se for pra rodar sem ninguém na frente do teclado?

Além do OAuth 2.1, o servidor aceita autenticação por API token quando o admin da organização habilita. Ela é indicada justamente pros cenários não interativos: CI/CD, bots e agentes automatizados

Nesse formato, a documentação da Atlassian coloca essa configuração no arquivo mcp.json do cliente MCP, com header Authorization usando Basic (base64 de email:api_token, no caso de token pessoal) ou Bearer (com API key de service account)

E aqui vale um aviso pra não misturar as coisas: o .mcp.json do passo 4 é o arquivo de escopo de projeto do Claude Code, enquanto o mcp.json do header Authorization é o arquivo de configuração do cliente MCP descrito pela Atlassian. Nomes parecidos, documentações diferentes, então segue a doc do cliente que tu está usando

Detalhe que pega gente desprevenida: a autenticação por API token é obrigatória para as ferramentas de Jira Service Management e Bitbucket Cloud. Se o teu fluxo passa por JSM, o OAuth sozinho não cobre

O que dá pra fazer com o ticket dentro da sessão

Aqui é onde a coisa fica massa, porque cada uso amarra numa ferramenta real exposta pelo servidor

• Ler a issue antes de codar: getJiraIssue traz a issue pro contexto da sessão, com a descrição que estava no board
• Varrer o board por critério: searchJiraIssuesUsingJql roda JQL, então dá pra pedir "as issues abertas do sprint com label X" sem sair do terminal
• Abrir bug encontrado no meio da implementação: createJiraIssue registra na hora, enquanto tu ainda lembra do detalhe
• Ajustar campos: editJiraIssue
• Mover o status ao terminar: getTransitionsForJiraIssue lista as transições disponíveis e transitionJiraIssue executa
• Registrar decisão técnica no ticket: addCommentToJiraIssue, pra aquele "fizemos assim por causa disso" não morrer no histórico do chat
• Resolver os apoios: lookupJiraAccountId pra descobrir o account ID de alguém e getVisibleJiraProjects pra ver quais projetos tu enxerga

Repare no que muda de verdade

O contexto do ticket vira insumo da sessão, não texto colado à mão. O agente não depende da tua memória do que estava escrito no board, ele lê a fonte

E isso ajuda demais quando a issue é grande: ler o ticket inteiro é o primeiro passo pra quebrar a tarefa em entregas menores em vez de despejar tudo de uma vez

Vale lembrar que varrer board com JQL é trabalho de leitura, enquanto implementar é outro tipo de esforço. Pensar em qual modelo usar em cada tarefa faz diferença no custo do fluxo inteiro

Onde o Jira MCP falha (e o que fazer)

Agora a parte honesta, porque nem tudo é topzera

A conexão nunca sai de "Needs authentication"

Sintoma: o claude mcp list insiste em mostrar Needs authentication ou Failed to connect

Causa provável: ou o /mcp não foi rodado dentro da sessão, ou o admin da organização não liberou o acesso nas configurações do Rovo MCP server

Solução: roda o /mcp primeiro. Se persistir, o caminho é a Atlassian Administration, nas abas de Permissions, Authentication e Add domain

Como prevenir: alinhar a liberação com o admin ANTES de instalar, não depois

Falha total em Jira Server ou Data Center

Sintoma: nada conecta, por mais que o comando esteja certo

Causa: o servidor oficial é só Cloud. Server e Data Center não são atendidos

Solução: partir pro sooperset/mcp-atlassian, que cobre Jira Server/DC 8.14+ com Personal Access Token

Como prevenir: confirmar se o teu Jira é Cloud ANTES de qualquer coisa. É a checagem mais rápida do post e é a que evita a tarde perdida

Leitura que trava e não volta

Sintoma: a chamada fica pendurada, sem retorno

Causa: existe issue reportada no repositório oficial (a #145 do atlassian/atlassian-mcp-server) de que getJiraIssue e searchJiraIssuesUsingJql podem travar indefinidamente na leitura de comentários de issues com ADF pesado de mídia

E o incômodo extra: segundo o relato, não há opção de desligar a leitura de comentários

Solução: tratar issue com thread gigante de prints e vídeo como caso de risco e não depender dela no meio de um fluxo automatizado

Como prevenir: acompanhar o repositório oficial, já que o comportamento é reportado por lá

O limite que nem é técnico

Esse é o principal, e nenhum comando resolve

Ticket vago entra vago na sessão

O MCP transporta contexto, ele não cria contexto. Se a descrição da issue é "ajustar tela de login", o agente recebe exatamente isso, e o resultado vai ser proporcional

Board bem escrito, com critério de aceite e cenário, vira insumo excelente. Board bagunçado só transporta a bagunça mais rápido, e agora automatizada 😅

Sobre privacidade, uma nota: a Atlassian afirma que o Rovo MCP Server não armazena nem faz cache dos dados de Jira e Confluence

Conclusão

A conexão é curta de verdade: adicionar com claude mcp add --transport http, autenticar com /mcp dentro da sessão e conferir com claude mcp list

O que separa o setup bonito do ganho real não é o comando, é a qualidade do que está escrito no board

Próximo passo sugerido: adiciona em escopo de projeto, versiona o .mcp.json com o time e testa primeiro num ticket bem escrito, daqueles com critério de aceite decente. Se funcionar bem ali, aí sim vale apostar o fluxo inteiro nisso

E se o teu Jira for autogerenciado, já sabe: o caminho é o servidor da comunidade, com Personal Access Token

até o próximo post! 🙂