Etiquetas

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 label proporciona 6 acciones para gestionar etiquetas — el sistema de etiquetado entre proyectos que le da a tu equipo categorización flexible más allá de los flujos de trabajo fijos. Las etiquetas te permiten segmentar el trabajo por área funcional, tecnología, prioridad, equipo o cualquier dimensión personalizada que tu organización necesite. A través del MCP Server, tu asistente de IA puede crear etiquetas, adjuntarlas a tareas, alternarlas y gestionar toda tu taxonomía de etiquetado.

Las etiquetas en GitScrum operan a nivel de workspace, lo que significa que una etiqueta creada en tu workspace está disponible en todos los proyectos. Esto te da un vocabulario consistente para categorizar trabajo, ya sea que una tarea viva en el proyecto Backend, el proyecto Frontend o cualquier otro. Cuando adjuntas una etiqueta a una tarea, se convierte en una dimensión filtrable — puedes usar la acción filter de la herramienta task para encontrar todas las tareas con una etiqueta específica en cualquier proyecto.

Resumen de acciones

Listar etiquetas

La acción list devuelve todas las etiquetas del workspace. Cada etiqueta en la respuesta incluye su slug, título y color. Como las etiquetas tienen alcance de workspace, esta única llamada te da la taxonomía completa de etiquetas disponible en todos los proyectos.

Parámetros requeridos

Ejemplos de prompts

Tú:   "Lista todas las etiquetas disponibles"
IA:   Llama a label action=list → devuelve todas las etiquetas del workspace con títulos y colores

Tú:   "¿Qué etiquetas tenemos configuradas?"
IA:   Llama a label action=list → presenta la taxonomía completa de etiquetas

Tú:   "Muéstrame los colores de etiquetas que estamos usando"
IA:   Llama a label action=list → muestra las etiquetas con sus colores asociados

Crear etiquetas

La acción create construye una nueva etiqueta con un título y color. Tanto el título como el color son requeridos — cada etiqueta debe ser visualmente distinta para que los miembros del equipo puedan identificarlas de un vistazo en el tablero Kanban.

Parámetros requeridos

Patrones comunes de etiquetas

Los equipos típicamente establecen etiquetas a lo largo de una o más de estas dimensiones:

Ejemplos de prompts

Tú:   "Crea una etiqueta 'bug' con color rojo FF0000"
IA:   Llama a label action=create con title="bug", color="FF0000"

Tú:   "Crea etiquetas para nuestro flujo de desarrollo: 'frontend' en azul,
       'backend' en verde, 'mobile' en naranja"
IA:   Llama a label action=create tres veces con títulos y colores distintos

Tú:   "Agrega una etiqueta 'tech-debt' con color púrpura"
IA:   Llama a label action=create con title="tech-debt", color="8B5CF6"

Tú:   "Crea una etiqueta 'needs-review' en amarillo"
IA:   Llama a label action=create con title="needs-review", color="F59E0B"

Actualizar etiquetas

La acción update modifica el título o color de una etiqueta existente. Esto es útil cuando necesitas renombrar una etiqueta para reflejar mejor su propósito o cambiar su color para mejorar la consistencia visual.

Parámetros requeridos

Parámetros opcionales

Ejemplos de prompts

Tú:   "Renombra la etiqueta 'bug' a 'defect'"
IA:   Llama a label action=update con label_slug, title="defect"

Tú:   "Cambia el color de la etiqueta 'urgent' a rojo oscuro"
IA:   Llama a label action=update con label_slug, color="DC2626"

Tú:   "Actualiza la etiqueta 'frontend' a 'client-side' y cambia el color a teal"
IA:   Llama a label action=update con title="client-side", color="14B8A6"

Adjuntar etiquetas a tareas

La acción attach agrega una etiqueta a una tarea específica. Una tarea puede tener múltiples etiquetas simultáneamente, permitiendo categorización multidimensional. Por ejemplo, una tarea puede ser etiquetada como "bug" y "frontend" para indicar que es un bug de front-end.

Parámetros requeridos

Ejemplos de prompts

Tú:   "Adjunta la etiqueta 'bug' a la tarea [uuid]"
IA:   Llama a label action=attach con label_slug="bug", task_uuid, project_slug

Tú:   "Etiqueta la tarea de login como 'frontend' y 'urgent'"
IA:   Llama a label action=attach dos veces — una para cada etiqueta

Tú:   "Agrega la etiqueta 'needs-review' a todas las tareas en la columna Done"
IA:   Filtra tareas por columna de flujo de trabajo → llama a label action=attach para cada tarea

Quitar etiquetas de tareas

La acción detach quita una etiqueta de una tarea específica. La etiqueta en sí permanece en el workspace — solo se elimina la asociación con la tarea.

Parámetros requeridos

Ejemplos de prompts

Tú:   "Quita la etiqueta 'urgent' de la tarea [uuid]"
IA:   Llama a label action=detach con label_slug="urgent", task_uuid

Tú:   "El bug de login está corregido — quita la etiqueta 'bug'"
IA:   Encuentra la tarea → llama a label action=detach con label_slug="bug"

Alternar etiquetas

La acción toggle es una acción de conveniencia que combina attach y detach en una sola llamada. Si la etiqueta está actualmente en la tarea, toggle la quita. Si la etiqueta no está en la tarea, toggle la agrega. Esto es particularmente útil cuando el asistente de IA no conoce el estado actual de la etiqueta en una tarea — puede alternar sin verificar primero.

Parámetros requeridos

Ejemplos de prompts

Tú:   "Alterna la etiqueta 'blocked' en la tarea [uuid]"
IA:   Llama a label action=toggle → agrega o quita la etiqueta según el estado actual

Tú:   "Cambia la etiqueta 'needs-review' en la tarea de despliegue"
IA:   Llama a label action=toggle con el label_slug y task_uuid correspondientes

Estrategia de etiquetado

Una taxonomía de etiquetas bien diseñada hace que el filtrado y los reportes sean significativamente más poderosos. Aquí hay prácticas recomendadas para equipos que adoptan gestión de etiquetas impulsada por MCP:

Mantener etiquetas planas y componibles

En lugar de crear etiquetas profundamente específicas como "frontend-bug-critical", crea etiquetas independientes ("frontend", "bug", "critical") y combínalas en tareas. Esto te da filtrado más flexible — encuentra todos los bugs, todo el trabajo de frontend, o específicamente bugs críticos de frontend.

Establecer convenciones de nombres

Usa nombres en minúsculas con guiones para consistencia: tech-debt, needs-review, api-v2. Esto hace las etiquetas predecibles al referenciarlas en conversaciones con IA.

Usar etiquetas con filtrado de tareas

Las etiquetas desbloquean filtrado poderoso a través de la acción filter de la herramienta task:

Tú:   "Muéstrame todas las tareas etiquetadas como 'tech-debt' en el proyecto Backend"
IA:   Llama a task action=filter con labels="tech-debt"

Tú:   "Encuentra todas las tareas 'blocked' en el sprint actual"
IA:   Llama a task action=filter con labels="blocked", sprint=[sprint actual]

Tú:   "¿Cuántas tareas 'bug' siguen abiertas?"
IA:   Llama a task action=filter con labels="bug", status="todo"
      → cuenta los resultados

Auto-resolución de contexto

La herramienta label soporta resolución automática de contexto. Como las etiquetas tienen alcance de workspace, el asistente de IA solo necesita el companyslug para listar y crear etiquetas. Para operaciones a nivel de tarea (attach, detach, toggle), el projectslug también es requerido porque las tareas viven dentro de proyectos específicos.

Próximos pasos

• Tareas: Adjunta etiquetas a tareas y usa filtrado basado en etiquetas.
• Tipos de Tarea: Configura tipos de tarea para categorización estructural junto con etiquetas.
• Sprints: Filtra tareas del sprint por etiqueta para revisiones enfocadas.
• Inicio Rápido: Configura el servidor MCP si aún no lo has hecho.