Conecte o Claude Code ao Jira e ao Confluence com um único comando claude mcp add. Veja o endpoint v2, as opções de escopo, o login OAuth, os cabeçalhos do token de API, os primeiros prompts, um .mcp.json para a equipe e uma tabela de solução de problemas para os erros que você vai realmente encontrar.
Seu backlog do Jira nunca diminui, e ninguém consegue encontrar nada no Confluence. O Claude pode ler os dois, escrever nos dois e responder perguntas sobre eles sem que você cole um único chamado em uma janela de chat. A conexão inteira é uma linha de terminal: claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp. Execute, faça login uma vez no navegador, e o Claude Code poderá pesquisar no Jira com JQL, criar itens de trabalho e ler ou editar páginas do Confluence, tudo com as suas próprias permissões.
Este passo a passo percorre claude mcp add atlassian na ordem em que você realmente vai precisar: o que o servidor expõe, o que verificar primeiro, o comando exato, os três escopos, o login OAuth, uma primeira rodada de prompts, a opção de token de API para automação, o compartilhamento com a equipe e uma tabela de solução de problemas. Todos os comandos e endpoints abaixo vêm da documentação atual da Atlassian e do Claude Code, verificada em outubro de 2026.
MCP (Model Context Protocol) é o padrão aberto que permite a um cliente de IA chamar ferramentas externas. A Atlassian hospeda o próprio servidor remoto, o Atlassian Rovo MCP Server, então você não instala nada localmente. O Claude Code se conecta a uma URL, e a Atlassian cuida da autenticação, das permissões e das chamadas ao Jira e ao Confluence por trás disso.
Um único endpoint atende o Jira, o Jira Service Management, o Confluence, o Bitbucket, Projects, Goals e as gravações do Loom. Este artigo se concentra no Jira e no Confluence, o par que a maioria das equipes conecta primeiro. O login usa OAuth 2.1, e cada ação respeita os seus controles de acesso existentes. O Claude vê exatamente o que a sua conta vê, nada além disso.
Você nunca digita nomes de ferramentas. Você escreve um pedido simples, e o Claude escolhe a ferramenta correspondente. Ainda assim, conhecer o menu ajuda a formular prompts melhores:
| Produto | Leitura | Escrita | Busca |
|---|---|---|---|
| Jira | getJiraIssue, listJiraProjects, listJiraBoards, listJiraIssueComments, listJiraIssueTransitions | createJiraIssue, editJiraIssue, transitionJiraIssue, addOrEditJiraIssueComment | searchJiraIssuesUsingJql |
| Confluence | getConfluenceContent, listConfluenceSpaces, listConfluenceContent, listConfluenceComments | createConfluenceContent, updateConfluenceContent, createConfluenceComment, addLabelsToConfluenceContent | searchConfluence (CQL) |
💡 Dica: As ferramentas somente de leitura são seguras para testar primeiro. As ferramentas de escrita alteram chamados e páginas reais, então deixe-as para depois que a conexão funcionar.
A lista de verificação é curta, mas pular um item é o que mais trava as configurações:
claude --version em um terminal. Se ele mostrar uma versão, está tudo certo.
A configuração inteira leva alguns minutos depois que esses itens estiverem marcados.
Abra qualquer terminal e execute:
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp
Cada parte tem uma função:
claude mcp add registra um novo servidor MCP no Claude Code.--transport http seleciona o transporte HTTP em streaming que os servidores remotos usam.atlassian é o nome local. É o que você vai ver em /mcp e em claude mcp list.https://mcp.atlassian.com/v2/mcp é o endpoint v2 da Atlassian.💡 Dica: Textos antigos mostram um endereço v1. A documentação atual da Atlassian aponta para o v2, então copie a URL acima em vez de uma resposta antiga de fórum.
Por padrão, o comando salva o servidor no escopo local. Você pode escolher onde ele fica com --scope:
| Escopo | Flag | Carrega em | Compartilhado com a equipe | Armazenado em |
|---|---|---|---|---|
| Local (padrão) | --scope local | Somente o projeto atual | Não | ~/.claude.json |
| Projeto | --scope project | Somente o projeto atual | Sim, pelo controle de versão | .mcp.json na raiz do projeto |
| Usuário | --scope user | Todos os seus projetos | Não | ~/.claude.json |
Para uso pessoal em todos os repositórios, o escopo de usuário é a escolha prática:
claude mcp add --transport http atlassian --scope user https://mcp.atlassian.com/v2/mcp
O escopo de projeto também funciona aqui, porque a URL não carrega nenhum segredo. Cada integrante da equipe ainda faz login com a própria conta Atlassian.
Adicionar o servidor não faz o login por você. Termine com estes passos:
/mcp.claude mcp list.Prefere ficar no terminal? Rode claude mcp login atlassian. Em uma máquina sem interface gráfica, claude mcp login atlassian --no-browser exibe uma URL em vez de abrir o navegador. Para ver os detalhes de um servidor, use claude mcp get atlassian. A coluna de status mostra onde você está:
| Status | Significado |
|---|---|
| ✔ Connected | Servidor ativo e pronto |
| ! Needs authentication | Login OAuth ainda pendente |
| ✘ Failed to connect | Erro de conexão, geralmente um problema de URL ou de rede |
Comece com leituras. Um bom primeiro teste comprova que o login funciona e mostra ao Claude como a sua instância está organizada.
Pergunte em linguagem simples ou cole o JQL diretamente:
"Liste os problemas não resolvidos no projeto PAY atualizados nesta semana, ordenados por prioridade, e resuma os cinco principais."
O Claude chama searchJiraIssuesUsingJql. Se você quiser controle total, entregue a consulta pronta:
project = PAY AND status != Done AND assignee = currentUser() ORDER BY priority DESC
Quando um nome for ambíguo, peça ao Claude que rode lookupJiraAccountId para um colega antes de filtrar por responsável. Ele converte um nome de exibição ou um e-mail no ID de conta que o JQL exige.
As operações de escrita funcionam do mesmo jeito, com um hábito que vale a pena adotar: peça um rascunho primeiro.
"Rascunhe um Bug para o projeto PAY com o título 'Checkout falha com cartões salvos' usando o stack trace acima. Mostre os campos. Não crie nada até eu dizer para criar."
Nos bastidores, o Claude consulta os tipos de problema e os campos obrigatórios do projeto e, depois que você aprova, chama createJiraIssue. Mover o trabalho adiante é igualmente curto:
"Mova o PAY-142 para Em revisão e adicione um comentário com o link do pull request."
Esse pedido usa transitionJiraIssue e addOrEditJiraIssueComment. Por padrão, o Claude Code pede aprovação antes de rodar ferramentas MCP, então leia cada pedido de escrita antes de aceitar.
💡 Dica: Informe o projeto, o tipo de problema e a prioridade na sua primeira mensagem. Prompts que trazem esses detalhes precisam de menos chamadas de ferramenta e de menos perguntas de acompanhamento, o que também reduz o uso de créditos do Rovo.
O Confluence funciona por meio da busca em CQL e das ferramentas de página:
"Pesquise no Confluence nosso runbook de resposta a incidentes e resuma os passos de escalonamento."
"Crie uma página no espaço ENG chamada 'Checklist de release' a partir das anotações deste arquivo."
"Adicione um comentário no rodapé da página de integração perguntando se os passos da VPN ainda estão corretos."
As atualizações de páginas existentes podem substituir o corpo inteiro ou aplicar edições pontuais. Para qualquer coisa de que as pessoas dependam, peça ao Claude que faça edições direcionadas e mostre a mudança antes de salvar.
O OAuth atende bem o trabalho interativo do dia a dia. A autenticação por token de API atende pipelines, bots e outras execuções não interativas, em que ninguém está por perto para clicar em uma tela de consentimento. Ela é opcional, e um administrador da organização precisa ativá-la primeiro nas configurações do servidor MCP do Rovo.
A Atlassian aceita dois formatos de cabeçalho:
Authorization: Basic <base64(email:api_token)>Authorization: Bearer <credential>Gere o valor em Base64 de um token pessoal no macOS ou no Linux:
printf '%s' 'you@company.com:YOUR_API_TOKEN' | base64
No Linux, adicione -w 0 para que a saída longa fique em uma única linha. No PowerShell do Windows:
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("you@company.com:YOUR_API_TOKEN"))
Em seguida, registre o servidor com um nome diferente, para que ele possa ficar ao lado da sua entrada OAuth:
claude mcp add --transport http atlassian-ci https://mcp.atlassian.com/v2/mcp \
--header "Authorization: Basic BASE64_VALUE"
⚠️ Aviso: Trate o token como uma senha. Mantenha-o no escopo local ou de usuário, nunca em um
.mcp.jsoncommitado, e troque-o quando alguém sair da equipe.
A Atlassian observa que algumas ferramentas MCP podem não estar disponíveis com autenticação por token, porque os tokens têm escopos selecionáveis mais restritos do que uma sessão OAuth completa. Aqui está a contrapartida em uma tabela:
| OAuth 2.1 | Token de API | |
|---|---|---|
| Configuração | Login no navegador via /mcp | Ativação pelo administrador mais um cabeçalho |
| Ideal para | Trabalho interativo do dia a dia | Jobs de CI, bots, automação |
| Identidade | Seu usuário | Seu usuário, ou uma conta de serviço |
| Disponibilidade de ferramentas | Conjunto completo | Algumas ferramentas podem faltar |
Para dar a um repositório inteiro a mesma conexão, adicione o servidor no escopo de projeto ou escreva o arquivo à mão:
{
"mcpServers": {
"atlassian": {
"type": "http",
"url": "https://mcp.atlassian.com/v2/mcp"
}
}
}
Salve-o como .mcp.json na raiz do projeto e faça commit. Em sessões interativas, o Claude Code pede que cada integrante aprove os servidores do projeto antes de usá-los. Em modos não interativos, como claude -p, os servidores do projeto são carregados sem pedir confirmação. Para redefinir essas aprovações, rode claude mcp reset-project-choices.
O próprio aviso da Atlassian diz: "Em 1º de março de 2027, qualquer uso existente do v1 começará a expor e utilizar automaticamente as ferramentas v2." Clientes que guardaram credenciais antigas em cache podem precisar limpar as credenciais em cache de clientIds ou de .well-known. Se você registrou um endereço v1 meses atrás, faça uma troca limpa agora:
claude mcp logout atlassian
claude mcp remove atlassian
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp
Depois rode /mcp e faça login novamente.
Dois hábitos mantêm a configuração saudável ao longo do tempo:
A maioria das falhas se encaixa em alguns padrões. Comece com claude mcp list e depois compare com o sintoma:
| Sintoma | Causa provável | Solução |
|---|---|---|
! Needs authentication | O login nunca foi concluído ou expirou | Rode /mcp ou claude mcp login atlassian |
✘ Failed to connect | URL errada, transporte errado ou bloqueio de rede | Rode claude mcp get atlassian e confirme que o tipo é http e que a URL termina em /v2/mcp |
| O navegador nunca abre | Sessão remota ou sem interface gráfica | Use claude mcp login atlassian --no-browser |
| O login entra em loop depois de trocar de versão | Dados de cliente desatualizados em cache | Rode a sequência de logout, remoção e adição descrita acima |
| Uma ferramenta esperada está ausente | Escopos do token mais restritos do que o OAuth | Amplie os escopos do token ou mude para OAuth |
| Buscas não retornam nada para um projeto que você consegue abrir | Nome divergente | Peça ao Claude que liste os projetos do Jira que ele consegue ver e use o nome exato |
Quando nada mais funciona, remover e adicionar o servidor de novo leva cerca de dez segundos e descarta uma entrada local ruim. Depois de qualquer mudança, rode claude mcp list antes de culpar o seu prompt. Uma linha verde ✔ Connected indica que o problema está no pedido, não na conexão.
Conectar o Claude à Atlassian resolve a parte técnica. Ainda existem duas tarefas ao redor dela: escrever textos de chamados que valham a pena ler e dar às páginas do Confluence algum peso visual. O PicassoIA ajuda nas duas, como uma ferramenta separada ao lado da sua configuração do Claude Code. A conexão MCP acima roda no Claude Code, enquanto os passos abaixo acontecem no PicassoIA.
O Claude Sonnet 5 transforma anotações brutas em rascunhos limpos de chamados antes mesmo de você abrir o terminal:
low pula o raciocínio profundo e responde mais rápido. Passe para high ou max quando o problema envolver vários sistemas.Precisa de um raciocínio mais pesado para um relatório de incidente complicado? O Claude Opus 4.7 e o Claude Fable 5 estão na mesma plataforma.
Um runbook com uma imagem de cabeçalho clara é aberto com mais frequência do que um bloco de texto. O P-Image, o Flux 2 Pro, o Seedream 5 Pro e o GPT Image 2 transformam uma frase em uma foto que você pode usar como banner da página. Experimente um prompt como "um quadro branco de equipe iluminado pelo sol, com notas adesivas, profundidade de campo rasa e granulação natural de filme".
A lista de ferramentas da Atlassian inclui envio de anexos para problemas do Jira, mas apenas downloads para o Confluence, então insira a imagem final na página pelo editor do Confluence.
O PicassoIA também oferece sua própria conexão MCP para geração de imagens e vídeos, gerenciada pela sua conta. A ideia é a mesma da configuração que você acabou de fazer: conecte uma vez e depois peça em linguagem simples.
Rode o comando, faça login e peça ao Claude sua primeira busca em JQL. Depois abra o PicassoIA, escolha um modelo e crie os rascunhos de chamados e as imagens que sua equipe fica adiando. Sua próxima revisão de sprint vai agradecer.
Escolha seu idioma
