GitScrum / Docs

Budget

Suivi et gestion du budget via MCP. Surveillez les budgets de projets, suivez les dépenses, identifiez les projets à risque et générez des alertes financières.

Open Source — GitScrum MCP Server est open source sous la licence MIT. Disponible sur npm et sur GitHub. Serveur Model Context Protocol pour GitScrum — Claude, GitHub Copilot, Cursor et tout client compatible MCP disposent d'un accès opérationnel complet à votre stack de gestion de projets.

L'outil budget fournit 6 actions pour suivre et gérer les budgets de projets directement via votre assistant IA. Surveillez les dépenses par rapport aux allocations, recevez des alertes lorsque les budgets approchent des seuils, identifiez les projets à risque avant qu'ils ne dépassent les limites et générez des prévisions financières — le tout sans quitter votre IDE ou client IA.

La gestion budgétaire dans GitScrum connecte les données financières aux métriques de livraison. Combiné au suivi du temps et aux analytics, l'outil budget donne aux équipes et aux managers une vision complète de l'économie du projet : combien a été planifié, combien est dépensé et si le projet est sur la bonne voie financièrement.


Aperçu des actions

ActionObjectifParamètres requis
getObtenir les détails budgétaires d'un projet spécifiquecompanyslug, projectslug
updateMettre à jour les paramètres budgétaires d'un projetcompanyslug, projectslug
summaryObtenir le résumé budgétaire de tous les projetscompany_slug
alertsObtenir les alertes budgétaires basées sur un seuilcompany_slug
at_riskObtenir les projets dépassant leur budgetcompany_slug
forecastObtenir la prévision budgétaire d'un projetcompanyslug, projectslug

Obtenir les détails budgétaires

L'action get récupère le statut budgétaire actuel d'un projet spécifique — budget total, montant dépensé, solde restant, devise et pourcentage d'utilisation. C'est l'action principale pour vérifier les finances d'un projet individuel.

Paramètres

ParamètreTypeDescription
company_slugstringIdentifiant de l'espace de travail (requis)
project_slugstringIdentifiant du projet (requis)
You:  "Quel est le statut budgétaire du projet Alpha ?"
AI:   Appelle budget action=get → retourne le budget total, dépensé, restant et % d'utilisation

You:  "Combien de budget reste-t-il sur le projet Backend ?"
AI:   Appelle budget action=get → "Projet Backend : 45 000 $ sur 120 000 $ dépensés.
       75 000 $ restants (37,5 % utilisés)"

You:  "Sommes-nous dans le budget sur le projet Mobile App ?"
AI:   Appelle budget action=get → l'IA compare dépensé vs. total et rapporte le statut

Mettre à jour les budgets

L'action update modifie les paramètres budgétaires d'un projet. Vous pouvez mettre à jour l'allocation budgétaire totale, enregistrer des dépenses ou changer la devise. Cela permet aux managers d'ajuster les budgets à mesure que le périmètre du projet évolue.

Paramètres requis

ParamètreTypeDescription
company_slugstringIdentifiant de l'espace de travail (requis)
project_slugstringIdentifiant du projet (requis)

Paramètres optionnels

ParamètreTypeDescription
total_budgetnumberAllocation budgétaire totale pour le projet
spentnumberMontant actuellement dépensé
currencystringCode de devise (ex. USD, EUR, BRL)
You:  "Fixe le budget du projet Backend à 150 000 $"
AI:   Appelle budget action=update avec total_budget=150000
      → "Budget mis à jour : projet Backend fixé à 150 000 $"

You:  "Mets à jour les dépenses du projet Mobile App à 67 500 $"
AI:   Appelle budget action=update avec spent=67500
      → "Budget mis à jour : dépenses Mobile App fixées à 67 500 $"

You:  "Change la devise du projet Alpha en EUR"
AI:   Appelle budget action=update avec currency="EUR"
      → "Budget mis à jour : devise du projet Alpha définie sur EUR"

You:  "Augmente le budget du projet Backend de 25 000 $"
AI:   Appelle budget action=get → le total actuel est de 150 000 $
      → Appelle budget action=update avec total_budget=175000
      → "Budget mis à jour : projet Backend augmenté à 175 000 $"

Résumé budgétaire

L'action summary retourne une vue consolidée du budget à travers tous les projets de l'espace de travail. Cela donne aux managers une vue unique des dépenses organisationnelles — total alloué, total dépensé, total restant et ventilation par projet.

Paramètres

ParamètreTypeDescription
company_slugstringIdentifiant de l'espace de travail (requis)
You:  "Montre-moi le résumé budgétaire de tous les projets"
AI:   Appelle budget action=summary → retourne la vue budgétaire globale de l'espace de travail

You:  "Combien avons-nous dépensé sur tous les projets ?"
AI:   Appelle budget action=summary → "Total dépensé : 234 500 $ sur 500 000 $ alloués
       sur 8 projets (46,9 % utilisés)"

You:  "Quel projet a le taux d'utilisation budgétaire le plus élevé ?"
AI:   Appelle budget action=summary → l'IA classe les projets par pourcentage d'utilisation

Alertes budgétaires

L'action alerts retourne les projets qui approchent ou dépassent un seuil de dépenses. Par défaut, elle signale les projets à 80 % d'utilisation, mais vous pouvez définir un seuil personnalisé correspondant à la tolérance au risque de votre organisation.

Paramètres

ParamètreTypeDescription
company_slugstringIdentifiant de l'espace de travail (requis)
thresholdnumberSeuil d'alerte en pourcentage (optionnel, défaut : 80)
You:  "Y a-t-il des alertes budgétaires ?"
AI:   Appelle budget action=alerts → retourne les projets au-dessus du seuil de 80 %

You:  "Fixe le seuil d'alerte budgétaire à 90 % et montre les alertes"
AI:   Appelle budget action=alerts avec threshold=90
      → retourne les projets au-dessus de 90 % d'utilisation

You:  "Quels projets approchent de leurs limites budgétaires ?"
AI:   Appelle budget action=alerts avec threshold=75
      → "3 projets au-dessus de 75 % : Mobile App (92 %), Backend (81 %), API v3 (78 %)"

You:  "Préviens-moi de tout projet dépassant 50 % d'utilisation budgétaire"
AI:   Appelle budget action=alerts avec threshold=50
      → retourne tous les projets dépassant la moitié de leur budget

Projets à risque

L'action at_risk identifie spécifiquement les projets ayant dépassé leur allocation budgétaire — les dépenses sont supérieures au budget total. C'est l'action d'alerte critique pour la supervision financière.

Paramètres

ParamètreTypeDescription
company_slugstringIdentifiant de l'espace de travail (requis)
You:  "Quels projets sont en dépassement de budget ?"
AI:   Appelle budget action=at_risk → retourne les projets dépassant leur allocation

You:  "Y a-t-il des projets en difficulté financière ?"
AI:   Appelle budget action=at_risk → "2 projets en dépassement de budget :
       - Mobile App : 98 000 $ dépensés sur 85 000 $ (115 %)
       - Legacy Migration : 42 000 $ dépensés sur 40 000 $ (105 %)"

You:  "Montre-moi les projets nécessitant une attention budgétaire immédiate"
AI:   Appelle budget action=at_risk → l'IA liste les projets en dépassement avec les montants excédentaires

Prévision budgétaire

L'action forecast projette les dépenses futures basées sur le taux de consommation actuel et le calendrier du projet. Elle estime si le projet restera dans le budget, quand le budget sera épuisé et le total projeté des dépenses à l'achèvement.

Paramètres

ParamètreTypeDescription
company_slugstringIdentifiant de l'espace de travail (requis)
project_slugstringIdentifiant du projet (requis)
You:  "Montre la prévision budgétaire du projet Backend"
AI:   Appelle budget action=forecast → retourne les dépenses projetées, l'estimation d'achèvement
       et la date d'épuisement du budget

You:  "Le projet Mobile App restera-t-il dans le budget ?"
AI:   Appelle budget action=forecast → "Au taux de consommation actuel de 12 000 $/semaine,
       le projet Mobile App dépassera son budget de 85 000 $ dans environ 2 semaines"

You:  "Quel est le coût total projeté pour le projet Alpha ?"
AI:   Appelle budget action=forecast → retourne le total estimé des dépenses à l'achèvement

Workflow de supervision financière

L'outil budget permet une gestion financière proactive. Voici un workflow typique pour les managers et chefs de projet :

1. Revue budgétaire hebdomadaire

Vérifiez la santé financière globale de tous les projets.

You:  "Donne-moi la vue d'ensemble budgétaire de cette semaine"
AI:   Appelle budget action=summary → instantané financier de l'espace de travail
      Appelle budget action=alerts → projets approchant les limites
      Appelle budget action=at_risk → projets déjà en dépassement
      → Rapport consolidé du statut financier

2. Investiguer les projets signalés

Approfondissez les projets ayant déclenché des alertes.

You:  "Pourquoi le projet Mobile App est-il en dépassement de budget ?"
AI:   Appelle budget action=get → ventilation budgétaire détaillée
      Appelle budget action=forecast → trajectoire projetée
      → "Mobile App est à 115 % d'utilisation. Au taux de consommation actuel,
         le projet nécessite 15 000 $ supplémentaires pour être complété"

3. Ajuster les budgets selon les besoins

Mettez à jour les allocations en fonction des résultats.

You:  "Augmente le budget Mobile App à 100 000 $"
AI:   Appelle budget action=update avec total_budget=100000
      → "Budget mis à jour. Mobile App maintenant à 98 % d'utilisation sur 100 000 $"

4. Définir des seuils de surveillance

Établissez des seuils d'alerte pour une détection précoce.

You:  "Alerte-moi quand un projet dépasse 70 % du budget"
AI:   Appelle budget action=alerts avec threshold=70
      → "5 projets au-dessus de 70 % : [liste avec pourcentages d'utilisation]"

Gestion budgétaire proactive

Combinez les données budgétaires avec d'autres outils MCP pour une économie de projet complète :

  • Budget + Suivi du temps. Comparez les coûts basés sur le temps avec l'utilisation budgétaire. Utilisez time action=reports avec les taux horaires conjointement à budget action=get pour vérifier que les heures facturables suivies correspondent aux enregistrements de dépenses.
  • Budget + Analytics. Corréllez les tendances de vélocité avec le taux de consommation. Si la vélocité décline tandis que les dépenses restent constantes, le coût par point augmente — un indicateur précoce de risque budgétaire.
  • Budget + Sprints. Divisez le budget total par les sprints restants pour calculer l'allocation budgétaire par sprint. Comparez avec les coûts réels de sprint dérivés des données de suivi du temps.
  • Budget + Activité. Surveillez les événements d'activité liés au budget pour suivre qui a autorisé les changements de dépenses et quand les budgets ont été ajustés pour la dernière fois.
You:  "Compare notre taux de consommation avec la vélocité pour le projet Backend"
AI:   Appelle budget action=get → données de dépenses
      Appelle analytics action=get report="velocity" → taux de livraison
      → "Le Backend dépense 15 000 $/sprint tout en livrant 32 points.
         Coût par point : 469 $. Le sprint précédent était à 521 $/point — augmentation de 11 %"

Support des devises

Les montants budgétaires supportent de multiples devises. Définissez la devise par projet en utilisant l'action update avec le paramètre currency. Tous les rapports budgétaires respectent la devise configurée du projet et affichent les montants en conséquence.

Les formats de devise supportés suivent les codes ISO 4217 : USD, EUR, GBP, BRL, CAD, AUD, JPY et d'autres supportés par la plateforme GitScrum.


Prochaines étapes

  • Analytics : Accédez aux rapports de santé et de performance du projet avec les données financières.
  • Activité : Surveillez les changements incluant les événements liés au budget.
  • Standup : Consultez la progression quotidienne de l'équipe avec l'utilisation budgétaire.
  • Suivi du temps : Suivez les heures facturables qui alimentent la consommation budgétaire.