Atlassian MCP Server

oficial

Servidor oficial de Atlassian MCP para conectar agentes de IA a Jira, Confluence, Opsgenie y otros productos de Atlassian.

GitHub

1.1k

¿Qué puedes hacer con Atlassian MCP?

Buscar en los productos de Atlassian — Pídele a tu asistente que encuentre incidencias de Jira, páginas de Confluence, repositorios de Bitbucket o Proyectos sin cambiar de herramienta.
Crear y actualizar elementos de trabajo — Indícale a tu asistente que cree historias de Jira, actualice incidencias o genere páginas de Confluence a partir de lenguaje natural.
Resumir y recuperar contenido — Haz que tu asistente resuma páginas de Confluence, grabaciones de Loom o solicitudes de Jira Service Management.
Automatizar flujos de trabajo repetitivos — Pídele a tu asistente que cree incidencias de Jira en masa a partir de notas de reuniones o que vincule elementos de trabajo con documentación relacionada.
Consultar el estado de proyectos y objetivos — Obtén actualizaciones en tiempo real sobre Proyectos, Objetivos o dependencias de componentes de Compass directamente en tu cliente de IA.

Servidor MCP alojado

npx add-mcp 'https://mcp.atlassian.com/v1/mcp/authv2'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Atlassian

Atlassian MCP Server

El servidor oficial de Model Context Protocol (MCP) para Atlassian: un puente alojado en la nube que brinda a tus herramientas de IA acceso seguro y en tiempo real a Jira, Confluence, Jira Service Management, Bitbucket, Compass, Loom y la plataforma Atlassian en general, impulsado por tu Teamwork Graph.

Primeros pasos · Herramientas compatibles · Seguridad y administración · Comunidad

El servidor oficial de Atlassian MCP es un puente basado en la nube entre tu sitio de Atlassian Cloud y herramientas externas compatibles. Una vez configurado, permite que esas herramientas interactúen con Jira, Confluence, Jira Service Management, Bitbucket, Compass, Loom y los datos de la plataforma Atlassian (Projects, Goals, Teams, Focus, Talent y Teamwork Graph) en tiempo real. La autenticación utiliza OAuth 2.1 o tokens de API, por lo que cada acción respeta los controles de acceso existentes del usuario.

Con el servidor de Atlassian MCP, puedes:

Resumir y buscar en Jira, Jira Service Management, Confluence, Bitbucket, Projects, Goals y más sin cambiar de herramienta.
Recuperar y revisar grabaciones de videos y reuniones de Loom.
Crear y actualizar elementos de trabajo o páginas mediante comandos en lenguaje natural.
Automatizar trabajo repetitivo, como generar elementos de trabajo a partir de notas de reuniones o especificaciones.

Conéctate una vez y luego describe lo que quieras: sin cambiar de pestaña y sin copiar y pegar. Tu IA selecciona y ejecuta las acciones correctas.

Está diseñado para desarrolladores, creadores de contenido y equipos de proyecto que trabajan en IDEs o herramientas de IA y quieren usar datos de Atlassian sin cambiar constantemente de contexto.

[!IMPORTANT] v2 es ahora la versión recomendada. Las configuraciones nuevas deben usar https://mcp.atlassian.com/v2/mcp, que expone más herramientas y más productos. Las conexiones v1 existentes comienzan automáticamente a exponer y usar herramientas v2; los clientes incompatibles pueden necesitar borrar los ID de cliente en caché o las credenciales de .well-known para seguir autenticándose. Para conocer los pasos de configuración, consulta Primeros pasos con el servidor de Atlassian MCP.

Configuración en un clic

Elige tu cliente de IA a continuación para instalar el servidor oficial de Atlassian MCP. Cada botón usa el enlace de instalación nativo de tu cliente, por lo que no necesitas editar ningún archivo de configuración JSON manualmente.

Añadir a Cursor
_{Consulta incidencias y registra trabajo en tu código.}

Añadir a VS Code
_{Busca y crea incidencias de Jira mediante GitHub Copilot.}

Añadir a ChatGPT
_{Busca, resume y crea directamente desde ChatGPT.}

Añadir a Claude
_{Integra Jira y Confluence en los flujos de trabajo de Claude.}

Deja que tu agente haga la configuración

La mayoría de los agentes de codificación con IA pueden instalar, autenticar y configurar el servidor por sí mismos. Copia y pega este mensaje en tu agente:

Set up Atlassian MCP for this agent using the official setup guide at
https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/
and the MCP server URL https://mcp.atlassian.com/v2/mcp. Then start the Atlassian MCP
authentication flow so I can sign in.

O añade el servidor manualmente con el comando propio de tu cliente:

Cliente	Comando o configuración
Claude Code	`claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp`, luego ejecuta `/mcp` en una sesión para autenticarte
Codex	`codex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp`
Claude Desktop	Configuración → Extensiones → Explorar extensiones → Plugins, luego busca Atlassian
Codex Desktop	Plugins o Connectors, luego instala Atlassian Rovo
VS Code / GitHub Copilot	Vista de extensiones → busca `@mcp Atlassian` → Instalar
Cursor	Plugin de Atlassian para Cursor con MCP → Añadir a Cursor
Windsurf	Cascade → MCP servers → Add Server → Add custom server, con `serverUrl` establecido en `https://mcp.atlassian.com/v2/mcp`
Cualquier otro cliente MCP	Usa la URL del servidor `https://mcp.atlassian.com/v2/mcp`

Contenido

Configuración en un clic
Clientes compatibles
Empaquetado de plugins y compatibilidad
Productos y herramientas compatibles
Cómo expone el servidor las herramientas
Puertas de enlace MCP
Antes de comenzar
Datos y seguridad
Cómo funciona
Ejemplos de flujos de trabajo
Consejos y trucos
Notas de administración: gestión de acceso
Seguridad
Soporte y comentarios
Aviso legal

Clientes compatibles

El servidor de Atlassian MCP funciona con una lista creciente de clientes compatibles con MCP:

Cliente	Referencia de configuración
OpenAI ChatGPT	Guía de Connectors / MCP
OpenAI Codex (CLI y Desktop)	Documentación de MCP para Codex
Claude (Claude.ai, Desktop y Code)	Documentación de MCP para Claude
Cursor	Atlassian en el marketplace de Cursor
Visual Studio Code (GitHub Copilot)	Documentación de MCP para VS Code
GitHub Copilot CLI	Acerca de Copilot CLI
Google Gemini CLI	Documentación de MCP para Gemini CLI
Windsurf	Documentación de MCP para Windsurf
Docker	Catálogo y toolkit de MCP para Docker
Kiro y otros clientes de Agent Plugins	Documentación de Kiro Powers
Amazon Quick Suite	Guía de integración de MCP

El servidor de Atlassian MCP también admite cualquier cliente local compatible con MCP que pueda ejecutarse en localhost y conectarse al servidor mediante el proxy mcp-remote. Esto permite integraciones personalizadas o de terceros que sigan la especificación de MCP.

[!TIP] Para obtener la lista actual y canónica de clientes compatibles y la configuración paso a paso, consulta Primeros pasos con el servidor de Atlassian MCP. También puedes consultar la documentación de MCP de tu propio cliente o su asistente integrado.

Empaquetado de plugins y compatibilidad

Este repositorio publica el mismo servidor MCP y las mismas habilidades en varios formatos de paquete para que los clientes puedan usar sus flujos nativos de descubrimiento e instalación:

Formato	Manifiesto y configuración	Componentes compartidos
Agent Plugins v1	`plugin.json` y `mcp.json`	`skills/`
Plugin de Claude Code	`.claude-plugin/plugin.json` y `.claude-plugin/marketplace.json`	`.mcp.json` y `skills/`
Plugin de Cursor	`.cursor-plugin/plugin.json`	`.mcp.json` y `skills/`
Extensión de Gemini	`gemini-extension.json`	Configuración del servidor MCP integrada en el manifiesto
Registro MCP	`server.json`	Metadatos del servidor remoto

Las habilidades en skills/ apuntan al endpoint /v2/mcp y son las que instala cada plugin empaquetado. La generación anterior está archivada en skills/v1/ para quienes aún usan un endpoint v1; no la instala ningún plugin y se configura manualmente. Consulta skills/README.md para conocer las diferencias.

Tanto mcp.json como .mcp.json son intencionales. Agent Plugins requiere el nombre de archivo raíz mcp.json y su vocabulario de transporte portátil; los clientes existentes continúan usando .mcp.json y su vocabulario de configuración nativo. Mantén alineadas sus configuraciones de endpoint al cambiar cualquiera de los archivos.

El paquete raíz puede importarse mediante clientes que implementen Agent Plugins, incluido Kiro Powers. Los manifiestos específicos de cada cliente siguen disponibles y no se reemplazan por el paquete portátil.

Productos y herramientas compatibles

Las herramientas se organizan por producto e intención (lectura, escritura, búsqueda, eliminación o gestión). Los administradores de la organización otorgan o revocan el acceso a nivel de grupo de permisos, y cada herramienta hereda el acceso de su grupo principal.

Producto	Grupos de permisos	OAuth 2.1	Token de API
Jira	`read_jira` · `write_jira` · `search_jira`	✅	✅
Jira (habilitado por administrador)	`delete_jira` · `manage_jira`	✅	✅
Confluence	`read_confluence` · `write_confluence` · `search_confluence`	✅	✅
Bitbucket Cloud	`read_bitbucket` · `write_bitbucket`	✅	✅
Jira Service Management	`read_jsm` · `write_jsm`	—	✅ (solo)
Plataforma Atlassian	`read_teamwork_graph` · `write_teamwork_graph` · `search_atlassian`	✅	✅
Loom	`read_loom` · `write_loom`	✅	✅
Goals	`read_goals` · `write_goals`	✅	✅
Projects	`read_projects` · `write_projects`	✅	✅
Teams	`read_teams` · `write_teams`	✅	✅
Focus	`read_focus` · `write_focus`	✅	✅
Talent	`read_talent` · `write_talent`	✅	✅
Compass	`read_compass` · `write_compass`	✅ (solo)	—

Condiciones específicas por producto:

delete_jira y manage_jira están deshabilitados de forma predeterminada y deben ser habilitados por un administrador antes de poder usarse.
Las herramientas de Bitbucket Cloud solo están disponibles si tu espacio de trabajo de Bitbucket está vinculado a una organización. Los espacios de trabajo que no están vinculados a una organización no se pueden seleccionar al autenticarse.
Las herramientas de Jira Service Management solo admiten autenticación mediante token de API y solo están disponibles si un administrador de la organización ha habilitado la autenticación con token de API.
Las herramientas de Loom solo están disponibles para espacios de trabajo de Loom vinculados a un sitio de Atlassian.
Las herramientas de Teamwork Graph pueden recuperar datos de servicios de terceros conectados a Jira, como solicitudes de extracción vinculadas, compilaciones e implementaciones. Para GitHub for Atlassian, acceso completo significa que las herramientas recuperan datos de GitHub según los permisos de GitHub del usuario, mientras que acceso limitado significa que recuperan datos según los permisos de Jira del usuario. Los conectores de Azure DevOps, GitLab, Jenkins y Spinnaker siguen el modelo de acceso limitado.

[!NOTE] Para obtener la referencia completa y actual de herramientas, incluido el alcance requerido para cada grupo de permisos, consulta Herramientas compatibles.

Cómo expone el servidor las herramientas

En lugar de enviar cada definición de herramienta al cliente de IA en el momento de la conexión, el Atlassian MCP Server expone un pequeño conjunto de las herramientas más utilizadas y permite que el cliente descubra el resto bajo demanda. Las herramientas marcadas como Principales son visibles directamente para los agentes.

Esto tiene dos beneficios:

El contexto de tu cliente permanece libre para la tarea en cuestión en lugar de llenarse con definiciones de herramientas.
Las nuevas herramientas están disponibles sin que el cliente necesite reconectarse.

Puertas de enlace MCP

Si estás utilizando una puerta de enlace MCP, o necesitas que todas las herramientas estén disponibles de antemano en lugar de usar los métodos de descubrimiento y ejecución, usa la anulación tools=all para exponer todas las herramientas como una lista plana paginada:

https://mcp.atlassian.com/v2/mcp?tools=all

Antes de comenzar

Verifica que tu entorno cumpla con estos requisitos antes de configurar el servidor.

Requisitos previos

Los requisitos dependen de cómo te conectes:

Para clientes compatibles

Un sitio de Atlassian Cloud con uno o más de Jira, Confluence, Jira Service Management, Bitbucket o Compass
Acceso a el cliente de tu elección
Un navegador moderno para completar el flujo de autorización OAuth 2.1, o credenciales de token de API para autenticación sin interfaz gráfica

Si tu administrador de organización ha deshabilitado la autenticación mediante token de API, los clientes MCP no pueden conectarse con un token y deben usar OAuth 2.1 en su lugar.

Para IDE o clientes locales (configuración de escritorio)

Un sitio de Atlassian Cloud con uno o más productos compatibles
Un IDE compatible (por ejemplo, Claude Desktop, VS Code o Cursor) o un cliente personalizado compatible con MCP
Node.js v18+ instalado para ejecutar el proxy MCP local (mcp-remote)
Un navegador moderno para completar el inicio de sesión OAuth, o credenciales de token de API para autenticación sin interfaz gráfica

Datos y seguridad

El servidor aplica varios controles de seguridad:

Todo el tráfico está cifrado en tránsito mediante HTTPS (TLS 1.2 o posterior), según las prácticas de seguridad de Atlassian.
La autenticación OAuth 2.1 y token de API proporcionan un control de acceso seguro.
El acceso a los datos respeta los permisos de usuario en cada producto de Atlassian conectado, incluidos Jira, Confluence, Jira Service Management, Bitbucket, Compass y Loom.
Si tu organización utiliza listas de permitidos de IP para productos de Atlassian Cloud, las llamadas a herramientas realizadas a través del Atlassian MCP Server también respetan esas reglas de IP.

Para obtener una descripción más detallada del modelo de seguridad y los controles de administrador, consulta:

Cómo funciona

Arquitectura y comunicación

Un cliente compatible se conecta al endpoint del servidor. El endpoint recomendado para todos los clientes es:
```
https://mcp.atlassian.com/v2/mcp
```
Los endpoints v1 (https://mcp.atlassian.com/v1/mcp/authv2 y https://mcp.atlassian.com/v1/mcp) siguen siendo compatibles, y las conexiones v1 existentes comienzan automáticamente a exponer y usar herramientas v2.
Dependiendo de tu configuración, se activa un flujo OAuth 2.1 seguro basado en navegador o se utiliza la autenticación con token de API.
Una vez autorizado, el cliente transmite datos contextuales y recibe respuestas en tiempo real de tus productos de Atlassian conectados.

[!WARNING] Después del 30 de junio de 2026, el endpoint heredado de Server-Sent Events (https://mcp.atlassian.com/v1/sse) dejará de ser compatible. Actualiza cualquier cliente personalizado configurado para usar /sse para que apunte a /mcp — preferiblemente https://mcp.atlassian.com/v2/mcp.

[!NOTE] Los clientes que no puedan completar la autenticación después de la migración a herramientas v2 pueden necesitar borrar los ID de cliente almacenados en caché o las credenciales .well-known.

Gestión de permisos

El acceso se otorga solo a los datos que el usuario ya tiene permiso para ver en Atlassian Cloud. Todas las acciones respetan los roles existentes a nivel de proyecto o espacio. La autenticación OAuth y con token de API respetan los alcances configurados y los permisos de Atlassian.

Autenticación con token de API (sin interfaz gráfica)

La autenticación con token de API está disponible para configuraciones de cliente sin interfaz gráfica, de tipo servicio o no interactivas (por ejemplo, sistemas backend o automatizaciones). También es obligatoria para las herramientas de Jira Service Management.

Se admiten dos mecanismos:

Mecanismo	Encabezado
Token de API personal (autenticación básica)	`Authorization: Basic <base64(email:api_token)>`
Clave de API de cuenta de servicio (token Bearer)	`Authorization: Bearer <api_key>`

Habilitación requerida por el administrador: Un administrador de la organización debe habilitar la autenticación con token de API para el Atlassian MCP Server (Administración de Atlassian → Rovo → Rovo MCP server → Autenticación).
Token con alcance requerido: Crea un token de API personal o solicita a tu administrador una clave de API de cuenta de servicio, con los alcances necesarios para las herramientas y los datos a los que necesitas acceder.
Guía de configuración: Configurar la autenticación mediante token de API
Referencia de configuración de administrador: Controlar la configuración del Atlassian MCP Server: Configurar la autenticación

Flujos de trabajo de ejemplo

Una vez conectado, puedes ejecutar tareas como estas desde tu cliente.

Flujos de trabajo de Jira

Buscar: "Encuentra todos los errores abiertos en el Proyecto Alpha."
Crear/actualizar: "Crea una historia titulada 'Rediseño de incorporación'."
Creación masiva: "Crea cinco incidencias de Jira a partir de estas notas."

Flujos de trabajo de Confluence

Resumir: "Resume la página de planificación del segundo trimestre."
Crear: "Crea una página titulada 'Objetivos del equipo T3'."
Navegar: "¿A qué espacios tengo acceso?"

Flujos de trabajo de Compass

Crear: "Crea un componente de servicio basado en el repositorio actual."
Creación masiva: "Importa componentes y campos personalizados desde este CSV/JSON."
Consultar: "¿Qué depende del servicio api-gateway?"

Flujos de trabajo de Loom

Recuperar: "Encuentra la grabación de Loom de la revisión de diseño de la semana pasada."
Resumir: "Resume este recorrido de Loom y enumera los elementos de acción."

Flujos de trabajo de Proyectos y Objetivos

Estado: "¿Cuál es el estado actual del proyecto Checkout Revamp?"
Resumen: "¿Qué objetivos están en riesgo este trimestre y por qué?"

Tareas combinadas

Vincular contenido: "Vincula estas tres incidencias de Jira a la página 'Plan de lanzamiento'."
Buscar documentación: "Obtén la página de documentación de Confluence vinculada a este componente de Compass."
Avanzar el trabajo: "Mueve PROJ-456 a 'En revisión' y agrega un comentario de que la solicitud de extracción está lista."

[!NOTE] Las capacidades reales varían según tu nivel de permisos y la plataforma del cliente.

Consejos y trucos

Establecer CloudId, proyecto de Jira y espacio de Confluence predeterminados

Actualiza tu AGENTS.md con el Markdown a continuación para reducir las llamadas de herramientas de descubrimiento, ahorrar tiempo y tokens, y establecer el número máximo de resultados de búsqueda.

## Atlassian MCP

When connected to atlassian-rovo-mcp:
- **MUST** use Jira project key = YOURPROJ
- **MUST** use Confluence spaceId = "123456"
- **MUST** use cloudId = "https://yoursite.atlassian.net" (do NOT call getAccessibleAtlassianResources)
- **MUST** use `maxResults: 10` or `limit: 10` for ALL Jira JQL and Confluence CQL search operations.

Usar habilidades

Si estás usando un cliente de escritorio como Claude, puedes crear o reutilizar habilidades para tareas repetidas. Consulta las habilidades MCP predeterminadas de Atlassian.

Para Cursor, las habilidades forman parte del complemento del marketplace.

Notas de administración: gestión del acceso

Si eres administrador y estás preparando tu organización para usar el Atlassian MCP Server, revisa los puntos a continuación. Para obtener una guía de administración más detallada, consulta:

Gestionar, supervisar y revocar el acceso

Controles de administrador: Los administradores de sitio y organización pueden gestionar, revisar o revocar el acceso de la aplicación MCP desde Gestionar las aplicaciones de Marketplace y de terceros de tu organización.
Controles de dominio: Usa la página de configuración Rovo MCP server en Administración de Atlassian para controlar qué herramientas y dominios de IA externos pueden conectarse. De forma predeterminada, se permiten los dominios compatibles con Atlassian; puedes agregar dominios de confianza o bloquear los compatibles. Los controles de dominio se aplican a las conexiones OAuth 2.1. Para obtener más detalles, consulta Dominios disponibles del servidor MCP de Atlassian.
Controles de IP: Si tu organización utiliza listas de permitidos de IP para aplicaciones de Atlassian Cloud, las solicitudes realizadas a través del Atlassian MCP Server deben originarse desde una dirección IP permitida por la lista de permitidos de IP de tu organización para la aplicación correspondiente. Para obtener detalles de configuración, consulta Especificar direcciones IP para el acceso a productos. Las restricciones de IP de Bitbucket Cloud se configuran por separado por los administradores del espacio de trabajo en Configuración del espacio de trabajo → Controles de acceso. Consulta Controlar el acceso al contenido privado en un espacio de trabajo.
Controles de usuario final: Los usuarios individuales pueden revocar sus propias autorizaciones de aplicación desde su configuración de perfil.
Registro de auditoría: Cada vez que se utiliza una herramienta a través del Atlassian MCP Server, se registra un evento en el registro de auditoría de tu organización. Los administradores pueden revisarlos en Administración de Atlassian en Información → Registro de auditoría (filtra por Acciones de usuario de Rovo MCP o busca MCP). Para obtener más información, consulta Supervisar la actividad del servidor MCP de Atlassian.

Solución de problemas comunes

"No tienes permiso para conectarte desde esta dirección IP. Pide acceso a tu administrador." Esto generalmente indica que la lista de permitidos de IP está habilitada y la dirección IP de origen de la solicitud no está permitida para acceder a la aplicación correspondiente a través del Atlassian MCP Server. Pide al administrador de tu sitio, organización o espacio de trabajo de Bitbucket que revise la lista de permitidos de IP aplicable.

Los clientes de IA alojados pueden enviar solicitudes desde las direcciones IP de salida del proveedor de IA en lugar de la red corporativa o VPN del usuario. Por lo tanto, estar en una VPN permitida puede ser insuficiente. Pide a tu administrador que revise los rangos de IP de salida publicados por el proveedor y apruebe el acceso requerido. Para conectores alojados en OpenAI, consulta Guía de egreso de IP de OpenAI. Las conexiones MCP locales pueden usar la dirección IP de salida de la red local. Consulta cómo funciona la lista de permitidos de IP con Atlassian MCP.
El inicio de sesión OAuth se realiza correctamente, pero las llamadas a herramientas devuelven 403. Un inicio de sesión exitoso no garantiza que las llamadas a herramientas superen las restricciones de IP. Un 403 también puede indicar alcances insuficientes, permisos de aplicación u otra política de acceso. Confirma el motivo de la denegación antes de cambiar una lista de permitidos de IP.

Seguridad

El Protocolo de Contexto de Modelo (MCP) permite que los agentes de IA se conecten a herramientas y datos de Atlassian usando los permisos de tu cuenta, lo que crea flujos de trabajo potentes pero también riesgos estructurales. Cualquier cliente o servidor MCP que habilites (por ejemplo, complementos de IDE, aplicaciones de escritorio, servidores MCP alojados o integraciones de "un clic") puede hacer que un agente de IA realice acciones en tu nombre.

Los modelos de lenguaje grandes (LLM) son vulnerables a la inyección de prompts y ataques relacionados (como la inyección indirecta de prompts y el envenenamiento de herramientas). Estos ataques pueden instruir al agente para que exfiltre datos o realice cambios no intencionados sin solicitudes explícitas. Para reducir el riesgo, utilice únicamente clientes y servidores MCP de confianza, revise cuidadosamente qué herramientas y datos puede acceder cada agente y aplique el principio de privilegio mínimo (tokens con alcance limitado, acceso mínimo a proyectos/espacios de trabajo). Para cualquier acción de alto impacto o destructiva, requiera confirmación humana y supervise los registros de auditoría para detectar actividad inusual. Recomendamos encarecidamente revisar la guía de Atlassian sobre los riesgos de MCP en MCP Clients: Understanding the potential security risks.

Soporte y comentarios

Utilizamos sus comentarios para mejorar el Atlassian MCP Server. Si encuentra un error o una limitación, o tiene una sugerencia:

Visite el Atlassian Support Portal para informar problemas y solicitar funciones.
Comparta sus experiencias y preguntas en la Atlassian Community, y las consultas relacionadas con desarrolladores en la Atlassian Developer Community.
Vaya a nuestro Ecosystem Developer Portal si está creando una aplicación y encontró un error o problema, o tiene sugerencias.

Aviso legal

Los clientes MCP pueden realizar acciones en los productos de Atlassian con sus permisos existentes. Utilice el privilegio mínimo, revise los cambios de alto impacto antes de confirmarlos y supervise los registros de auditoría para detectar actividad inusual.

Más información: MCP Clients: Understanding the potential security risks.