@cocaxcode/devflow-mcp
runningConecta Jira con GitHub/GitLab para automatizar tu workflow dev. 32 tools: branches, issues, PRs/MRs, flow playbooks y reglas de seguridad.
¿Por qué devflow-mcp?
El workflow típico de desarrollo implica saltar entre Jira, GitHub/GitLab, la terminal y el IDE. Con devflow-mcp todo eso se hace desde tu asistente AI: consultar issues, crear branches, hacer PRs/MRs y mover tickets sin cambiar de ventana.
Instalación
claude mcp add --scope user devflow -- npx -y @cocaxcode/devflow-mcp@latest¿Qué puedes hacer?
Consulta tus issues asignados, ve detalles, transiciona estados, asigna y comenta. Todo desde el chat.
Crea branches con naming convention: feat/PROJ-123-descripción o fix/PROJ-123-descripción. Verifica cambios pendientes antes de crear.
Genera PRs en GitHub o MRs en GitLab con título y descripción. Compatible con ambos providers.
Secuencias de pasos repetibles. Define un flow "start-task" que asigne el issue, cree la branch y mueva el ticket a In Progress.
Configura reglas que bloquean o advierten sobre acciones peligrosas: no merge a main, no cerrar issues, solo tus issues.
Branch, checkout, pull, push, merge y creación de PRs/MRs. Todo con verificación de cambios pendientes y confirmación.
Ejemplo: flow start-task
// Di: "empieza PROJ-123"
// El flow ejecuta automáticamente:
1. df_assign → te asigna el issue
2. df_branch → crea feat/PROJ-123-desc
3. df_transition → mueve a "In Progress"Ejemplo: crear PR/MR
// Di: "crea un PR para este issue"
df_pr:
title: "feat(PROJ-123): add user authentication"
body: "Implements JWT auth with refresh tokens"
// Detecta automáticamente si es GitHub (PR) o GitLab (MR)
→ GitHub: crea Pull Request
→ GitLab: crea Merge RequestReglas por defecto
| Regla | Acción | Descripción |
|---|---|---|
| no-merge-to-base | block | Bloquea push directo a main/master |
| no-merge-from-dev | warn | Avisa si mergeas branches de desarrollo |
| only-own-issues | warn | Avisa si modificas issues de otros |
| no-close-issues | warn | Avisa antes de cerrar issues |
Scopes de proyecto
Cada proyecto tiene paths (scopes) que lo vinculan a directorios físicos. Cuando abres un directorio que es scope de un proyecto, se activa como default automáticamente. Puedes cambiar al proyecto activo con df_project_switch para consultas temporales — al reiniciar vuelve al default.
Así se ve en la práctica
Tu: "Configura Jira + GitHub para este repo"
MCP: df_project_setup (pide credenciales)
IA: "Necesito tu URL de Jira, email, API token y
token de GitHub. Son secretos — no los invento."
Tu: "Jira: https://myteam.atlassian.net, proyecto PROJ,
email: me@example.com, token: ..."
MCP: detecta Cloud v3 + GitHub, valida credenciales
IA: "Proyecto configurado: Jira Cloud + GitHub.
Rama base: main. Este directorio es scope."Tu: "Vamos con PROJ-123"
MCP: df_issue → lee detalles
df_branch → crea feat/PROJ-123-add-auth
df_transition → mueve a In Progress
df_assign → te asigna el issue
IA: "Tarea PROJ-123 en marcha. Branch creada,
issue en In Progress y asignado a ti."Tu: "Crea un PR con lo que llevo"
MCP: df_push → sube la branch
df_pr → crea PR en GitHub
IA: "PR creado: feat(PROJ-123): add user auth.
URL: github.com/org/repo/pull/42"Tu: "Cambia al proyecto frontend para ver sus issues"
MCP: df_project_switch → activa 'frontend' (sesión)
IA: "Proyecto activo: frontend (sesión). Al reiniciar
volvera al default de este directorio."Tu: "Que tengo pendiente?"
MCP: df_issues → busca issues asignados
IA: "3 issues asignados:
PROJ-45: Fix login bug (High)
PROJ-46: Add dark mode (Medium)
PROJ-47: Update docs (Low)"Tu: "Crea un flow 'pr-ready' que pushee y cree el PR"
MCP: df_flow_create → 2 pasos: df_push + df_pr
IA: "Flow 'pr-ready' creado. Di 'ejecuta pr-ready'
cuando quieras pushear y crear el PR de golpe."df_project_switch. Credenciales aisladas por proyecto.