MCP Atlassian — Instalar & Demo en vivo

Name: MCP Atlassian MCP Server
Author: sooperset

Por qué usarlo

Características clave

Jira: búsqueda JQL, get/create/update issue, transición, añadir comentario, listar flujo de trabajo
Confluence: búsqueda de páginas, obtener contenido, crear/actualizar página, comentarios, adjuntos
Compatible con Cloud + Server/Data Center
Modo de solo lectura para despliegues con mínimos privilegios
Filtros de sitio — restringe a un solo proyecto/espacio si tienes muchos
Transporte Stdio + HTTP/SSE

Demo en vivo

Cómo se ve en la práctica

mcp-atlassian-sooperset.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-atlassian-sooperset",
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-atlassian-sooperset": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-atlassian"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add mcp-atlassian-sooperset -- uvx mcp-atlassian

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: MCP Atlassian

Triar un error de producción en un ticket Jira con runbook de Confluence vinculado

👤 Ingenieros de guardia ⏱ ~10 min intermediate

Cuándo usarlo: Se disparó una alerta de Sentry — quieres un ticket Jira triado y un enlace a runbook rápidamente.

Requisitos previos

Tokens API — Atlassian → My Account → Security → API tokens

Flujo

Buscar relacionados

Atlassian: busca en Jira issues que contengan 'NullPointerException OrderService' en los últimos 30 días. También busca en Confluence páginas de runbook que mencionen OrderService.✓ Copiado

→ Ambos conjuntos de resultados devueltos
Decidir: duplicado o nuevo

Si hay un issue BUG abierto en los últimos 14 días, añade un comentario con el nuevo stack trace. De lo contrario, crea un nuevo BUG, vincula la página del runbook, establece prioridad Alta.✓ Copiado

→ Se llama jira_add_comment o jira_create_issue exactamente una vez
Entregar

Dime la clave del ticket y un resumen breve para que pueda publicarlo en Slack.✓ Copiado

→ ABC-1234 + resumen en 1 línea

Resultado: Ticket triado con enlace a runbook en menos de 2 minutos; sin duplicados.

Errores comunes

El stack trace pegado en Jira como texto plano pierde el formato — Envuelve en marcadores {code}; el MCP lo reenvía tal cual
Inyección JQL via entrada del usuario — Siempre entrecomilla los parámetros string; la herramienta los escapa pero sé explícito

Combinar con: sentry · github

Generar un informe de estado semanal desde Jira

👤 Tech leads / Engineering Managers ⏱ ~10 min beginner

Cuándo usarlo: Lunes por la mañana: necesitas resumir qué se entregó y qué está bloqueado.

Flujo

Obtener lo completado la semana pasada

Atlassian: JQL project = PLAT AND status changed to Done during (-7d, now()) ORDER BY updated DESC✓ Copiado

→ Lista de issues con responsable, clave y resumen
Obtener bloqueados

Ahora JQL project = PLAT AND status = Blocked — para cada uno, resume el último comentario.✓ Copiado

→ Lista de bloqueados con resumen del último comentario por issue
Componer

Formatea como un informe semanal de 200 palabras agrupado por Entregado / Bloqueado / En Riesgo.✓ Copiado

→ Informe conciso listo para pegar

Resultado: Informe de estado montado en 90 segundos con claves de issue citadas.

Errores comunes

Hilos de comentarios largos inflan el contexto — Usa jira_get_issue con fields=summary,status,assignee únicamente

Redactar un RFC de Confluence a partir de una discusión

👤 Ingenieros que escriben documentos de diseño ⏱ ~20 min intermediate

Cuándo usarlo: Has debatido un enfoque en el chat; quieres una página de Confluence con el resultado.

Flujo

Encontrar el espacio padre

Atlassian: encuentra el espacio 'Engineering RFC'. Lista sus páginas de nivel superior.✓ Copiado

→ Espacio + página padre identificados
Componer

Crea una nueva página bajo él titulada 'RFC: cambio de Redis a Valkey'. Secciones: contexto, objetivos/no-objetivos, opciones consideradas, decisión, plan. Usa la discusión anterior como material en bruto.✓ Copiado

→ confluence_create_page devuelve una URL

Resultado: RFC redactado listo para revisión.

Errores comunes

ID de página padre incorrecto — Siempre busca por espacio con confluence_search primero

Limpiar tickets obsoletos en masa

👤 Managers de ingeniería ⏱ ~30 min intermediate

Cuándo usarlo: El backlog tiene 200 zombis; quieres ordenarlos.

Flujo

Identificar obsoletos

JQL: project = PLAT AND status = Open AND updated < -90d. Límite 50.✓ Copiado

→ Lista de issues obsoletos
Proponer acción

Para cada uno, propón: cerrar-como-obsoleto, reasignar-a-triage o mantener. Muéstrame 10 a la vez antes de transicionar.✓ Copiado

→ Recomendación por issue; apruebas en lotes
Aplicar

Cierra los que aprobé con un comentario 'cerrando como obsoleto'.✓ Copiado

→ jira_transition_issue + jira_add_comment llamados por issue

Resultado: Backlog limpio con rastro de auditoría por issue.

Errores comunes

Cerrar automáticamente tickets legítimos pero silenciosos — Siempre procesa en lotes y confirma antes de transicionar

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

mcp-atlassian-sooperset + sentry

Convertir errores de Sentry en tickets Jira bien formados

Sentry: obtén el último issue crítico. Atlassian: crea un BUG Jira con el stack trace y vincula la URL de Sentry.✓ Copiado

mcp-atlassian-sooperset + github

Vincular PRs a tickets Jira automáticamente

GitHub: encuentra los PRs fusionados hoy. Atlassian: para cada uno, comenta en el issue Jira vinculado con la URL del PR.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
jira_search	jql: str, limit?	Cualquier búsqueda en Jira	1 llamada API
jira_get_issue	key: str, fields?	Necesitas el cuerpo completo de un issue	1 llamada
jira_create_issue	project, type, summary, description, fields?	Crear nuevo ticket	1 llamada
jira_transition_issue	key, transition, comment?	Mover issue por el flujo de trabajo	1 llamada
jira_add_comment	key, body	Añadir contexto	1 llamada
confluence_search	cql: str	Encontrar documentación	1 llamada
confluence_get_page	id: str	Leer contenido de página	1 llamada
confluence_create_page	space, parent_id, title, body	Nuevo documento	1 llamada
confluence_update_page	id, title, body, version	Editar documento	1 llamada

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Atlassian Cloud: 5000 req/h por usuario/token (varía según el plan)
Tokens por llamada: 300–4000
Monetario: OSS gratuito; tu plan Atlassian aplica
Consejo: Usa fields= para reducir el tamaño de los payloads; los valores predeterminados de jira_get_issue son pesados

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: read:jira-work write:jira-work read:confluence-content.all write:confluence-content

Almacenamiento de credenciales: Token API en variable de entorno; rota via My Account

Salida de datos: Solo tu instancia atlassian.net (o self-hosted)

No conceder nunca: site-admin

Establece READ_ONLY_MODE=true si Claude no debe poder mutar; cubre todas las herramientas de escritura

Resolución de problemas

Errores comunes y soluciones

401 Unauthorized

Token caducado o nombre de usuario incorrecto (debe ser email para Cloud)

Verificar: curl -u email:token $URL/rest/api/3/myself

Error de parseo JQL

Entrecomilla los valores string, escapa los caracteres especiales; previsualiza con la UI de Jira primero

Forbidden al crear en espacio

El usuario del token no tiene permiso 'Añadir página' en ese espacio

Rate-limited 429

Espera; reduce el fanout paralelo; comprueba el rate limit de Atlassian por token

Verificar: Cabeceras X-RateLimit

Alternativas

MCP Atlassian vs otros

Alternativa	Cuándo usarla	Contrapartida
Atlassian official MCP (Cloud)	Solo usas Cloud y quieres OAuth	Más nuevo, conjunto de herramientas más reducido; no cubre Server/DC
Linear MCP	Usas Linear, no Jira	Sistema diferente; más rápido/limpio pero sin equivalente de Confluence

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills