Cómo conectar Claude con Jira y Confluence

Antes de tocar nada, confirma dos cosas que causan la mayoría de bloqueos. Primera: la integración funciona con Atlassian Cloud, es decir, si entras a Jira por una URL del tipo tuempresa.atlassian.net. Si tu empresa tiene Jira Server o Data Center autoalojado (habitual en bancos y administraciones en España y LATAM), el conector oficial no te servirá y necesitarás un servidor MCP propio. Segunda: los conectores están disponibles en los planes de pago de Claude. En Team y Enterprise, el owner de la organización debe tener los conectores permitidos; si no ves la opción, pregúntale a quien administra Claude en tu empresa. También conviene avisar al administrador de Atlassian: la primera vez que alguien de la organización conecta una app externa por OAuth, Atlassian puede pedir que un admin apruebe la integración. Si trabajas en la UE, revisa con IT o con el DPO si el uso encaja con vuestra política de RGPD, ya que Claude leerá contenido de tickets y páginas cuando se lo pidas.

Entra en claude.ai (o en la app de escritorio, que comparte la misma configuración) y abre la configuración de tu cuenta. Busca la sección de conectores: ahí verás un directorio de integraciones disponibles. Busca Atlassian; es un único conector que da acceso a Jira y a Confluence a la vez, porque por debajo es el servidor MCP remoto oficial de Atlassian. Pulsa para conectarlo. No tienes que instalar nada en tu máquina ni gestionar tokens de API: todo va por un servidor remoto alojado por Atlassian. Si tu organización ya lo tiene preconfigurado, puede que solo tengas que activarlo para tu usuario. Una vez añadido, el conector aparecerá en el menú de herramientas del cuadro de chat, desde donde podrás activarlo o desactivarlo por conversación. Esto es útil: si estás en una conversación que no tiene nada que ver con Jira, desactívalo para que Claude no intente buscar ahí y gaste contexto en resultados irrelevantes.

Al conectar, se abrirá una ventana de Atlassian pidiéndote que inicies sesión y que autorices el acceso. Lee la pantalla: muestra qué permisos solicita (leer y escribir en Jira, leer y escribir en Confluence) y te deja elegir el sitio si tu cuenta pertenece a varios. Selecciona el sitio de trabajo correcto y acepta. Un punto clave para entender la seguridad: Claude actúa con tus permisos de Atlassian, nunca con más. Si no puedes ver un proyecto de Jira o un espacio de Confluence desde el navegador, Claude tampoco podrá. Eso hace que el conector sea razonablemente seguro de desplegar en equipos, pero también significa que si tu usuario es admin, Claude tendrá alcance de admin cuando ejecute acciones. Tras autorizar, vuelve a Claude y comprueba que el conector aparece como conectado. Si la ventana de OAuth se cierra sin más o muestra un error de aprobación, casi siempre es que el administrador de Atlassian debe aprobar la app primero.

Abre una conversación nueva con el conector activado y empieza por lecturas, que no tienen riesgo. Ejemplos que funcionan bien: 'Lista mis issues abiertos en el proyecto PAY ordenados por prioridad y dime cuáles llevan más de dos semanas sin moverse'. 'Busca en Confluence la página de onboarding del equipo backend y resume los pasos de configuración del entorno'. 'Escribe la consulta JQL para ver los bugs críticos creados este sprint y ejecútala'. Claude decide qué herramienta del servidor usar (búsqueda en Jira, lectura de issue, búsqueda en Confluence, etc.) y te muestra en la conversación cada llamada que hace, así que puedes ver exactamente qué consultó. Sé específico con claves de proyecto y nombres de espacio: 'proyecto PAY' funciona mucho mejor que 'el proyecto de pagos'. Para cruzar fuentes, pide cosas como 'compara los criterios de aceptación de PAY-142 con la especificación en Confluence y señala discrepancias'; ahí es donde la integración aporta más valor que la búsqueda nativa.

El conector no solo lee: puede crear issues, añadir comentarios, cambiar estados y crear o editar páginas de Confluence. Por defecto, Claude te pedirá confirmación antes de ejecutar herramientas, y en ese diálogo puedes permitir una vez o permitir siempre esa herramienta. Mi recomendación: permite siempre las herramientas de lectura y deja las de escritura en modo de aprobación manual. Prueba un flujo real: 'A partir de estas notas de la reunión, crea en el proyecto PAY una historia por cada tarea, con criterios de aceptación y etiqueta sprint-23. Antes de crearlas, enséñame el borrador'. Revisa el borrador, ajusta y solo entonces aprueba la creación. Para Confluence funciona igual: 'Redacta una página de retrospectiva en el espacio ENG con este contenido, pero espera mi OK'. Si trabajas siempre con el mismo equipo, crea un Proyecto en Claude con instrucciones fijas (claves de proyecto, plantilla de historias, idioma de los tickets) para no repetirlas en cada chat.

Si trabajas desde la terminal, puedes usar el mismo servidor MCP en Claude Code para, por ejemplo, leer un ticket y empezar a implementarlo sin salir del repo. Instala Claude Code con el instalador nativo si aún no lo tienes, añade el servidor MCP de Atlassian con transporte HTTP y autentícate desde dentro de la sesión con el comando /mcp, que abrirá el navegador para el OAuth. La opción --scope user lo deja disponible en todos tus proyectos; si prefieres compartirlo con el equipo vía repo, usa --scope project, que lo guarda en un archivo .mcp.json versionable (sin credenciales, porque la autenticación es OAuth por usuario). Después prueba algo como: 'Lee PAY-142, revisa el código relacionado en este repo y propón un plan de implementación'. Comprueba la URL del endpoint en la documentación oficial de Atlassian, porque han ido migrando del transporte SSE antiguo al HTTP.

# 1. Instalar Claude Code (macOS / Linux / WSL) con el instalador nativo
curl -fsSL https://claude.ai/install.sh | bash

# 2. Añadir el servidor MCP remoto de Atlassian (verifica la URL en la doc de Atlassian)
claude mcp add --transport http --scope user atlassian https://mcp.atlassian.com/v1/mcp

# 3. Comprobar que está registrado
claude mcp list

# 4. Abrir Claude Code y autenticar con OAuth
claude
# Dentro de la sesión, escribe: /mcp  -> selecciona atlassian -> autenticar