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
| Action | Objectif | Paramètres requis |
|---|---|---|
list | Lister les propositions d'un workspace | company_slug |
get | Obtenir les détails complets d'une proposition | uuid, company_slug |
stats | Obtenir les métriques du pipeline de propositions | company_slug |
create | Créer un nouveau brouillon de proposition | company_slug, title |
update | Modifier un brouillon de proposition | uuid, company_slug |
send | Envoyer une proposition au client (draft → sent) | uuid, company_slug |
approve | Marquer une proposition comme approuvée (sent → approved) | uuid, company_slug |
reject | Marquer une proposition comme refusée | uuid, company_slug |
convert | Convertir une proposition approuvée en projet | uuid, 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ètre | Type | Description |
|---|---|---|
company_slug | string | Identifiant du workspace (depuis l'outil workspace) |
Paramètres optionnels
| Paramètre | Type | Description |
|---|---|---|
status | string | Filtrer par statut : draft, sent, approved, rejected |
client_uuid | string | Filtrer 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 dateObtenir 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ètre | Type | Description |
|---|---|---|
uuid | string | UUID de la proposition (depuis la réponse list) |
company_slug | string | Identifiant 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 currencyStatistiques 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ètre | Type | Description |
|---|---|---|
company_slug | string | Identifiant 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éesCré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ètre | Type | Description |
|---|---|---|
company_slug | string | Identifiant du workspace |
title | string | Titre de la proposition ou nom du projet |
Paramètres optionnels
| Paramètre | Type | Description |
|---|---|---|
contactcompanyuuid | string | UUID du client à associer (depuis l'outil client) |
content | string | Corps de la proposition en format Markdown — périmètre, livrables, planning |
total_amount | number | Valeur totale de la proposition (ex. 15000) |
currency | string | Code devise : USD, EUR, BRL (par défaut : devise du workspace) |
valid_until | string | Date 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_uuidMettre à 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ètre | Type | Description |
|---|---|---|
uuid | string | UUID de la proposition |
company_slug | string | Identifiant 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ètre | Type | Description |
|---|---|---|
uuid | string | UUID de la proposition |
company_slug | string | Identifiant 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 chacunApprouver 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ètre | Type | Description |
|---|---|---|
uuid | string | UUID de la proposition |
company_slug | string | Identifiant 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 projetRefuser 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ètre | Type | Description |
|---|---|---|
uuid | string | UUID de la proposition |
company_slug | string | Identifiant du workspace |
Paramètres optionnels
| Paramètre | Type | Description |
|---|---|---|
reason | string | Raison 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 RejectedConvertir 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ètre | Type | Description |
|---|---|---|
uuid | string | UUID de la proposition (doit être en statut Approved) |
company_slug | string | Identifiant 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 projetWorkflow 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 Markdown2. 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 date3. 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ée4. 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 client5. 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 coursProchaines é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.