Flujos de Trabajo

Código Abierto — GitScrum MCP Server es código abierto bajo la licencia MIT. Disponible en npm y en GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor y cualquier cliente compatible con MCP tienen acceso operacional completo a tu stack de gestión de proyectos.

La herramienta workflow proporciona 2 acciones para inspeccionar la configuración del flujo de trabajo Kanban de tu proyecto — la estructura de columnas que define cómo las tareas se mueven de "por hacer" a través de "en progreso" hasta "hecho". Mientras que las columnas del flujo de trabajo se configuran en la aplicación web de GitScrum, el MCP Server le da a tu asistente de IA acceso de lectura a la estructura completa del flujo de trabajo, lo cual es esencial para crear tareas en la columna correcta, mover tareas entre etapas y entender el proceso de tu equipo.

Los flujos de trabajo en GitScrum definen las etapas visuales y lógicas de tu tablero Kanban. Cada columna tiene un id único (el workflow_id), un título, una posición y un color. El MCP Server expone estos metadatos para que tu asistente de IA pueda referenciar columnas por nombre y resolverlas a los IDs numéricos correctos que la herramienta task requiere.

Resumen de acciones

Listar columnas del flujo de trabajo

La acción list devuelve todas las columnas Kanban configuradas para un proyecto específico, en su orden de visualización. Cada columna en la respuesta incluye su id (usado como workflow_id en operaciones de tareas), uuid, título, posición y color. Esta es la fuente definitiva de verdad para la estructura del flujo de trabajo de tu proyecto.

Tu asistente de IA típicamente llama a esta acción como parte de su fase de recopilación de contexto — antes de crear tareas o moverlas entre columnas, necesita saber qué columnas existen y cuáles son sus IDs.

Parámetros requeridos

Estructura de la respuesta

Cada columna del flujo de trabajo en la respuesta incluye:

Ejemplos de prompts

Tú:   "Muestra todas las columnas del flujo de trabajo del proyecto Backend"
IA:   Llama a workflow action=list → devuelve columnas con IDs, títulos y posiciones

Tú:   "¿Qué columnas Kanban están disponibles?"
IA:   Llama a workflow action=list → presenta la estructura del tablero: Backlog → To Do →
      In Progress → Code Review → QA → Done

Tú:   "Lista las etapas del flujo de trabajo del proyecto Frontend"
IA:   Llama a workflow action=list → devuelve la configuración de columnas

Tú:   "¿Cómo está estructurado nuestro tablero Kanban?"
IA:   Llama a workflow action=list → describe el flujo de columnas de izquierda a derecha

Obtener detalles de columna

La acción get devuelve los detalles completos de una columna de flujo de trabajo específica, incluyendo todos sus metadatos y propiedades de configuración. Esto es útil cuando necesitas información detallada sobre una etapa particular de tu flujo de trabajo.

Parámetros requeridos

Ejemplos de prompts

Tú:   "Muéstrame los detalles de la columna 'In Progress'"
IA:   Encuentra la columna via list → llama a workflow action=get → devuelve detalles completos

Tú:   "¿Cuál es la configuración de la columna Code Review?"
IA:   Llama a workflow action=get con el UUID de la columna → devuelve metadatos completos

Cómo los flujos de trabajo se conectan con las tareas

Los IDs de las columnas del flujo de trabajo son la base para la ubicación de tareas en el tablero Kanban. Entender esta conexión es esencial para una gestión efectiva de proyectos impulsada por MCP.

Crear tareas en una columna específica

Al crear una tarea, puedes colocarla en una columna específica usando:

• column (string): El nombre de la columna (ej. "In Progress"). El servidor MCP lo resuelve al workflow_id correcto automáticamente.
• workflow_id (number): El ID numérico de la columna de la lista de flujos de trabajo. Usa esto cuando ya tengas el ID de una llamada previa a workflow action=list.

El parámetro column es recomendado para la mayoría de los casos porque es más natural en conversación. El servidor MCP maneja la resolución de nombre a ID internamente.

Tú:   "Crea una tarea 'Corregir validación de login' en la columna In Progress"
IA:   Llama a task action=create con column="In Progress"
      → El servidor MCP resuelve al workflow_id automáticamente

Tú:   "Agrega una tarea a la columna Code Review"
IA:   Llama a task action=create con column="Code Review"

Mover tareas entre columnas

Al actualizar la columna de una tarea, puedes usar el mismo parámetro column:

Tú:   "Mueve la tarea GS-123 a Done"
IA:   Llama a task action=update con column="Done"
      → El servidor MCP resuelve el nombre de la columna a workflow_id

Tú:   "Mueve la corrección de login a Code Review"
IA:   Llama a task action=update con column="Code Review"

Transferir tareas entre proyectos

Al mover una tarea a un proyecto diferente usando task action=move, necesitas el newworkflowid del proyecto destino. Diferentes proyectos pueden tener diferentes configuraciones de flujo de trabajo, así que el asistente de IA necesita listar primero los flujos de trabajo del proyecto destino:

Tú:   "Mueve la tarea GS-123 al Backlog del proyecto Frontend"
IA:   1. Llama a workflow action=list para el proyecto Frontend
      2. Encuentra el ID de la columna "Backlog"
      3. Llama a task action=move con new_project_slug y new_workflow_id

Resolución inteligente de columnas

El MCP Server incluye resolución integrada de nombres de columna — una funcionalidad que le ahorra a tu asistente de IA una llamada extra a la API en muchos escenarios. Cuando pasas un parámetro column por nombre a las acciones create o update de la herramienta task, el servidor:

1. Obtiene la configuración del flujo de trabajo del proyecto
2. Busca coincidencia del nombre de columna (sin distinción de mayúsculas/minúsculas)
3. Lo resuelve al workflow_id numérico
4. Ejecuta la operación de tarea con el ID correcto

Si el nombre de la columna no coincide con ninguna columna existente, el servidor devuelve un mensaje de error que incluye la lista de nombres de columna disponibles. Esto permite al asistente de IA sugerirte el nombre correcto de columna:

Tú:   "Mueve la tarea a Review"
IA:   Intenta column="Review" → el servidor devuelve "Columna no encontrada. Columnas disponibles:
      Backlog, To Do, In Progress, Code Review, QA, Done"
IA:   "No veo una columna 'Review'. ¿Quisiste decir 'Code Review'?"

Gestión de tareas basada en columnas

Las columnas del flujo de trabajo habilitan consultas y operaciones poderosas de tareas. Al combinar el conocimiento del flujo de trabajo con la acción filter de la herramienta task, tu asistente de IA puede responder preguntas a nivel de tablero:

Verificar contenido de columnas

Tú:   "¿Qué tareas hay en la columna In Progress?"
IA:   Llama a task action=filter con workflow="In Progress"
      → devuelve todas las tareas actualmente en esa columna

Tú:   "¿Cuántas tareas hay en Code Review?"
IA:   Llama a task action=filter con workflow="Code Review"
      → cuenta y reporta los resultados

Tú:   "Muéstrame el Backlog"
IA:   Llama a task action=filter con workflow="Backlog"
      → devuelve todas las tareas en la columna Backlog

Identificar cuellos de botella

Tú:   "¿Qué columna tiene más tareas?"
IA:   Llama a workflow action=list → para cada columna, llama a task action=filter
      → identifica la columna con el mayor conteo de tareas

Tú:   "¿Hay cuellos de botella en nuestro flujo de trabajo?"
IA:   Analiza conteos de tareas por columna → señala columnas con conteos
      desproporcionadamente altos en relación a las demás

Tú:   "¿Cuánto tiempo llevan las tareas esperando en Code Review?"
IA:   Llama a task action=filter con workflow="Code Review"
      → analiza fechas de creación de tareas y tiempo en la columna

Consultas para daily standup

Tú:   "Dame un resumen de standup: qué se movió ayer, qué está en progreso
       y qué está bloqueado"
IA:   Filtra tareas por columna y actividad reciente → genera un informe
      estructurado de standup cubriendo Done (ayer), In Progress (hoy) y elementos bloqueados

Configuraciones típicas de flujo de trabajo

Aunque cada equipo configura su tablero de forma diferente, estos son patrones comunes de flujo de trabajo que encontrarás:

Flujo de trabajo simple

Backlog → In Progress → Done

Flujo de trabajo de desarrollo

Backlog → To Do → In Progress → Code Review → QA → Done

Flujo de trabajo de agencia

Brief → Design → Development → Review → Client Approval → Done

Flujo de trabajo de soporte

New → Triaged → In Progress → Resolved → Closed

El MCP Server funciona con cualquier configuración — tu asistente de IA se adapta a las columnas que tu proyecto use leyendo la estructura del flujo de trabajo al inicio de la conversación.

Auto-resolución de contexto

La herramienta workflow soporta resolución automática de contexto. Si el asistente de IA ya conoce tu workspace y proyecto de una llamada previa en la conversación, lleva ese contexto hacia adelante. Además, cuando se usa la resolución inteligente de columnas de la herramienta task, la búsqueda del flujo de trabajo ocurre automáticamente — no necesitas llamar explícitamente a workflow action=list antes de cada operación de tarea.

Próximos pasos

• Tareas: Crea y mueve tareas a través de las columnas del flujo de trabajo.
• Tipos de Tarea: Configura tipos de tarea para categorizar trabajo dentro de las columnas.
• Sprints: Da seguimiento a cómo las tareas fluyen a través de las columnas durante un sprint.
• Proyectos: Gestiona las configuraciones del proyecto que incluyen la configuración del flujo de trabajo.
• Inicio Rápido: Configura el servidor MCP si aún no lo has hecho.