Clients

Gestion des clients via MCP. Créez, gérez et suivez les relations clients avec des fonctionnalités CRM complètes pour les agences et prestataires de services.

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 client fournit 5 actions pour gérer les relations clients au sein du ClientFlow CRM de GitScrum. Les agences, cabinets de conseil et prestataires de services utilisent cet outil pour maintenir une base de données clients centralisée, connectée directement aux projets, propositions et factures. Chaque opération disponible dans l'application web GitScrum — créer des contacts, mettre à jour des informations, consulter les métriques du portefeuille — est accessible par conversation en langage naturel avec votre assistant IA.

Les clients sont la base du ClientFlow CRM. Une fois qu'un enregistrement client existe, il peut être lié à des projets pour le suivi des livrables, à des propositions pour la gestion du pipeline commercial, et à des factures pour l'automatisation de la facturation. Le serveur MCP donne à votre assistant IA la capacité de gérer l'ensemble du cycle de vie client sans changer de contexte.

Vue d'ensemble des actions

Action	Objectif	Paramètres requis
`list`	Lister tous les clients d'un workspace	`company_slug`
`get`	Obtenir les détails complets d'un client	`uuid`, `company_slug`
`create`	Créer un nouvel enregistrement client	`company_slug`, `name`
`update`	Modifier les détails d'un client	`uuid`, `company_slug`
`stats`	Obtenir les métriques globales des clients du workspace	`company_slug`

Lister les clients

L'action list retourne tous les clients d'un workspace. Vous pouvez filtrer par statut et paginer les résultats. Chaque client dans la réponse inclut son uuid, requis pour toutes les opérations spécifiques et pour lier les clients aux projets, propositions et factures.

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 : `active`, `inactive`, `archived`
`page`	number	Numéro de page pour la pagination
`per_page`	number	Résultats par page (la valeur par défaut varie selon le plan du workspace)

Exemples de prompts

You:  "Affiche tous mes clients"
AI:   Appelle client action=list → retourne la liste des clients avec UUIDs, noms et statuts

You:  "Liste uniquement les clients actifs"
AI:   Appelle client action=list avec status="active"

You:  "Affiche la deuxième page de clients"
AI:   Appelle client action=list avec page=2

Obtenir les détails d'un client

L'action get retourne l'enregistrement client complet — nom, coordonnées, informations sur l'entreprise, projets associés, propositions liées, historique de facturation et chronologie d'activité. C'est la vue complète du profil client.

Paramètres requis

Paramètre	Type	Description
`uuid`	string	UUID du client (depuis la réponse `list` ou toute référence client)
`company_slug`	string	Identifiant du workspace

You:  "Montre-moi les détails d'Acme Corp"
AI:   Trouve le client par nom → appelle client action=get → retourne le profil client complet

You:  "Quelles sont les coordonnées de notre client TechStart ?"
AI:   Appelle client action=get → extrait l'email, le téléphone et l'adresse

Créer des clients

L'action create ajoute un nouvel enregistrement client au workspace. Tous les champs de contact et d'entreprise peuvent être définis lors de la création en un seul appel — aucune mise à jour ultérieure nécessaire.

Paramètres requis

Paramètre	Type	Description
`company_slug`	string	Identifiant du workspace
`name`	string	Nom du contact client

Paramètres optionnels

Paramètre	Type	Description
`email`	string	Adresse email du client
`phone`	string	Numéro de téléphone du client
`company_name`	string	Nom de l'entreprise ou organisation du client
`website`	string	URL du site web du client
`address`	string	Adresse physique du client
`notes`	string	Notes internes sur le client (non visibles par le client)

Exemples de prompts

You:  "Ajoute un nouveau client 'Acme Corp' avec l'email contact@acme.com"
AI:   Appelle client action=create avec name="Acme Corp", email="contact@acme.com"

You:  "Crée une fiche client pour John Smith chez TechStart, téléphone 555-0100,
       site web techstart.io"
AI:   Appelle client action=create avec name="John Smith", company_name="TechStart",
      phone="555-0100", website="techstart.io"

You:  "Ajoute le client 'Global Media' avec une note : 'Recommandé par Sarah, préfère le contact par email'"
AI:   Appelle client action=create avec name="Global Media",
      notes="Recommandé par Sarah, préfère le contact par email"

Mettre à jour les clients

L'action update modifie n'importe quel champ d'un enregistrement client existant. Seuls les champs spécifiés sont modifiés — tous les autres restent inchangés. Utile pour mettre à jour les coordonnées, ajouter des notes ou corriger des informations.

Paramètres requis

Paramètre	Type	Description
`uuid`	string	UUID du client
`company_slug`	string	Identifiant du workspace

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

Exemples de prompts

You:  "Mets à jour l'email d'Acme Corp en hello@acme.com"
AI:   Trouve le client → appelle client action=update avec email="hello@acme.com"

You:  "Ajoute une note à Global Media : 'Contrat renouvelé pour le T2'"
AI:   Appelle client action=update avec notes="Contrat renouvelé pour le T2"

You:  "Change le site web de TechStart en www.techstart.com"
AI:   Appelle client action=update avec website="www.techstart.com"

Statistiques clients

L'action stats retourne les métriques clients au niveau du workspace — nombre total de clients, répartition actifs/inactifs, revenu par client, distribution des projets et tendances d'engagement. Ce sont les chiffres qui alimentent le tableau de bord ClientFlow CRM.

Paramètres requis

Paramètre	Type	Description
`company_slug`	string	Identifiant du workspace

You:  "Affiche les statistiques clients"
AI:   Appelle client action=stats → retourne le nombre total de clients, les actifs, les métriques de revenu

You:  "Combien de clients actifs avons-nous ?"
AI:   Appelle client action=stats → extrait le nombre de clients actifs

You:  "Montre-moi la vue d'ensemble des clients de mon agence"
AI:   Appelle client action=stats → résume la santé du portefeuille client

Workflow CRM

Les clients sont connectés à chaque partie de l'écosystème ClientFlow CRM. Voici comment l'outil client s'intègre aux autres outils pour un workflow d'agence complet :

1. Enregistrer le client

Commencez par créer une fiche client avec toutes les coordonnées pertinentes.

You:  "Ajoute un nouveau client 'Acme Corp', email contact@acme.com, nom d'entreprise 'Acme Corporation',
       site web acme.com. Note : Compte entreprise, 50+ employés"
AI:   Appelle client action=create → retourne l'UUID du client pour le lier

2. Créer une proposition

Utilisez l'UUID du client pour créer une proposition liée à ce client.

You:  "Crée une proposition pour Acme Corp : Refonte du site web, 15 000 $"
AI:   Trouve l'UUID du client → appelle proposal action=create avec contact_company_uuid

3. Convertir en projet

Lorsque la proposition est approuvée, convertissez-la en projet actif.

You:  "Approuve la proposition d'Acme Corp et convertis-la en projet"
AI:   Appelle proposal action=approve → appelle proposal action=convert

4. Facturer le travail

Générez des factures liées au client pour la facturation.

You:  "Crée une facture pour Acme Corp, 5 000 $ pour la livraison de la Phase 1"
AI:   Appelle invoice action=create avec client_uuid → brouillon de facture prêt à envoyer

5. Suivre la relation

Surveillez la santé du client via les statistiques et tableaux de bord.

You:  "Montre-moi la vue d'ensemble des clients"
AI:   Appelle client action=stats → résume les métriques du portefeuille

Lier les clients aux projets

Lors de la création d'un projet via l'outil project, vous pouvez passer l'UUID du client comme paramètre client_uuid. Cela lie le projet à la fiche client, permettant :

Listes de projets par client
Attribution du revenu par client
Accès au portail client (si configuré)
Reporting consolidé sur tous les projets du client

You:  "Crée un projet 'Refonte du site Acme' lié à Acme Corp"
AI:   Trouve l'UUID du client → appelle project action=create avec client_uuid

Prochaines étapes

Factures : Créez et gérez les factures de vos clients.
Propositions : Construisez et envoyez des propositions pour convertir les prospects en projets.
Tableaux de bord ClientFlow : Accédez aux analyses CRM et rapports inter-workspaces.
Projets : Gérez la livraison des projets pour vos clients.