GitScrum / Docs

Presupuesto

Gestión de presupuesto de proyecto a través de MCP. Da seguimiento a gastos, previsiones, alertas presupuestarias y resúmenes financieros para tus proyectos.

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 budget proporciona 6 acciones para gestión financiera del proyecto — desde recuperar presupuestos actuales hasta pronosticar gastos y configurar alertas de umbral. Cada acción cumple un rol diferente en supervisión financiera, permitiendo a tu asistente de IA funcionar como un controlador financiero del proyecto que puede revisar, analizar y alertar sobre el estado del presupuesto.

Los presupuestos en GitScrum conectan el seguimiento financiero directamente con la gestión de proyectos. Los datos de seguimiento de tiempo, contratos de clientes y asignación de recursos alimentan los cálculos de presupuesto. El MCP Server hace que estos datos financieros sean accesibles a través de lenguaje natural, para que puedas preguntar "¿Estamos dentro del presupuesto?" y obtener informes financieros estructurados con tasas de consumo, proyecciones de pronóstico y evaluaciones de riesgo.


Resumen de acciones

AcciónPropósitoParámetros requeridos
getRecuperar los detalles del presupuesto del proyectocompanyslug, projectslug
updateModificar la configuración del presupuestocompanyslug, projectslug, + campos de actualización
summaryObtener resumen financiero con métricascompanyslug, projectslug
alertsVer alertas y umbrales de presupuestocompanyslug, projectslug
at_riskListar proyectos en riesgo de exceder presupuestocompany_slug
forecastGenerar previsiones de gasto presupuestariocompanyslug, projectslug

Parámetros

ParámetroTipoDescripción
company_slugstringIdentificador del workspace (requerido para todas las acciones)
project_slugstringIdentificador del proyecto (requerido para la mayoría de acciones)
total_budgetnumberMonto total del presupuesto (para acción update)
currencystringCódigo de moneda (para acción update)
alert_thresholdnumberPorcentaje de umbral de alerta (para acción update)

Obtener presupuesto

La acción get recupera la configuración actual del presupuesto de un proyecto — presupuesto total, monto gastado, monto restante, moneda y configuración de umbrales. Esta es la base para todas las consultas financieras.

You:  "¿Cuál es el presupuesto del proyecto Backend?"
AI:   Llama a budget action=get
      → devuelve presupuesto total, gastado, restante y porcentaje utilizado

You:  "¿Cuánto presupuesto nos queda?"
AI:   Llama a budget action=get
      → la IA reporta monto restante con contexto de porcentaje

You:  "¿Cuáles son los límites de presupuesto para el proyecto Mobile App?"
AI:   Llama a budget action=get
      → devuelve configuración del presupuesto incluyendo umbrales

Actualizar presupuesto

La acción update modifica la configuración del presupuesto — ajustando presupuestos totales, cambiando moneda o configurando umbrales de alerta. Uses esta acción cuando se aprueben cambios de presupuesto o necesites reconfigurar parámetros financieros.

You:  "Aumenta el presupuesto del proyecto Backend a $150,000"
AI:   Llama a budget action=update total_budget=150000
      → confirma actualización del presupuesto con nuevo monto

You:  "Configura una alerta al 80% de utilización del presupuesto"
AI:   Llama a budget action=update alert_threshold=80
      → configura umbral de alerta al 80%

You:  "Cambia la moneda del proyecto a EUR"
AI:   Llama a budget action=update currency="EUR"
      → actualiza la moneda del proyecto

Resumen de presupuesto

La acción summary genera un resumen financiero completo con métricas calculadas — tasas de consumo, pronósticos de completitud, ratios de costo por tarea y análisis de tendencias. Es la vista ejecutiva de las finanzas del proyecto.

You:  "Dame un resumen financiero del proyecto Backend"
AI:   Llama a budget action=summary
      → devuelve resumen detallado con tasas de consumo y tendencias

You:  "¿Cómo es nuestro ritmo de gasto?"
AI:   Llama a budget action=summary
      → la IA destaca la tasa de consumo y la comparación con lo planificado

You:  "¿Cuál es el costo por tarea de nuestro proyecto?"
AI:   Llama a budget action=summary
      → la IA calcula costo promedio por tarea completada

Alertas de presupuesto

La acción alerts recupera alertas de presupuesto activas y configuración de umbrales. Las alertas se activan cuando el gasto se acerca o excede los umbrales configurados, proporcionando advertencia temprana de la presión financiera.

You:  "¿Hay alguna alerta de presupuesto?"
AI:   Llama a budget action=alerts
      → devuelve alertas activas con niveles de severidad

You:  "¿Estamos cerca de algún límite de presupuesto?"
AI:   Llama a budget action=alerts
      → la IA reporta proximidad a umbrales con porcentajes

You:  "¿Qué alertas de presupuesto se activaron este mes?"
AI:   Llama a budget action=alerts
      → devuelve alertas activadas con marcas de tiempo y detalles

Proyectos en riesgo

La acción at_risk opera a nivel de workspace — identifica todos los proyectos que están en riesgo de exceder sus presupuestos. Esto es esencial para supervisión de portafolio y planificación de asignación de recursos.

You:  "¿Qué proyectos están en riesgo de pasarse del presupuesto?"
AI:   Llama a budget action=at_risk
      → devuelve lista de proyectos en riesgo con evaluaciones de riesgo

You:  "Muéstrame los proyectos que necesitan atención en el presupuesto"
AI:   Llama a budget action=at_risk
      → la IA clasifica proyectos por severidad del riesgo presupuestario

You:  "¿Algún proyecto en rojo?"
AI:   Llama a budget action=at_risk
      → la IA identifica proyectos que exceden presupuesto o están en estado crítico

Previsión presupuestaria

La acción forecast genera pronósticos de gasto basados en tendencias actuales — proyectando cuándo se agotará el presupuesto, gasto estimado al completar y escenarios con diferentes tasas de gasto.

You:  "¿Cuándo se agotará nuestro presupuesto?"
AI:   Llama a budget action=forecast
      → devuelve fecha proyectada de agotamiento basada en tasa de consumo actual

You:  "¿Terminará el proyecto dentro del presupuesto?"
AI:   Llama a budget action=forecast
      → la IA compara gasto proyectado al completar vs presupuesto total

You:  "¿Cuánto gastaremos para el fin de trimestre?"
AI:   Llama a budget action=forecast
      → la IA proyecta gasto para la fecha objetivo

You:  "¿Qué pasa si nuestro ritmo de gasto aumenta un 20%?"
AI:   Llama a budget action=forecast
      → la IA modela escenario con tasa de consumo aumentada

Flujo de supervisión financiera

Los datos de presupuesto son más accionables cuando se combinan con el contexto del proyecto. Así es como usar las acciones de presupuesto para supervisión financiera integral:

Revisión financiera semanal

You:  "Prepara una revisión financiera semanal"
AI:   1. Llama a budget action=summary → métricas financieras actuales
      2. Llama a budget action=alerts → alertas activas
      3. Llama a budget action=forecast → gasto proyectado
      → "Revisión semanal: 67% del presupuesto utilizado, tasa de consumo $12K/semana.
         El pronóstico muestra que el presupuesto se agotará 2 semanas antes de la fecha prevista.
         Acción sugerida: Revisar asignación de recursos."

Evaluación de salud del portafolio

You:  "¿Cómo están todos los presupuestos de los proyectos?"
AI:   1. Llama a budget action=at_risk → identifica proyectos en riesgo
      2. Llama a budget action=get para cada proyecto en riesgo → detalles
      → "8 proyectos activos: 5 en camino, 2 acercándose al umbral (85%+),
         1 excedido en un 12%. El proyecto API necesita atención inmediata."

Planificación de presupuesto para nuevos sprints

You:  "¿Tenemos presupuesto para otro sprint?"
AI:   1. Llama a budget action=summary → presupuesto restante
      2. Llama a budget action=forecast → costo del sprint estimado
      3. Llama a analytics report="velocity" → entrega esperada
      → "Restante: $34K. Costo promedio por sprint: $15K.
         Puedes financiar 2 sprints más a la velocidad actual.
         Se recomienda reserva de $4K para contingencias."

Soporte de monedas

Los presupuestos de GitScrum soportan múltiples monedas. El campo currency usa códigos estándar ISO 4217:

CódigoMoneda
USDDólar estadounidense
EUREuro
GBPLibra esterlina
BRLReal brasileño
CADDólar canadiense
AUDDólar australiano

Todos los montos monetarios en las respuestas de la API incluyen el código de moneda para evitar ambigüedad en presupuestos de equipos internacionales.


Próximos pasos

  • Analíticas: Combina datos financieros con métricas de rendimiento del proyecto.
  • Seguimiento de tiempo: Da seguimiento al tiempo que alimenta los cálculos de presupuesto.
  • Clientes: Gestiona clientes cuyas facturas se conectan con los presupuestos.
  • Facturas: Crea facturas basadas en datos de presupuesto y seguimiento de tiempo.