Jira desde laterminal.
Cómo gestionamos proyectos enteros con Claude Code + MCP + Jira sin abrir el navegador.
AGENTE 404
Marcos García · CEO
Lectura · 8 min
Cada vez que un dev sale del IDE para mover una tarjeta, escribir un comentario o leer una historia, pierde foco. En equipo pequeño, ese coste se nota en el sprint.
Tickets en "In Progress" 4 días después del merge. Standups con datos viejos.
Lo que se decide en chat no llega al ticket. La descripción y el código divergen.
El PM dedica 2h/semana clasificando bugs y bumpeando prioridades a mano.
CLI agéntica de Anthropic. Vive en la terminal del dev, ejecuta comandos, edita ficheros, llama a herramientas externas.
Estándar abierto (Anthropic, nov 2024). El "USB-C" entre LLMs y herramientas. Hoy soportado por Claude, Cursor, Windsurf, OpenAI.
Donde vive la verdad de los proyectos. Issues, sprints, transitions, comentarios, JQL.
Antes de MCP, cada IDE inventaba su propia integración con cada herramienta. N×M conectores. Con MCP, herramienta y cliente hablan el mismo idioma → N+M.
Crear ticket, transicionar, buscar JQL, comentar. Cada tool es una función con schema JSON.
Issue completo, board, sprint actual. Indexable por el modelo como contexto.
"Genera nota de release del sprint X" — empaquetadas y compartidas en el equipo.
"Crea épica de checkout y abre las 6 historias."
Razona, descompone, llama a tools.
Traduce a REST API de Atlassian.
Crea issues, devuelve IDs y links.
Dev recibe IDs, los referencia en el commit.
Configurar el MCP de Atlassian en Claude Code es trivial. Token API + dominio + email. El servidor corre local o en Docker.
# Registrar el MCP server de Atlassian $ claude mcp add atlassian \ --env JIRA_URL=https://company.atlassian.net \ --env JIRA_EMAIL=$JIRA_EMAIL \ --env JIRA_API_TOKEN=$JIRA_API_TOKEN \ -- npx -y mcp-atlassian ✓ atlassian conectado · 32 tools disponibles jira_search · jira_create_issue · jira_transition_issue · jira_add_comment …
› Lee docs/brief-checkout.md y crea la épica en Jira (proyecto PRJ). Descompón en historias estimadas, etiqueta @backend / @frontend, asigna sprint actual. ⏺ jira_search(jql="project=PRJ AND sprint in openSprints()") → Sprint actual ⏺ jira_create_issue(type=Epic, summary="Checkout — pasarela de pagos") → PRJ-101 ⏺ jira_create_issue ×6 (linked to PRJ-101) ├─ PRJ-102 · API: endpoint /checkout/session [5] @backend ├─ PRJ-103 · DB: tabla payment_intent + migración [3] @backend ├─ PRJ-104 · UI: formulario billing + validación [5] @frontend ├─ PRJ-105 · Webhook payment.succeeded [3] @backend ├─ PRJ-106 · Estado pedido post-pago [2] @frontend └─ PRJ-107 · Tests E2E flujo completo [3] @qa ✓ Épica creada · 6 historias · 21 SP · sprint asignado · 14s
Cada mañana, un slash command (/standup) cruza Jira + git + Slack y resume el estado real del equipo en 20 segundos.
⏺ En curso (asignado, no done): • PRJ-104 UI billing — @dev-a · 2 commits ayer · branch feat/billing-form • PRJ-102 API checkout — @dev-b · PR abierto · review pendiente ⏺ Bloqueados: • PRJ-105 Webhook pagos — sin actividad 3 días · @dev-b ⚠ revisar ⏺ Cerrado ayer: • PRJ-103 migración payment_intent · merged en main ⏺ Burndown: 13 SP restantes · proyección en plazo · 4 días
Hook de post-commit en Claude Code: detecta el ID del ticket en el mensaje y dispara la transición + comentario con el diff resumido.
$ git commit -m "feat(api): add /checkout/session endpoint [PRJ-102]" → Claude Code post-commit hook activado ⏺ jira_transition_issue(PRJ-102, "In Review") ⏺ jira_add_comment(PRJ-102, summary={ "commit": "a3f9b1c", "files": ["api/checkout.ts", "api/checkout.test.ts"], "diff": "+142 / -3", "tests": "12 passing", "pr": "github.com/<org>/<repo>/pull/284" }) ✓ PRJ-102 → In Review · comentario añadido · PR enlazado
JQL: type=Bug AND priority is EMPTY
Busca el módulo afectado, último autor, frecuencia de fallo en logs.
P1 a P4 razonado, asignación tentativa al dev con menos carga.
Una sola decisión por lote. Claude aplica los cambios.
El PM revisa propuestas, no construye desde cero. Sin ticket olvidado en el limbo.
Datos internos de agente404 — 3 sprints comparando antes/después de adoptar el flujo.
Escritura solo con confirmación humana. Una alucinación que cierra 40 tickets es un mal día.
Priorizar épicas, mover deadlines, reasignar leads. Esto vive en humano. Claude propone, humano dispone.
Un proyecto, un usuario de servicio, lectura amplia, escritura acotada. Auditar logs MCP semanalmente.
Jira es el primer paso. La filosofía es la misma: cualquier herramienta crítica del flujo entra al modelo como una tool.
Jira + Confluence. Tickets, sprints, docs.
PRs, reviews, issues, releases.
Resúmenes, búsqueda en hilos, mensajes.
Schema, queries acotadas, migraciones.