Claude para Confluence: cómo conectarlo y qué no puede hacer

Qué conecta realmente Claude con Confluence

No existe una integración de Claude específica para Confluence. Existe un conector de Atlassian, y Confluence viaja dentro de él.

Lo que hace el trabajo es el servidor Atlassian Rovo MCP, antes el Atlassian Remote MCP Server. Es un puente alojado en la nube en https://mcp.atlassian.com/v1/mcp/authv2 que habla el Model Context Protocol, el estándar abierto que Anthropic creó para conectar clientes de IA con sistemas externos. Atlassian lo describe como un proxy más que un producto, y afirma llanamente que "no almacena ni cachea tu contenido de Jira o Confluence."

Dos hechos sobre él sorprenden a la mayoría de la gente.

El primero es el precio. Es gratuito en todos los planes de Atlassian Cloud, incluido el nivel Free, y no necesita ninguna suscripción a Rovo, porque el planteamiento del propio Atlassian es que no es un modelo de IA en absoluto, solo una capa de integración. Lo que escala con tu plan es el rendimiento. Los límites de tasa son 500 llamadas por hora en Free, 1.000 en Standard, y 1.000 más 20 por usuario hasta 10.000 en Premium y Enterprise. Esos techos son a nivel de sitio, no por usuario, y se comparten con Jira, así que una sola sesión de agente entusiasta puede consumir el presupuesto de un equipo pequeño.

El segundo es que Confluence recibe el trato amable. Los tres grupos de permisos de Confluence aceptan tanto OAuth 2.1 como autenticación por token de API. Suena a curiosidad hasta que lo comparas con sus hermanos.

Cuando escribí sobre Claude para Jira Service Management, la conclusión fue que un inicio de sesión OAuth normal no revela ninguna herramienta de JSM. Confluence es el caso opuesto. Pasa por la pantalla de consentimiento y tienes el conjunto completo.

Una trampa que hace tropezar a los clientes personalizados: getAccessibleAtlassianResources es una llamada inicial obligatoria para cualquier herramienta, porque cada llamada necesita un cloudId. La documentación de Atlassian lo dice con esas palabras. En una organización multi-sitio, es también donde el agente decide en silencio a qué Confluence está a punto de escribir.

Y es exclusivo de Cloud, sin ninguna vía de Data Center. Eso es estructural, no un vacío de la hoja de ruta, ya que una instancia autogestionada no tiene ningún cloudId que entregar. La solicitud en GitHub para ello está abierta desde noviembre de 2025.

Las doce herramientas de Confluence, y lo que cubren

Atlassian publica exactamente doce herramientas de Confluence repartidas en tres grupos de permisos: siete de lectura, cuatro de escritura, una de búsqueda. Los administradores las conceden en grupos completos, nunca de forma individual.

En vez de listarlas, esto es lo que significan para las nueve cosas que la gente realmente pide a Claude que haga con un wiki.

Las ausencias merecen leerse dos veces. Sin adjuntos, sin etiquetas, sin historial de páginas, sin borrado, sin mover ni copiar, sin plantillas. La referencia de herramientas soportadas de Atlassian es la única página que las enumera, y hay solicitudes de funcionalidad abiertas para la mayoría de esas carencias. Si una de estas carencias es un bloqueante, la ruta del marketplace suele ser lo siguiente: he recopilado las mejores opciones en las mejores apps de Confluence y en apps de IA para Confluence.

Cómo conectar Claude a Confluence

La configuración es rápida. El orden importa más que los comandos, porque el paso de consentimiento del administrador es lo que frena la mayoría de los primeros intentos.

1. Ten preparado a un administrador del sitio. El servidor Rovo MCP no es una app del Marketplace que se instale con antelación. Se instala en el momento, la primera vez que alguien completa el flujo de consentimiento OAuth, y un administrador del sitio tiene que aprobar ese primer consentimiento. Si no eres administrador, pregunta antes de empezar y no después de chocar contra la pared.

2. Añade el conector en tu superficie. En Claude Code es una línea:

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

Luego ejecuta /mcp dentro de una sesión para autenticarte. Para una configuración a nivel de proyecto, el propio .mcp.json del repositorio es el equivalente:

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

En Claude Desktop es Settings, luego Extensions, luego Browse extensions, y buscar Atlassian. En claude.ai no hay ningún JSON en absoluto: añades el listado de Atlassian Rovo desde el directorio de conectores, que es un listado de primera parte hecho por Atlassian y no un proyecto comunitario.

3. Decide los grupos de permisos antes de dar el consentimiento, no después. Los administradores controlan el acceso a nivel de grupo desde la pestaña de permisos, donde cada uno se muestra como Permitido, Bloqueado o Parcialmente permitido. Si solo quieres lectura, bloquea write_confluence ahora. No hay herramienta de deshacer si un agente estropea una página más tarde.

4. Comprueba la ruta de red si Confluence está detrás de algo. Claude llega al servidor MCP desde la nube de Anthropic, no desde tu portátil, en todos los clientes incluido Desktop. Una configuración con firewall necesita los rangos de IP de Anthropic en la lista de permitidos. El control de dominios de Atlassian es también todo o nada: puedes permitir o bloquear toda la lista de socios, así que no puedes permitir Claude y a la vez rechazar ChatGPT.

5. Nombra el conector en tus prompts. Esto solo se ve en la práctica, y un usuario de Reddit lo expresó bien.

"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

En qué es realmente bueno la conexión

Recuperación de información. Esa es la respuesta honesta, y es más importante de lo que parece, porque la búsqueda nativa de Confluence tiene fama.

El respaldo más contundente que encontré vino de un desarrollador que comparaba la búsqueda por MCP con la propia de 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

Eso encaja con para qué están hechas las herramientas. Un modelo que puede llamar a searchConfluenceUsingCql, leer los resultados y luego bajar por un árbol de páginas con getConfluencePageDescendants está haciendo algo que el cuadro de búsqueda de Confluence estructuralmente no puede. Si prefieres construir ese bucle tú mismo, la guía de API de IA de Confluence cubre la vía directa.

El conector también incluye seis habilidades de agente empaquetadas, cuatro de las cuales tocan Confluence: Search Company Knowledge ejecuta búsquedas paralelas y citadas, Spec to Backlog convierte una especificación de Confluence en épicas y tickets de Jira, Generate Status Reports vuelca issues de Jira en una página publicada de Confluence, y Capture Tasks from Meeting Notes hace justo lo que dice. Si ya usas gestión de proyectos con Atlassian AI, Spec to Backlog es la que merece la pena probar primero, y la mitad de Jira se solapa mucho con lo que hace un copiloto de Jira. La habilidad de informes de estado es lo más parecido aquí a una automatización de flujo de trabajo de Confluence real.

Vale la pena saber sobre el propio repositorio: atlassian/atlassian-mcp-server no contiene código fuente del servidor en absoluto. Es el README, un manifiesto, un plugin de Claude Code y esas habilidades. El servidor es de código cerrado y alojado en la nube. Tiene 952 estrellas, una licencia Apache-2.0 y 78 issues abiertos, 34 de ellos relacionados con Confluence.

Dónde se rompe: escribir en Confluence

Leer es sólido. Escribir es donde yo iría más despacio, y la evidencia para ello es inusualmente concreta.

En mayo de 2026, un usuario publicó un informe de pérdida de datos en la comunidad de Atlassian que es el artefacto más contundente de todo este 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

La misma publicación señala que una llamada que reduce una página de 15.000 caracteres a cero se ejecuta sin ningún aviso ni confirmación.

Hay que reconocer el mérito: Atlassian no ignoró esto. Un desarrollador del equipo de Confluence MCP respondió al día siguiente diciendo que el equipo lo arreglaría, y en julio de 2026 confirmó que "en la vista previa de V2 MCP recién publicada, hemos reescrito por completo cómo funcionan las ediciones de páginas de Confluence para usar ediciones específicas y granulares." Si estás leyendo esto después de que V2 se despliegue de forma amplia, el defecto concreto está resuelto.

La presión de diseño subyacente sigue ahí, sin embargo, y explica un grupo de issues abiertos. updateConfluencePage quiere el cuerpo completo de la página en cada edición, sin opción de parche ni de rango. El issue #106 documenta lo que eso cuesta a gran escala: los cuerpos ADF alcanzan de 50 a 70 KB, el modelo tiene que mantener todo eso en memoria y reemitirlo dentro de una llamada a herramienta, y Claude Code persiste en disco las salidas de herramientas de más de unos 20 KB, así que el contenido nunca llega al contexto de trabajo. Informes relacionados cubren anclajes de comentarios en línea eliminados, imágenes y tablas de contenido eliminadas, y un límite de escritura de unos 5 KB en el conector de Claude causado por una regla de Cloudflare en el borde.

Luego está la fricción que no tiene nada que ver con Confluence y sí con mantener la sesión iniciada. El hilo de la comunidad de Atlassian sobre esto tiene más de 16.500 visitas.

"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

Otro usuario en el mismo hilo dice que tiene que reautenticarse aproximadamente cada 30 minutos. Es la queja operativa más citada sobre el servidor, y es la razón por la que existe una pequeña industria artesanal de servidores Atlassian MCP hechos a mano.

El techo de permisos que nadie comprueba primero

Aquí está la parte tranquilizadora, seguida de la parte que le cuesta a la gente una semana.

El acceso está limitado a los permisos de Confluence existentes del usuario que ha iniciado sesión. Atlassian lo afirma en tres sitios distintos, incluyendo que el servidor opera "dentro de los permisos del usuario que ha iniciado sesión y accediendo solo a los datos que puede ver." Un espacio restringido permanece invisible. getConfluenceSpaces devuelve solo lo que esa cuenta ya puede abrir. El servidor MCP no otorga ninguna elevación en absoluto.

El coste de esa garantía es que la calidad de tu respuesta está limitada por la cuenta que conectaste, no por lo que hay en Confluence. Esta es la falsa alarma más común que veo en la cola de soporte de eesel, y desde fuera no se parece en nada a un problema de permisos. Un cliente conecta Confluence, ve 92 documentos indexarse sin problemas, y luego hace una pregunta que esos documentos obviamente responden, y no recibe nada. Todos los paneles dicen que la sincronización tuvo éxito, porque así fue. Las páginas estaban ocultas por ACLs todo el tiempo. He visto al propio agente de eesel diagnosticar mal ese estado exacto como un fallo de sincronización, lo cual es peor que inútil, porque el cliente entonces va y reautoriza una integración que nunca estuvo rota.

Tres años poniendo IA en colas de soporte reales me han enseñado a comprobar esto antes que nada. Cuando la recuperación de información parece misteriosamente vacía, la pregunta nunca es "funciona el índice". Es "qué puede ver realmente la cuenta conectada".

Hay dos carencias relacionadas que merece la pena señalar a quien lleve tu revisión de seguridad. No hay forma de limitar el servidor a espacios concretos, que es el issue del repositorio más comentado con 23 comentarios, así que un administrador que conecta su propia cuenta le entrega al agente el alcance de un administrador sobre cada espacio que puede editar. Y Atlassian es explícito en que Rovo MCP queda excluido de su cobertura HIPAA, junto con la CLI, la extensión de Chrome y las apps móviles y de escritorio, aunque Rovo Chat, Agents y Search sí están dentro del alcance. Tampoco hay soporte FedRAMP.

Tu Confluence es el cuello de botella, no Claude

Esta es la parte que la mayoría de las guías se saltan, y es la que decide si la implementación funciona.

En Hacker News, Reddit y G2, el mismo hallazgo llega de forma independiente de gente que no tiene ninguna razón para estar de acuerdo entre sí. La frase más clara vino de un hilo sobre IA y trabajo de ingeniería:

"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

Un manager de ingeniería puso una cifra a la que sigo volviendo:

"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

Lo que convierte esto en algo más que quejas es dónde aparece el mismo punto a continuación. En el listado de Rovo de G2, que está en 4,6 sobre 5 con solo siete reseñas, la crítica viene de reseñadores satisfechos. Un SDET de empresa que puntuó 4 sobre 5 escribió que "la mayor limitación es que Rovo solo puede ser tan eficaz como los datos subyacentes. Si la documentación está desactualizada, es inconsistente o incompleta, los resultados de búsqueda y las conclusiones generadas por IA puede que no sean siempre tan precisos o útiles como se esperaba." Un ingeniero de BI en la nube, en un mes distinto y una industria distinta, llegó de forma independiente al mismo sitio.

El modo de fallo que importa no es "la IA no encontró nada". Es el caso de la página duplicada, donde existen tres versiones superpuestas de una política y el modelo elige con confianza la equivocada. Alguien en Hacker News pilló a Rovo haciendo la versión pura de esto sobre contenido de Confluence, inventando el desarrollo de un acrónimo que en realidad era solo una palabra que alguien había escrito en mayúsculas.

Nada de eso es culpa de Claude, y cambiar de modelo no lo arreglará. Por eso mi guía de integración de conocimiento en Confluence dedica más tiempo a la curación que a los conectores, y por eso los equipos que comparan alternativas a Confluence a menudo descubren que la migración tampoco lo arregla. La podredumbre te sigue. Lo mismo ocurre si estás sopesando Confluence frente a SharePoint o conectando páginas mediante n8n.

Rovo o Claude: ¿quién debería leer tu Confluence?

La propia IA de Atlassian vive dentro de Confluence y no necesita configuración, así que es la comparación obvia. La diferencia real es el medidor.

La aritmética de créditos es donde esto se vuelve concreto. Una respuesta rápida de Rovo Chat cuesta 10 créditos, una ejecución de agent cuesta 10, y una consulta de Deep Research cuesta 100. Así que un puesto Premium de Confluence con 70 créditos al mes compra siete respuestas de chat, o dos tercios de una consulta de Deep Research. La búsqueda, los resúmenes y las definiciones son gratis y no tocan el medidor, lo cual es un punto real a favor de Rovo para un uso ocasional.

Dos notas de justicia. Atlassian dice que actualmente no factura por exceso de uso, se ha comprometido a un aviso de 90 días antes de hacerlo, y los paneles de créditos no llegan al Admin Hub hasta agosto de 2026, así que hoy nadie recibe facturas sorpresa. Y la lista de conectores de Rovo es amplia, y cubre Google Drive, Slack, SharePoint, GitHub y unas 40 fuentes de terceros más.

Mi lectura: si vives en Confluence todo el día y le haces preguntas ocasionales, Rovo está bien y es lo bastante gratuito. Si haces trabajo sostenido en muchas páginas, Claude vía MCP es el mejor instrumento, porque no hay un medidor por pregunta que te haga dudar. Profundizo más en IA de búsqueda de Confluence y Copiloto de IA de Confluence, con el recorrido de configuración en Copiloto de Confluence.

Lo que esto cuesta en realidad

El conector es gratis. Todo lo que hay debajo no lo es. Confluence Cloud fija precios en una escala progresiva por usuario, así que el número por puesto baja al añadir gente.

Dos cosas de esa tabla pillan a la gente desprevenida. El plan Free no tiene ningún permiso de espacio o página en absoluto, lo que lo convierte en un mal sitio para probar nada relacionado con IA, ya que la limitación de permisos que hace seguro el acceso por MCP simplemente no existe. Y Rovo necesita un dominio empresarial verificado, así que una organización en un dominio de correo de consumidor no puede activarlo.

También hay una fecha que conviene anotar: Confluence Data Center pasa a ser de solo lectura el 28 de marzo de 2029. Para un desglose más completo, consulta mis artículos sobre precios de Confluence y precios de Confluence AI, y la guía de precios de Jira si estás comprando ambos.

Cuando una ventana de chat es el lugar equivocado para la respuesta

Todo lo anterior asume que la persona que necesita la respuesta es la misma que está escribiendo en Claude. Eso cubre mucho trabajo real: un ingeniero reconstruyendo una decisión, un PM convirtiendo una especificación en tickets, un nuevo empleado intentando encontrar el manual de despliegue.

No cubre el caso al que dedico la mayor parte de mi tiempo, que es alguien fuera de tu empresa haciendo una pregunta que tu Confluence ya responde.

Las doce herramientas son todas pull. Una persona pregunta, Claude recupera, la respuesta aterriza en el chat. Nada en el conjunto vigila una bandeja de entrada, lee un ticket entrante ni envía una respuesta. Eso no es un descuido en el diseño de Atlassian; es exactamente para lo que sirve un servidor MCP.

El segundo problema es que un wiki solo contiene la mitad de la respuesta. Un cliente que pregunta dónde está su pedido necesita la política de envíos y el registro del pedido. Un nuevo empleado que pregunta por su saldo de vacaciones necesita la política y su propio saldo acumulado. Confluence tiene lo primero y nada de lo segundo, por lo que una respuesta de soporte ensamblada solo con documentación tiende a ser correcta e inútil al mismo tiempo. Mi artículo sobre IA agéntica en Confluence explica en qué consiste cerrar esa brecha, y encontrar un agente de Confluence cubre la lista de opciones.

Si el lector al que sirves es interno y técnico, para aquí. El servidor Rovo MCP más Claude es una buena configuración y yo la usaría. Si el lector es un cliente o un empleado que plantea una solicitud, necesitas algo al otro lado de la cola.

eesel AI para Confluence

Tengo una historia más larga con este problema que la mayoría, y no una que empiece bien. El primer motor de crecimiento real de eesel fue una app del Atlassian Marketplace llamada ChatGPT for Confluence, ahora AI for Confluence. La gente la instalaba desde el marketplace sin ningún paso de tarjeta de crédito y simplemente seguía pagando, lo cual me enseñó pronto que la demanda no era por un mejor cuadro de búsqueda de wiki. Era porque el wiki dejara de ser algo que hay que ir a leer.

Así que eesel trabaja desde el otro extremo. Indexa Confluence de la misma manera que lo lee el servidor Rovo MCP, y luego se asienta en tu helpdesk, tu Slack o un widget de chat y redacta la respuesta él mismo. Nadie tiene que abrir Claude. Cuando no está seguro, se lo pasa a un humano con las fuentes adjuntas en vez de adivinar.

Tres cosas que se derivan directamente de los límites anteriores:

• Simula contra tu historial real antes de salir en vivo. He visto a un bot que sonaba muy seguro dar en silencio respuestas equivocadas desde una página obsoleta, exactamente el modo de fallo de página duplicada que describe este artículo. Ejecutar una implementación primero contra tickets pasados es la única forma que conozco de detectarlo antes de que lo haga un cliente.
• No es exclusivo de Cloud. El servidor Rovo MCP no tiene ninguna vía de Data Center y estructuralmente no puede tenerla. Si tu Confluence es autogestionado, eso es un obstáculo insalvable para el conector oficial y no para eesel.
• El precio es por tarea gestionada, a 0,40 $, ya sea un ticket o una sesión de chat, sin cuota por puesto y sin medidor de créditos que racionar. Hay 50 $ de uso gratuito para probarlo, sin necesidad de tarjeta.

Un director de desarrollo en una empresa europea de cumplimiento de RRHH, que gestiona exactamente esta configuración en Confluence y Slack, planteó el requisito con claridad:

"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."

Un director de innovación en una empresa de pagos, también en Confluence, informó de hasta un 80 % de ahorro de tiempo al encontrar respuestas e incorporar a nuevos empleados. Esas son las dos formas que suele adoptar esto habitualmente: con forma de cumplimiento normativo, o con forma de velocidad.

Si quieres la versión del lado de Claude de esta comparación para otras herramientas, he escrito Claude para Jira Service Management, una mirada más amplia a Atlassian AI, y el artículo sobre el asistente de hoja de ruta de Confluence. Y si estás sopesando el propio wiki en vez de la IA que va encima, Confluence frente a Notion y mi reseña de Confluence son los sitios por donde empezar.