Claude para Confluence: como conectar, e o que ele não faz

Resumo

Conectar o Claude ao Confluence é um problema resolvido. A Atlassian oferece um servidor Rovo MCP oficial que expõe 12 ferramentas do Confluence, e é gratuito em todos os planos do Atlassian Cloud, incluindo o Free. No Claude Code é um único comando. O Confluence também é o produto mais bem suportado nesse servidor: diferente do Jira Service Management, suas ferramentas funcionam com OAuth comum, então uma tela de consentimento normal já te dá as doze sem nenhum interruptor de administrador.

A decepção aparece depois, e não é culpa do conector. Ler o Confluence funciona bem. Escrever nele é bruto, a ponto de um usuário identificado ter visto o Claude apagar silenciosamente o corpo de cada página que renomeava. E as doze ferramentas compartilham uma característica: todas esperam que um humano digite um prompt. Nenhuma delas monitora uma fila.

Se o que você realmente quer é que suas páginas do Confluence respondam perguntas de outras pessoas sem que você esteja sentado no chat, essa é uma ferramenta diferente. Venho construindo o eesel no Atlassian Marketplace desde quando aquele app de Confluence era o que pagava minhas contas, e o objetivo todo é que ele leia seu wiki e seu helpdesk, e depois redija a resposta sozinho, por US$ 0,40 por ticket ou chat atendido.

O que realmente conecta o Claude ao Confluence

Não existe uma integração do Claude específica para o Confluence. Existe um conector da Atlassian, e o Confluence viaja dentro dele.

O que faz o trabalho é o servidor Atlassian Rovo MCP, antes chamado Atlassian Remote MCP Server. É uma ponte hospedada na nuvem em https://mcp.atlassian.com/v1/mcp/authv2 que fala o Model Context Protocol, o padrão aberto que a Anthropic criou para conectar clientes de IA a sistemas externos. A Atlassian o descreve como um proxy, não um produto, e afirma claramente que "não armazena nem faz cache do seu conteúdo do Jira ou Confluence."

Dois fatos sobre ele surpreendem a maioria das pessoas.

O primeiro é o preço. É gratuito em todos os planos do Atlassian Cloud, incluindo o nível Free, e não precisa de nenhuma assinatura do Rovo, porque a própria descrição da Atlassian é que ele não é um modelo de IA, apenas uma camada de integração. O que escala com seu plano é a taxa de transferência. Os limites de taxa são 500 chamadas por hora no Free, 1.000 no Standard, e 1.000 mais 20 por usuário até 10.000 no Premium e Enterprise. Esses tetos são no nível do site, não por usuário, e são compartilhados com o Jira, então uma única sessão de agente entusiasmado pode consumir o orçamento de uma equipe pequena.

O segundo é que o Confluence recebe o tratamento amigável. Os três grupos de permissão do Confluence aceitam tanto OAuth 2.1 quanto autenticação por token de API. Isso parece trivial até você comparar com os irmãos dele.

Quando escrevi sobre Claude para Jira Service Management, a conclusão foi que um login OAuth normal não revela nenhuma ferramenta do JSM. O Confluence é o caso oposto. Passe pela tela de consentimento e você tem o conjunto completo.

Uma armadilha que trava clientes personalizados: getAccessibleAtlassianResources é uma primeira chamada obrigatória para qualquer ferramenta, porque toda chamada precisa de um cloudId. A documentação da Atlassian diz isso com todas as letras. Numa organização multi-site, é também onde o agente decide silenciosamente qual Confluence ele está prestes a escrever.

E é exclusivo da Cloud, sem nenhum caminho para Data Center. Isso é estrutural, não uma lacuna de roadmap, já que uma instância autogerenciada não tem nenhum cloudId para fornecer. O pedido no GitHub para isso está aberto desde novembro de 2025.

As doze ferramentas do Confluence, e o que elas cobrem

A Atlassian publica exatamente doze ferramentas do Confluence em três grupos de permissão: sete de leitura, quatro de escrita, uma de busca. Admins concedem por grupos inteiros, nunca individualmente.

Em vez de listá-las, aqui está o que elas significam para as nove coisas que as pessoas realmente pedem ao Claude para fazer com um wiki.

As ausências valem a pena ler duas vezes. Sem anexos, sem labels, sem histórico de páginas, sem exclusão, sem mover ou copiar, sem templates. A referência de ferramentas suportadas da Atlassian é a única página que as lista, e há pedidos de funcionalidade abertos para a maioria dessas lacunas. Se alguma lacuna aqui for um bloqueio, o caminho do marketplace costuma ser o próximo: reuni as melhores opções em melhores apps de Confluence e apps de IA para Confluence.

Como conectar o Claude ao Confluence

A configuração é rápida. A ordem importa mais que os comandos, porque a etapa de consentimento do admin é o que trava a maioria das primeiras tentativas.

1. Tenha um administrador do site pronto. O servidor Rovo MCP não é um app do Marketplace que se instala com antecedência. Ele se instala just-in-time, na primeira vez que alguém completa o fluxo de consentimento OAuth, e um administrador do site precisa aprovar esse primeiro consentimento. Se você não é admin, pergunte antes de começar, não depois de bater na parede.

2. Adicione o conector na sua superfície. No Claude Code é uma linha:

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

Depois rode /mcp dentro de uma sessão para autenticar. Para uma configuração no escopo do projeto, o próprio .mcp.json do repositório é o equivalente:

{
  "mcpServers": {
    "atlassian": {
      "type": "http",
      "url": "https://mcp.atlassian.com/v1/mcp/authv2"
    }
  }
}

No Claude Desktop é Settings, depois Extensions, depois Browse extensions, depois buscar por Atlassian. No claude.ai não há JSON nenhum: você adiciona a listagem do Atlassian Rovo do diretório de conectores, que é uma listagem oficial feita pela Atlassian, não um projeto da comunidade.

3. Decida os grupos de permissão antes de consentir, não depois. Admins controlam o acesso no nível de grupo pela aba de permissões, onde cada um aparece como Permitido, Bloqueado ou Parcialmente permitido. Se você só quer leitura, bloqueie write_confluence agora. Não há ferramenta de desfazer se um agente bagunçar uma página depois.

4. Verifique o caminho de rede se o Confluence estiver atrás de algo. O Claude alcança o servidor MCP a partir da nuvem da Anthropic, não do seu notebook, em todos os clientes, incluindo o Desktop. Uma configuração com firewall precisa liberar as faixas de IP da Anthropic. O controle de domínio da Atlassian também é tudo ou nada: você pode permitir ou bloquear a lista inteira de parceiros, então não dá pra permitir o Claude enquanto recusa o ChatGPT.

5. Nomeie o conector nos seus prompts. Isso só aparece na prática, e um usuário do Reddit resumiu bem.

"I have had quite a bit of luck using it with JIRA and Confluence to read docs/tickets as well as generate them. I am using it mostly through Claude Code and Claude Desktop on Mac. I find if I'm not super explicit that I want it to use the MCP it will go haywire."

ChezTheHero, r/ClaudeAI, Reddit

Naquilo em que a conexão é realmente boa

Recuperação de informação. Essa é a resposta honesta, e é mais importante do que parece, porque a busca nativa do Confluence tem fama.

O maior endosso que encontrei veio de um desenvolvedor comparando a busca via MCP com a própria do Confluence:

"Considering how poor the Confluence search function is, the results from Confluence via an MCP-powered search are remarkably good. I was able to solve one or two obscure, company-specific issues purely by using the MCP search, and I'm convinced that finding these pages would have been almost impossible without it."

icanintospace, Hacker News

Isso combina com o propósito das ferramentas. Um modelo que consegue chamar searchConfluenceUsingCql, ler os resultados, e depois descer uma árvore de páginas com getConfluencePageDescendants está fazendo algo que a caixa de busca do Confluence estruturalmente não consegue. Se preferir construir esse loop você mesmo, o guia sobre a API de IA do Confluence cobre o caminho direto.

O conector também traz seis skills de agente empacotadas, quatro delas envolvendo o Confluence: Search Company Knowledge executa buscas paralelas citadas, Spec to Backlog transforma uma especificação do Confluence em épicos e tickets do Jira, Generate Status Reports puxa issues do Jira para uma página publicada do Confluence, e Capture Tasks from Meeting Notes faz exatamente o que o nome diz. Se você já usa gestão de projetos com Atlassian AI, Spec to Backlog é a que mais vale testar primeiro, e a metade referente ao Jira se sobrepõe bastante ao que faz um copiloto de Jira. A skill de relatórios de status é o que mais se aproxima aqui de uma automação de fluxo de trabalho do Confluence de verdade.

Vale saber sobre o próprio repositório: atlassian/atlassian-mcp-server não contém nenhum código-fonte do servidor. É o README, um manifesto, um plugin do Claude Code, e essas skills. O servidor é de código fechado e hospedado na nuvem. Tem 952 estrelas, licença Apache-2.0 e 78 issues abertas, 34 delas relacionadas ao Confluence.

Onde quebra: escrever no Confluence

Ler é sólido. Escrever é onde eu desaceleraria, e a evidência para isso é incomumente específica.

Em maio de 2026, um usuário postou um relato de perda de dados na Atlassian Community que é o artefato mais contundente de todo esse tema:

"I used Claude via the Atlassian Rovo MCP connector to rename and reorganize pages in my Confluence workspace. Claude sent update calls that changed the title but did not include the body field. The Confluence API interpreted the missing body as an instruction to clear the page content. Every page that was renamed had its entire body silently deleted."

Ryan Wilson, Atlassian Community

O mesmo post observa que uma chamada que reduz uma página de 15.000 caracteres a zero executa sem nenhum aviso ou confirmação.

Crédito onde é devido: a Atlassian não ficou em silêncio sobre isso. Um desenvolvedor da equipe do Confluence MCP respondeu no dia seguinte dizendo que a equipe corrigiria, e em julho de 2026 informou que "na prévia do V2 MCP que acabamos de lançar, reescrevemos completamente como funcionam as edições de página do Confluence para usar edições direcionadas e granulares." Se você está lendo isso depois que o V2 foi lançado amplamente, o defeito específico está resolvido.

A pressão de design subjacente ainda está lá, no entanto, e ela explica um conjunto de issues abertas. updateConfluencePage quer o corpo completo da página a cada edição, sem opção de patch ou intervalo. A issue #106 documenta o que isso custa em escala: corpos ADF chegam a 50-70 KB, o modelo precisa manter tudo isso e reemitir dentro de uma chamada de ferramenta, e o Claude Code persiste em disco saídas de ferramentas acima de cerca de 20 KB, então o conteúdo nunca chega ao contexto de trabalho. Relatos relacionados cobrem âncoras de comentários inline removidas, imagens e sumários removidos, e um teto de escrita de aproximadamente 5 KB no conector do Claude causado por uma regra do Cloudflare na borda.

Depois há o atrito que não tem nada a ver com o Confluence e tudo a ver com continuar logado. O tópico da Atlassian Community sobre isso tem mais de 16.500 visualizações.

"Atlassian MCP is unusable due to the longevity of their auth tokens. Needing to reauthenticate twice a working day is horrible. Why can;t I inject my personal access token into it; that is longlived and properly in control."

Jochem Berends, Atlassian Community

Outro usuário no mesmo tópico relata precisar reautenticar aproximadamente a cada 30 minutos. É a queixa operacional mais citada sobre o servidor, e é o motivo pelo qual existe uma pequena indústria artesanal de servidores Atlassian MCP feitos à mão.

O teto de permissões que ninguém verifica primeiro

Aqui está a parte tranquilizadora, seguida da parte que custa uma semana das pessoas.

O acesso é limitado às permissões existentes do Confluence do usuário logado. A Atlassian afirma isso em três lugares separados, incluindo que o servidor opera "dentro das permissões do usuário logado e acessando apenas os dados que ele tem permissão para ver." Um espaço restrito permanece invisível. getConfluenceSpaces retorna apenas o que aquela conta já pode abrir. O servidor MCP não concede absolutamente nenhuma elevação.

O custo dessa garantia é que a qualidade da sua resposta é limitada pela conta que você conectou, não pelo que está no Confluence. Esse é o falso alarme mais comum que vejo na fila de suporte do eesel, e ele não parece nada com um problema de permissões de fora. Um cliente conecta o Confluence, vê 92 documentos indexarem direitinho, depois faz uma pergunta que esses documentos obviamente respondem, e não recebe nada de volta. Todo dashboard diz que a sincronização foi bem-sucedida, porque foi. As páginas estavam escondidas por ACLs o tempo todo. Já vi o próprio agente do eesel diagnosticar errado esse exato estado como falha de sincronização, o que é pior que inútil, porque o cliente então vai e reautoriza uma integração que nunca esteve quebrada.

Três anos colocando IA em filas de suporte reais me ensinaram a verificar isso antes de tudo. Quando a recuperação parece misteriosamente vazia, a pergunta nunca é "o índice está funcionando". É "o que a conta conectada realmente consegue ver".

Duas lacunas relacionadas valem a pena sinalizar para quem conduz sua revisão de segurança. Não há como restringir o servidor a espaços específicos, que é a issue mais discutida do repositório com 23 comentários, então um admin que conecta a própria conta entrega ao agente o alcance de um admin sobre todo espaço que ele pode editar. E a Atlassian é explícita de que o Rovo MCP fica de fora da sua cobertura HIPAA, junto com a CLI, a extensão do Chrome, e os apps mobile e desktop, mesmo com o Rovo Chat, Agents e Search dentro do escopo. Também não há suporte a FedRAMP.

Seu Confluence é o gargalo, não o Claude

Essa é a parte que a maioria dos guias pula, e é a que decide se a implantação vai dar certo.

No Hacker News, Reddit e G2, a mesma constatação chega de forma independente de pessoas que não têm razão nenhuma para concordar entre si. A frase mais clara veio de um tópico sobre IA e trabalho de engenharia:

"How can AI search into documentation, if the documentation is a thousands of obsolete and contradicting Jira tickets, few outdated Confluence pages with mail attachments and handful of excel files on SharePoint?"

ponector, Hacker News

Um gerente de engenharia colocou um número naquilo que sempre me vem à cabeça:

"we had a confluence wiki with 400+ pages. nobody read it. nobody updated it. new hires were told 'the wiki has everything' and then spent a week being confused because the wiki was 60% outdated."

r/Notion, replacing a Confluence wiki

O que transforma isso em mais que reclamação é onde o mesmo ponto aparece em seguida. Na listagem do Rovo do G2, que está em 4,6 de 5 com apenas sete avaliações, a crítica vem de avaliadores satisfeitos. Um SDET enterprise que deu nota 4 de 5 escreveu que "a maior limitação é que o Rovo só pode ser tão eficaz quanto os dados subjacentes. Se a documentação estiver desatualizada, inconsistente ou incompleta, os resultados de busca e os insights gerados por IA podem nem sempre ser tão precisos ou úteis quanto o esperado." Um engenheiro de BI em cloud, em um mês diferente e um setor diferente, chegou independentemente ao mesmo lugar.

O modo de falha que importa não é "a IA não conseguiu achar nada". É o caso da página duplicada, onde três versões sobrepostas de uma política existem e o modelo escolhe com confiança a errada. Alguém no Hacker News flagrou o Rovo fazendo a versão pura disso em conteúdo do Confluence, inventando o significado de uma sigla que na verdade era só uma palavra que alguém tinha digitado em maiúsculas.

Nada disso é culpa do Claude, e trocar de modelo não vai resolver. Por isso meu guia sobre integração de conhecimento do Confluence gasta mais tempo com curadoria do que com conectores, e por isso equipes que comparam alternativas ao Confluence frequentemente descobrem que a migração também não resolve. A podridão te acompanha. O mesmo vale se você estiver avaliando Confluence vs. SharePoint ou conectando páginas via n8n.

Rovo ou Claude: quem deveria ler seu Confluence?

A própria IA da Atlassian vive dentro do Confluence e não precisa de configuração, então é a comparação óbvia. A diferença real é o medidor.

A aritmética de créditos é onde isso fica concreto. Uma resposta rápida do Rovo Chat custa 10 créditos, uma execução de agent custa 10, e uma consulta de Deep Research custa 100. Então um assento Confluence Premium com 70 créditos por mês compra sete respostas de chat, ou dois terços de uma consulta de Deep Research. Busca, resumos e definições são grátis e não tocam no medidor, o que é um ponto real a favor do Rovo para uso ocasional.

Duas ressalvas de justiça. A Atlassian diz que atualmente não cobra por excesso de uso, se comprometeu com 90 dias de aviso prévio antes de fazer isso, e os dashboards de créditos só chegam ao Admin Hub em agosto de 2026, então ninguém está recebendo faturas surpresa hoje. E a lista de conectores do Rovo é ampla, cobrindo Google Drive, Slack, SharePoint, GitHub e cerca de 40 outras fontes de terceiros.

Minha leitura: se você vive no Confluence o dia todo e faz perguntas ocasionais a ele, o Rovo está de bom tamanho e é gratuito o suficiente. Se você faz trabalho sustentado em muitas páginas, o Claude via MCP é o melhor instrumento, porque não existe um medidor por pergunta te fazendo hesitar. Aprofundo mais em IA de busca do Confluence e Copiloto de IA do Confluence, com o passo a passo de configuração em Copiloto do Confluence.

Quanto isso custa de verdade

O conector é gratuito. Tudo abaixo dele não é. O Confluence Cloud precifica numa escada progressiva por usuário, então o número por assento cai conforme você adiciona pessoas.

Duas coisas nessa tabela pegam as pessoas de surpresa. O plano Free não tem absolutamente nenhuma permissão de espaço ou página, o que o torna um péssimo lugar para testar qualquer coisa relacionada a IA, já que a restrição de permissões que torna o acesso MCP seguro simplesmente não existe. E o Rovo precisa de um domínio empresarial verificado, então uma organização em um domínio de e-mail de consumidor não consegue ativá-lo.

Também há um prazo que vale anotar: o Confluence Data Center vira somente leitura em 28 de março de 2029. Para um detalhamento mais completo, veja meus artigos sobre preços do Confluence e preços do Confluence AI, e o guia de preços do Jira se você estiver comprando os dois.

Quando uma janela de chat é o lugar errado para a resposta

Tudo acima assume que a pessoa que precisa da resposta é a mesma que está digitando no Claude. Isso cobre muito trabalho real: um engenheiro reconstruindo uma decisão, um PM transformando uma especificação em tickets, um novo contratado tentando achar o runbook de deploy.

Não cobre o caso ao qual dedico a maior parte do meu tempo, que é alguém fora da sua empresa fazendo uma pergunta que o seu Confluence já responde.

As doze ferramentas são todas pull. Uma pessoa pergunta, o Claude busca, a resposta cai no chat. Nada no conjunto monitora uma caixa de entrada, lê um ticket recebido, ou envia uma resposta. Isso não é um descuido no design da Atlassian; é exatamente para isso que serve um servidor MCP.

O segundo problema é que um wiki só tem metade da resposta. Um cliente perguntando onde está o pedido dele precisa da política de envio e do registro do pedido. Um novo contratado perguntando sobre o saldo de férias precisa da política e do seu próprio saldo. O Confluence tem a primeira e nada da segunda, por isso uma resposta de suporte montada só a partir de documentação tende a ser correta e inútil ao mesmo tempo. Meu artigo sobre IA agêntica no Confluence detalha o que fechar essa lacuna envolve, e encontrar um agente de Confluence cobre a lista de opções.

Se o leitor que você atende é interno e técnico, pare aqui. O servidor Rovo MCP mais o Claude é uma boa configuração, e eu usaria. Se o leitor é um cliente ou um funcionário abrindo uma solicitação, você precisa de algo do outro lado da fila.

eesel AI para Confluence

Tenho uma história mais longa com esse problema do que a maioria, e não uma lisonjeira no começo. O primeiro motor de crescimento real do eesel foi um app do Atlassian Marketplace chamado ChatGPT for Confluence, hoje AI for Confluence. As pessoas instalavam pelo marketplace sem nenhuma etapa de cartão de crédito e simplesmente continuavam pagando, o que me ensinou cedo que a demanda não era por uma barra de busca de wiki melhor. Era para o wiki parar de ser algo que você precisa ir ler.

Então o eesel trabalha pelo outro lado. Ele indexa o Confluence do mesmo jeito que o servidor Rovo MCP o lê, e depois se instala no seu helpdesk, no seu Slack, ou num widget de chat, e redige a resposta sozinho. Ninguém precisa abrir o Claude. Quando não está confiante, ele passa para um humano com as fontes anexadas, em vez de chutar.

Três coisas que decorrem diretamente dos limites acima:

• Ele simula contra seu histórico real antes de ir ao ar. Já vi um bot com tom confiante entregar silenciosamente respostas erradas a partir de uma página desatualizada, exatamente o modo de falha de página duplicada que este artigo descreve. Rodar uma implantação primeiro contra tickets passados é a única forma que conheço de pegar isso antes que um cliente pegue.
• Não é exclusivo de Cloud. O servidor Rovo MCP não tem nenhum caminho para Data Center e estruturalmente não pode ter. Se o seu Confluence é autogerenciado, isso é um bloqueio total para o conector oficial, mas não para o eesel.
• O preço é por tarefa atendida, a US$ 0,40, seja um ticket ou uma sessão de chat, sem taxa por assento e sem medidor de créditos para racionar. Há US$ 50 de uso gratuito para testar, sem necessidade de cartão.

Um diretor de desenvolvimento em uma empresa europeia de compliance de RH, rodando exatamente essa configuração no Confluence e no Slack, colocou o requisito de forma direta:

"We needed a turnkey solution for Confluence that met our GDPR requirements and could serve different teams through dedicated Slack bots. eesel AI delivered exactly that, with EU data residency included."

Um chief innovation officer em uma empresa de pagamentos, também no Confluence, relatou até 80% de economia de tempo ao encontrar respostas e integrar novos funcionários. Essas são as duas formas que isso costuma assumir: com cara de compliance, ou com cara de velocidade.

Se você quiser a versão do lado do Claude dessa comparação para outras ferramentas, escrevi Claude para Jira Service Management, um olhar mais amplo sobre Atlassian AI, e o artigo sobre o assistente de roadmap do Confluence. E se você está avaliando o próprio wiki em vez da IA por cima, Confluence vs. Notion e minha análise do Confluence são os lugares para começar.