GitScrum / Docs

Propositions

Gestion des propositions via MCP. Créez, envoyez et gérez les propositions clients avec un suivi complet du cycle de vie, du brouillon à la conversion en projet.

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 proposal fournit 9 actions couvrant l'ensemble du cycle de vie des propositions — de la rédaction et l'envoi à l'approbation client, la gestion des refus et la conversion en projets actifs. Chaque opération de pipeline commercial disponible dans l'application web GitScrum est accessible par conversation en langage naturel avec votre assistant IA.

Les propositions font le lien entre le commercial et la livraison. Quand un client approuve une proposition, l'action convert la transforme en projet entièrement configuré, avec le périmètre, le budget et l'association client. Le serveur MCP donne à votre assistant IA la capacité de gérer l'ensemble du pipeline — qualifier les prospects, construire les propositions, conclure les affaires et lancer les projets — sans changer de contexte.


Vue d'ensemble des actions

ActionObjectifParamètres requis
listLister les propositions d'un workspacecompany_slug
getObtenir les détails complets d'une propositionuuid, company_slug
statsObtenir les métriques du pipeline de propositionscompany_slug
createCréer un nouveau brouillon de propositioncompany_slug, title
updateModifier un brouillon de propositionuuid, company_slug
sendEnvoyer une proposition au client (draft → sent)uuid, company_slug
approveMarquer une proposition comme approuvée (sent → approved)uuid, company_slug
rejectMarquer une proposition comme refuséeuuid, company_slug
convertConvertir une proposition approuvée en projetuuid, company_slug

Cycle de vie des statuts

Chaque proposition suit une progression de statut définie. Le serveur MCP applique les transitions valides — vous ne pouvez pas approuver un brouillon qui n'a pas été envoyé, et les propositions refusées ne peuvent pas être converties en projets.

  ┌───────┐      send      ┌──────┐     approve     ┌──────────┐    convert    ┌─────────┐
  │ Draft │ ──────────────► │ Sent │ ───────────────► │ Approved │ ────────────► │ Project │
  └───────┘                 └──────┘                  └──────────┘              └─────────┘
                                │
                                │     reject
                                ▼
                           ┌──────────┐
                           │ Rejected │
                           └──────────┘
  • Draft — État initial. Modifiable. Peut être envoyé.
  • Sent — Livré au client. En attente de réponse. Peut être approuvé ou refusé.
  • Approved — Client a accepté. Peut être converti en projet.
  • Rejected — Client a refusé. État terminal.
  • Converted — Transformé en projet actif. État terminal.

Lister les propositions

L'action list retourne les propositions d'un workspace. Filtrez par statut ou par client pour se concentrer sur des étapes spécifiques du pipeline.

Paramètres requis

ParamètreTypeDescription
company_slugstringIdentifiant du workspace (depuis l'outil workspace)

Paramètres optionnels

ParamètreTypeDescription
statusstringFiltrer par statut : draft, sent, approved, rejected
client_uuidstringFiltrer par UUID du client (depuis l'outil client)

Exemples de prompts

You:  "Affiche toutes les propositions"
AI:   Appelle proposal action=list → retourne la liste des propositions avec statuts et montants

You:  "Liste les propositions envoyées en attente de réponse"
AI:   Appelle proposal action=list avec status="sent"

You:  "Affiche toutes les propositions pour Acme Corp"
AI:   Trouve l'UUID du client → appelle proposal action=list avec client_uuid

You:  "Quelles propositions ont été refusées ce mois-ci ?"
AI:   Appelle proposal action=list avec status="rejected" → l'IA filtre par date

Obtenir les détails d'une proposition

L'action get retourne la proposition complète — titre, client, contenu, montant, devise, période de validité, statut et chronologie d'activité.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID de la proposition (depuis la réponse list)
company_slugstringIdentifiant du workspace
You:  "Montre-moi la proposition de refonte du site web"
AI:   Trouve la proposition → appelle proposal action=get → retourne les détails complets

You:  "Quelle est la valeur totale de la proposition TechStart ?"
AI:   Appelle proposal action=get → extrait total_amount et currency

Statistiques des propositions

L'action stats retourne les métriques du pipeline au niveau du workspace — total des propositions, taux de conversion, taille moyenne des affaires, valeur du pipeline par statut et ratios gains/pertes. Ces chiffres alimentent le tableau de bord du pipeline commercial.

Paramètres requis

ParamètreTypeDescription
company_slugstringIdentifiant du workspace
You:  "Affiche les statistiques des propositions"
AI:   Appelle proposal action=stats → retourne la valeur du pipeline, le taux de conversion, les métriques

You:  "Quel est notre taux de réussite des propositions ?"
AI:   Appelle proposal action=stats → extrait le ratio gains/pertes

You:  "Combien y a-t-il dans le pipeline ?"
AI:   Appelle proposal action=stats → retourne la valeur totale des propositions envoyées

Créer des propositions

L'action create génère un nouveau brouillon de proposition. Vous pouvez inclure l'association client, le contenu détaillé en format Markdown, les conditions financières et une période de validité en un seul appel.

Paramètres requis

ParamètreTypeDescription
company_slugstringIdentifiant du workspace
titlestringTitre de la proposition ou nom du projet

Paramètres optionnels

ParamètreTypeDescription
contactcompanyuuidstringUUID du client à associer (depuis l'outil client)
contentstringCorps de la proposition en format Markdown — périmètre, livrables, planning
total_amountnumberValeur totale de la proposition (ex. 15000)
currencystringCode devise : USD, EUR, BRL (par défaut : devise du workspace)
valid_untilstringDate d'expiration de la proposition au format YYYY-MM-DD

Exemples de prompts

You:  "Crée une proposition pour Acme Corp : Refonte du site web, 15 000 $, valide jusqu'au 30 mars"
AI:   Trouve l'UUID du client → appelle proposal action=create avec title="Refonte du site web",
      contact_company_uuid, total_amount=15000, currency="USD",
      valid_until="2026-03-30"

You:  "Rédige une proposition pour TechStart — Développement d'application mobile, 25 000 €"
AI:   Appelle proposal action=create avec title="Développement d'application mobile",
      contact_company_uuid, total_amount=25000, currency="EUR"

You:  "Crée une proposition pour Global Media avec un périmètre détaillé :
       ## Livrables
       - Refonte de l'identité visuelle
       - Site web (10 pages)
       - Templates pour les réseaux sociaux
       Total : 8 500 $"
AI:   Appelle proposal action=create avec title, content (Markdown),
      total_amount=8500, contact_company_uuid

Mettre à jour les propositions

L'action update modifie un brouillon de proposition. Seules les propositions en statut Draft peuvent être modifiées — une fois envoyée, la proposition est verrouillée pour préserver l'historique de ce qui a été présenté au client.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID de la proposition
company_slugstringIdentifiant du workspace

Tous les paramètres optionnels de create sont disponibles dans update.

You:  "Mets à jour le montant de la proposition du site web à 18 000 $"
AI:   Appelle proposal action=update avec total_amount=18000

You:  "Prolonge la validité de la proposition jusqu'au 15 avril"
AI:   Appelle proposal action=update avec valid_until="2026-04-15"

You:  "Ajoute le détail du périmètre à la proposition TechStart"
AI:   Appelle proposal action=update avec content (Markdown)

Envoyer les propositions

L'action send fait passer une proposition de Draft à Sent. Cela livre la proposition au client et la verrouille contre toute modification ultérieure. Le changement de statut est enregistré avec un horodatage.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID de la proposition
company_slugstringIdentifiant du workspace
You:  "Envoie la proposition de refonte du site web à Acme Corp"
AI:   Appelle proposal action=send → la proposition passe de Draft à Sent

You:  "Envoie tous les brouillons de propositions"
AI:   Liste les brouillons → appelle proposal action=send pour chacun

Approuver les propositions

L'action approve marque une proposition envoyée comme approuvée par le client. Cela débloque l'action convert, qui transforme la proposition en projet.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID de la proposition
company_slugstringIdentifiant du workspace
You:  "Acme Corp a approuvé la proposition de refonte du site web"
AI:   Appelle proposal action=approve → la proposition passe en Approved

You:  "Marque la proposition TechStart comme approuvée"
AI:   Appelle proposal action=approve → prête pour la conversion en projet

Refuser les propositions

L'action reject marque une proposition envoyée comme refusée. Vous pouvez optionnellement fournir la raison du refus du client, qui est stockée dans l'historique de la proposition pour l'analyse du pipeline.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID de la proposition
company_slugstringIdentifiant du workspace

Paramètres optionnels

ParamètreTypeDescription
reasonstringRaison du refus du client (stockée dans l'historique de la proposition)
You:  "Global Media a refusé la proposition — contraintes budgétaires"
AI:   Appelle proposal action=reject avec reason="Contraintes budgétaires"

You:  "Marque la proposition d'application mobile comme refusée"
AI:   Appelle proposal action=reject → la proposition passe en Rejected

Convertir les propositions en projets

L'action convert est le pont entre le commercial et la livraison. Elle transforme une proposition approuvée en projet entièrement configuré, avec le titre, l'association client et le périmètre. C'est le moment où une affaire devient un travail actif.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID de la proposition (doit être en statut Approved)
company_slugstringIdentifiant du workspace
You:  "Convertis la proposition d'Acme Corp en projet"
AI:   Appelle proposal action=convert → crée le projet lié au client

You:  "Approuve et convertis la proposition TechStart"
AI:   Appelle proposal action=approve → puis appelle proposal action=convert

You:  "La refonte du site web est validée — mets en place le projet"
AI:   Trouve la proposition approuvée → appelle proposal action=convert → retourne le nouveau projet

Workflow du pipeline commercial

Pour les agences gérant leur pipeline commercial via MCP, ce workflow couvre l'ensemble du cycle de vie des propositions :

1. Créer la proposition

Rédigez une proposition avec le périmètre, les tarifs et l'association client.

You:  "Crée une proposition pour Acme Corp : Plateforme e-commerce, 45 000 $,
       valide jusqu'au 30 mars. Inclure le périmètre : design, développement, QA, déploiement."
AI:   Un seul appel create avec tous les champs et le contenu Markdown

2. Vérifier et affiner

Vérifiez le brouillon avant de le présenter au client.

You:  "Montre-moi la proposition d'Acme Corp"
AI:   Appelle proposal action=get → affiche la proposition complète pour vérification

You:  "Augmente le montant à 48 000 $ et prolonge la validité jusqu'au 15 avril"
AI:   Appelle proposal action=update avec le nouveau montant et la date

3. Envoyer au client

Livrez la proposition.

You:  "Envoie la proposition e-commerce à Acme Corp"
AI:   Appelle proposal action=send → la proposition est livrée et verrouillée

4. Gérer la réponse

Enregistrez la décision du client.

You:  "Acme Corp a approuvé la proposition"
AI:   Appelle proposal action=approve → prête pour la conversion

You:  "Convertis-la en projet"
AI:   Appelle proposal action=convert → projet créé et lié au client

5. Suivre le pipeline

Surveillez la santé globale du pipeline commercial.

You:  "Montre-moi le pipeline de propositions"
AI:   Appelle proposal action=stats → résume la valeur du pipeline, les taux de conversion, gains/pertes

You:  "Quelles propositions sont encore en attente de réponse ?"
AI:   Appelle proposal action=list avec status="sent" → affiche les propositions en cours

Prochaines étapes

  • Clients : Gérez les fiches clients liées à vos propositions.
  • Factures : Créez des factures pour les propositions approuvées et converties.
  • Tableaux de bord ClientFlow : Accédez aux analyses du pipeline et métriques de conversion.
  • Projets : Gérez la livraison des projets après conversion des propositions.