jira-skill MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Compatible con Jira Server, DC y Cloud
Sin Docker — solo shell + Python
Ciclo de vida completo del problema: crear, transicionar, comentar, vincular, registros de tiempo, adjuntar
Ayudantes de búsqueda JQL
Gestión de sprint y tablero
Configurador interactivo de credenciales jira-setup.py
Ayuda de jira-syntax para marcado wiki

Demo en vivo

Cómo se ve en la práctica

jira-skill.replay ▶ listo

0/0

Instalar

Elige tu cliente

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

{
  "mcpServers": {
    "jira-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/jira-skill",
        "~/.claude/skills/jira-skill"
      ],
      "_inferred": true
    }
  }
}

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

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

{
  "mcpServers": {
    "jira-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/jira-skill",
        "~/.claude/skills/jira-skill"
      ],
      "_inferred": true
    }
  }
}

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": {
    "jira-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/jira-skill",
        "~/.claude/skills/jira-skill"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "jira-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/jira-skill",
        "~/.claude/skills/jira-skill"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "jira-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/jira-skill",
        "~/.claude/skills/jira-skill"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "jira-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/netresearch/jira-skill",
          "~/.claude/skills/jira-skill"
        ]
      }
    }
  }
}

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

claude mcp add jira-skill -- git clone https://github.com/netresearch/jira-skill ~/.claude/skills/jira-skill

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

Casos de uso

Usos del mundo real: jira-skill

Clasificar una pila de sprint y desatascar problemas bloqueados

👤 Scrum masters, líderes técnicos ⏱ ~20 min beginner

Cuándo usarlo: A mitad del sprint cuando la velocidad está cayendo y sospechas que hay obstáculos.

Requisitos previos

Credenciales de Jira configuradas — Ejecuta jira-setup.py y proporciona URL + email + token API (Cloud) o PAT (Server/DC)
Habilidad instalada — git clone https://github.com/netresearch/jira-skill ~/.claude/skills/jira-skill

Flujo

Listar problemas del sprint por estado

Usa jira-skill. Lista los problemas en el sprint 'Sprint 42' agrupados por estado. Marca cualquier cosa no actualizada en 3 días.✓ Copiado

→ Tabla agrupada con marcadores de estancamiento
Profundizar en obstáculos

Para los problemas bloqueados, obtén el último comentario y los problemas vinculados — ¿quién está esperando qué?✓ Copiado

→ Resumen de dependencias
Impulsar a los propietarios

Redacta un comentario en cada problema bloqueado etiquetando a la parte responsable.✓ Copiado

→ Borradores por problema

Resultado: Una lista clara de acciones de desbloqueo para impulsar en el stand-up.

Errores comunes

Sobre-etiquetar — los comentarios cuestan atención — Deja que Claude redacte; publica manualmente solo los que importan

Combinar con: github

Generar notas de lanzamiento a partir de problemas cerrados

👤 Gestores de lanzamiento ⏱ ~15 min beginner

Cuándo usarlo: Cuando estás cortando un lanzamiento y necesitas notas orientadas al usuario a partir de la lista de problemas.

Flujo

JQL para el lanzamiento

JQL: fixVersion = 1.42 AND status = Done. Extrae resúmenes y tipos.✓ Copiado

→ Lista de problemas ordenada
Redactar notas

Agrupa por tipo (Función / Error / Mejora) y redacta notas de lanzamiento orientadas al usuario — sin jerga interna.✓ Copiado

→ Notas Markdown listas para publicar

Resultado: Notas de lanzamiento en minutos en lugar de horas.

Combinar con: github

Transicionar en masa problemas a través de un flujo de trabajo

👤 Administradores de proyectos ⏱ ~10 min intermediate

Cuándo usarlo: Moviendo un lote de problemas entre estados (p. ej. deploy-complete).

Flujo

Ejecutar primero en seco

Encuentra todos los problemas 'En Staging' con fixVersion = 1.42. Aún no transiciones — solo lista.✓ Copiado

→ Lista para confirmar
Transición

Transiciona esos a 'Hecho' con un comentario 'Desplegado en producción en 1.42'.✓ Copiado

→ Resultado de transición por problema

Resultado: Estado de flujo de trabajo limpio, nada quedó en 'En Staging'.

Errores comunes

Campos requeridos faltantes en la transición — La habilidad expone el campo requerido; suministralo en el prompt

Resumir el registro de tiempo de un equipo durante el mes

👤 Gestores de ingeniería, PMs rastreando capacidad ⏱ ~20 min intermediate

Cuándo usarlo: Revisión de capacidad de fin de mes.

Flujo

Consultar registros de tiempo

Extrae todos los registros de tiempo para miembros del equipo en el proyecto ACME del mes pasado.✓ Copiado

→ Totales de horas por persona, por problema
Resumir

Resume a épica y comparte del total.✓ Copiado

→ Desglose de nivel superior

Resultado: Imagen de capacidad basada en trabajo realmente registrado.

Errores comunes

Los registros de tiempo no están rellenos — datos malos — Marca a personas con 0 registros; no saques conclusiones de datos faltantes

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

jira-skill + github

Vincular PRs a problemas de Jira o crear problemas de Jira a partir de errores de GitHub

Para cada problema de GitHub etiquetado como 'bug' abierto esta semana, crea un ticket de Jira en el proyecto ACME.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
get_issue	clave del problema	En cualquier momento	1 llamada API
search_jql	cadena JQL	Descubrimiento	1 llamada API
create_issue	proyecto, tipo, resumen, descripción	Presentar nuevo problema	1 llamada API (escritura)
transition_issue	clave, id/nombre de transición	Movimientos de flujo de trabajo	1 llamada API (escritura)
add_comment	clave, cuerpo (jira-syntax ok)	Impulsos + notas	1 llamada API (escritura)
link_issues	clave, inward, tipo de vínculo	Dependencias	1 llamada API
add_worklog	clave, tiempo, comentario	Seguimiento de tiempo	1 llamada API
sprint_manage	tablero, sprint, acción	Operaciones Scrum	1 llamada API

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Jira Cloud: típicamente 10 req/seg por usuario; Server/DC está configurado por instancia
Tokens por llamada: Bajo — principalmente respuestas API
Monetario: Habilidad gratuita; licencia de Jira por separado
Consejo: Usa filtros JQL del lado del servidor en lugar de extraer todo y filtrar del lado del cliente

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Leer proyecto; escribir solo donde sea necesario (transición/comentario)

Almacenamiento de credenciales: JIRA_URL + JIRA_USER + JIRA_TOKEN en env; no registres en git

Salida de datos: Solo a tu host de Jira

No conceder nunca: Admin en la instancia

Los tokens API para Cloud deben tener alcance de usuario; para Server/DC utiliza tokens de acceso personal, no contraseñas.

Resolución de problemas

Errores comunes y soluciones

401 No autorizado

Token faltante o revocado; ejecuta jira-setup.py de nuevo

Verificar: curl -u $JIRA_USER:$JIRA_TOKEN $JIRA_URL/rest/api/2/myself

400 en transición

La transición requiere un campo que no proporcionaste — inspecciona transiciones con get_transitions

La búsqueda devuelve 0 pero los problemas existen

Tu JQL o permisos del proyecto; verifica que el usuario pueda ver el proyecto

Alternativas

jira-skill vs otros

Alternativa	Cuándo usarla	Contrapartida
MCP oficial de Atlassian	Prefieres integración de primer nivel	Menos control sobre el acceso a shell

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills