Conecta Claude Code con Jira y Confluence con un solo comando claude mcp add. Verás el endpoint v2, las opciones de ámbito, el inicio de sesión con OAuth, las cabeceras del token de API, los primeros prompts, un .mcp.json para el equipo y una tabla de solución de problemas con los errores que de verdad te encontrarás.
Tu backlog de Jira nunca baja y nadie encuentra nada en Confluence. Claude puede leer y escribir en ambos, y responder preguntas sobre ellos sin que tengas que pegar un solo ticket en una ventana de chat. Toda la conexión es una línea de terminal: claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp. Ejecútala, inicia sesión una vez en tu navegador y Claude Code podrá buscar en Jira con JQL, crear work items y leer o editar páginas de Confluence, todo con tus propios permisos.
Este recorrido sigue claude mcp add atlassian en el orden en que lo vas a necesitar: qué expone el servidor, qué revisar primero, el comando exacto, los tres ámbitos, el inicio de sesión con OAuth, una primera tanda de prompts, la opción del token de API para automatización, el uso compartido en equipo y una tabla de solución de problemas. Todos los comandos y endpoints de abajo proceden de la documentación actual de Atlassian y Claude Code, revisada en octubre de 2026.
MCP (Model Context Protocol) es el estándar abierto que permite a un cliente de IA llamar a herramientas externas. Atlassian aloja su propio servidor remoto, el Atlassian Rovo MCP Server, así que no instalas nada en local. Claude Code se conecta a una URL, y Atlassian se encarga de la autenticación, los permisos y las llamadas a Jira y Confluence que hay detrás.
Un único endpoint da servicio a Jira, Jira Service Management, Confluence, Bitbucket, Projects, Goals y las grabaciones de Loom. Este artículo se centra en Jira y Confluence, la pareja que la mayoría de equipos conecta primero. El inicio de sesión usa OAuth 2.1, y cada acción respeta tus controles de acceso actuales. Claude ve exactamente lo que ve tu cuenta, ni más ni menos.
Nunca escribes nombres de herramientas. Escribes una petición en lenguaje natural y Claude elige la herramienta adecuada. Aun así, conocer el menú ayuda a formular mejores prompts:
| Producto | Lectura | Escritura | Búsqueda |
|---|---|---|---|
| Jira | getJiraIssue, listJiraProjects, listJiraBoards, listJiraIssueComments, listJiraIssueTransitions | createJiraIssue, editJiraIssue, transitionJiraIssue, addOrEditJiraIssueComment | searchJiraIssuesUsingJql |
| Confluence | getConfluenceContent, listConfluenceSpaces, listConfluenceContent, listConfluenceComments | createConfluenceContent, updateConfluenceContent, createConfluenceComment, addLabelsToConfluenceContent | searchConfluence (CQL) |
💡 Consejo: Las herramientas de solo lectura son seguras para empezar a probar. Las de escritura modifican tickets y páginas reales, así que déjalas para cuando la conexión funcione.
La lista de comprobación es corta, pero saltarse un punto es lo que más suele atascar una configuración:
claude --version en una terminal. Si muestra una versión, ya estás listo.
Con estas casillas marcadas, toda la configuración lleva unos minutos.
Abre cualquier terminal y ejecuta:
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp
Cada parte cumple una función:
claude mcp add registra un nuevo servidor MCP en Claude Code.--transport http selecciona el transporte HTTP en streaming que usan los servidores remotos.atlassian es el nombre local. Es lo que verás en /mcp y en claude mcp list.https://mcp.atlassian.com/v2/mcp es el endpoint v2 de Atlassian.💡 Consejo: En artículos antiguos aparece una dirección v1. La documentación actual de Atlassian apunta a v2, así que copia la URL de arriba en lugar de una respuesta antigua de un foro.
Por defecto, el comando guarda el servidor en ámbito local. Puedes elegir dónde vive con --scope:
| Ámbito | Opción | Se carga en | Compartido con el equipo | Se guarda en |
|---|---|---|---|---|
| Local (por defecto) | --scope local | Solo el proyecto actual | No | ~/.claude.json |
| Proyecto | --scope project | Solo el proyecto actual | Sí, mediante control de versiones | .mcp.json en la raíz del proyecto |
| Usuario | --scope user | Todos tus proyectos | No | ~/.claude.json |
Para uso personal en todos los repositorios, el ámbito de usuario es la opción práctica:
claude mcp add --transport http atlassian --scope user https://mcp.atlassian.com/v2/mcp
El ámbito de proyecto también funciona aquí, porque la URL no lleva ningún secreto. Cada compañero sigue iniciando sesión con su propia cuenta de Atlassian.
Añadir el servidor no inicia sesión por ti. Completa estos pasos:
/mcp.claude mcp list.¿Prefieres quedarte en la terminal? Ejecuta claude mcp login atlassian. En un equipo sin pantalla, claude mcp login atlassian --no-browser muestra una URL en lugar de abrir un navegador. Para ver los detalles de un solo servidor, usa claude mcp get atlassian. La columna de estado te indica en qué punto estás:
| Estado | Significado |
|---|---|
| ✔ Connected | El servidor está activo y listo |
| ! Needs authentication | El inicio de sesión con OAuth sigue pendiente |
| ✘ Failed to connect | Error de conexión, normalmente un problema de URL o de red |
Empieza con lecturas. Una buena primera prueba demuestra que el inicio de sesión funciona y le muestra a Claude cómo está organizada tu instancia.
Pregunta en lenguaje natural o pega JQL directamente:
"Lista las incidencias sin resolver del proyecto PAY actualizadas esta semana, ordenadas por prioridad, y resume las cinco primeras."
Claude llama a searchJiraIssuesUsingJql. Si quieres control total, escríbele la consulta tú mismo:
project = PAY AND status != Done AND assignee = currentUser() ORDER BY priority DESC
Cuando un nombre es ambiguo, pide a Claude que ejecute lookupJiraAccountId para un compañero antes de filtrar por responsable. Convierte un nombre visible o un correo en el ID de cuenta que necesita JQL.
Las escrituras funcionan igual, con un hábito que conviene adoptar: pide un borrador primero.
"Redacta un Bug para el proyecto PAY con el título 'El pago falla con tarjetas guardadas' usando el stack trace de arriba. Enséñame los campos. No crees nada hasta que te diga que sí."
Entre bastidores, Claude consulta los tipos de incidencia del proyecto y sus campos obligatorios, y luego llama a createJiraIssue cuando apruebas. Mover el trabajo de una fase a otra es igual de corto:
"Pasa PAY-142 a En revisión y añade un comentario que enlace el pull request."
Esa petición usa transitionJiraIssue y addOrEditJiraIssueComment. Por defecto, Claude Code pide aprobación antes de ejecutar herramientas MCP, así que lee cada solicitud de escritura antes de aceptarla.
💡 Consejo: Indica el proyecto, el tipo de incidencia y la prioridad en tu primer mensaje. Los prompts que incluyen esos datos necesitan menos llamadas a herramientas y menos preguntas de seguimiento, lo que además reduce el uso de créditos de Rovo.
Confluence funciona con búsquedas CQL y herramientas de página:
"Busca en Confluence nuestro runbook de respuesta a incidentes y resume los pasos de escalado."
"Crea una página en el espacio ENG llamada 'Checklist de lanzamiento' a partir de las notas de este archivo."
"Añade un comentario al pie de la página de onboarding preguntando si los pasos de VPN siguen siendo correctos."
Las actualizaciones de páginas existentes pueden reemplazar todo el cuerpo o aplicar ediciones puntuales. Para cualquier contenido del que dependa la gente, pide a Claude que haga ediciones concretas y que muestre el cambio antes de guardar.
OAuth se adapta al trabajo interactivo diario. La autenticación con token de API se adapta a pipelines, bots y otras ejecuciones no interactivas en las que nadie está presente para hacer clic en una pantalla de consentimiento. Es opcional, y un administrador de la organización debe habilitarla antes en los ajustes del servidor Rovo MCP.
Atlassian acepta dos formatos de cabecera:
Authorization: Basic <base64(email:api_token)>Authorization: Bearer <credential>Genera el valor en Base64 de un token personal en macOS o Linux:
printf '%s' 'you@company.com:YOUR_API_TOKEN' | base64
En Linux, añade -w 0 para que la salida larga quede en una sola línea. En PowerShell de Windows:
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("you@company.com:YOUR_API_TOKEN"))
Después registra el servidor con un nombre distinto, para que pueda convivir con tu entrada de OAuth:
claude mcp add --transport http atlassian-ci https://mcp.atlassian.com/v2/mcp \
--header "Authorization: Basic BASE64_VALUE"
⚠️ Advertencia: Trata el token como una contraseña. Guárdalo en ámbito local o de usuario, nunca en un
.mcp.jsonconfirmado en el repositorio, y revócalo y genera uno nuevo cuando alguien deje el equipo.
Atlassian indica que algunas herramientas MCP pueden no estar disponibles con autenticación por token, porque los tokens llevan ámbitos seleccionables que son más estrechos que una sesión completa de OAuth. Esta es la contrapartida en una tabla:
| OAuth 2.1 | Token de API | |
|---|---|---|
| Configuración | Inicio de sesión en el navegador a través de /mcp | Interruptor del administrador más una cabecera |
| Ideal para | Trabajo interactivo diario | Trabajos de CI, bots, automatización |
| Identidad | Tu usuario | Tu usuario o una cuenta de servicio |
| Disponibilidad de herramientas | Conjunto completo | Algunas herramientas pueden faltar |
Para que todo un repositorio use la misma conexión, añade el servidor en ámbito de proyecto o escribe el archivo a mano:
{
"mcpServers": {
"atlassian": {
"type": "http",
"url": "https://mcp.atlassian.com/v2/mcp"
}
}
}
Guárdalo como .mcp.json en la raíz del proyecto y confírmalo en el repositorio. En sesiones interactivas, Claude Code pide a cada compañero que apruebe los servidores del proyecto antes de usarlos. En modos no interactivos, como claude -p, los servidores del proyecto se cargan sin preguntar. Para restablecer esas aprobaciones, ejecuta claude mcp reset-project-choices.
El aviso oficial de Atlassian dice: "El 1 de marzo de 2027, cualquier uso existente de v1 empezará a exponer y utilizar herramientas v2 de forma automática." Los clientes que tengan credenciales antiguas en caché quizá deban borrar sus credenciales clientIds o .well-known en caché. Si registraste una dirección v1 hace meses, haz ahora un cambio limpio:
claude mcp logout atlassian
claude mcp remove atlassian
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp
Después ejecuta /mcp e inicia sesión de nuevo.
Dos hábitos mantienen la configuración sana con el tiempo:
La mayoría de los fallos encajan en unos pocos patrones. Empieza con claude mcp list y luego busca el síntoma:
| Síntoma | Causa probable | Solución |
|---|---|---|
! Needs authentication | El inicio de sesión no terminó o ha caducado | Ejecuta /mcp o claude mcp login atlassian |
✘ Failed to connect | URL incorrecta, transporte incorrecto o un bloqueo de red | Ejecuta claude mcp get atlassian y confirma que el tipo es http y que la URL termina en /v2/mcp |
| El navegador nunca se abre | Sesión remota o sin pantalla | Usa claude mcp login atlassian --no-browser |
| El inicio de sesión se repite tras cambiar de versión | Datos de cliente antiguos en caché | Ejecuta la secuencia de logout, remove y add de arriba |
| Falta una herramienta esperada | Ámbitos del token más estrechos que OAuth | Amplía los ámbitos del token o cambia a OAuth |
| Las búsquedas no devuelven nada en un proyecto al que sí puedes acceder | Nombre que no coincide | Pide a Claude que liste los proyectos de Jira que ve y usa el nombre exacto |
Cuando nada más funciona, quitar y volver a añadir el servidor lleva unos diez segundos y descarta una entrada local defectuosa. Después de cualquier cambio, vuelve a ejecutar claude mcp list antes de culpar a tu prompt. Una línea verde ✔ Connected indica que el problema está en la petición, no en la conexión.
Conectar Claude con Atlassian resuelve la parte técnica. Alrededor quedan dos tareas: escribir texto de tickets que valga la pena leer y dar algo de peso visual a las páginas de Confluence. PicassoIA ayuda con ambas, como herramienta aparte junto a tu configuración de Claude Code. El enlace MCP de arriba funciona en Claude Code, mientras que los pasos siguientes se hacen en PicassoIA.
Claude Sonnet 5 convierte notas en bruto en borradores de tickets limpios antes de que abras una terminal:
low omite el razonamiento profundo y responde más rápido. Pasa a high o max cuando el problema afecte a varios sistemas.¿Necesitas un razonamiento más potente para un informe de incidente enrevesado? Claude Opus 4.7 y Claude Fable 5 están disponibles en la misma plataforma.
Un runbook con una imagen de cabecera clara se abre más veces que un muro de texto. P-Image, Flux 2 Pro, Seedream 5 Pro y GPT Image 2 convierten una frase en una foto que puedes usar como banner de página. Prueba un prompt como "una pizarra de equipo bañada por el sol con notas adhesivas, profundidad de campo poco profunda y grano de película natural".
La lista de herramientas de Atlassian incluye la subida de adjuntos a incidencias de Jira, pero solo descargas en Confluence, así que coloca la imagen terminada en la página con el editor de Confluence.
PicassoIA también ofrece su propia conexión MCP para generación de imágenes y video, gestionada desde tu cuenta. La idea es la misma que la que acabas de configurar: conecta una vez y luego pide en lenguaje natural.
Ejecuta el comando, inicia sesión y pide a Claude tu primera búsqueda JQL. Luego abre PicassoIA, elige un modelo y crea los borradores de tickets y las imágenes que tu equipo lleva posponiendo. Tu próxima revisión de sprint te lo agradecerá.
Elige tu idioma
