Tous les articles
Suivi des développeurs8 min de lecture

Les métriques des développeurs dans votre entrepôt de données : une clé, deux appels MCP

Pour une équipe data : comment charger les statistiques par développeur dans un entrepôt ou un outil de BI avec une clé d'« Outil de données ». La requête et son en-tête, stats_schema puis stats_query, le plafond de lignes, le curseur, et ce qu'il faut relire à chaque passage, sous la forme de la trace d'un appel.

L'équipe DeployIt

Nous construisons DeployIt, un serveur MCP qui permet à toute une entreprise d'interroger son code depuis Claude et de suivre le travail de chaque développeur.

Pour charger les métriques des développeurs dans un entrepôt de données, DeployIt donne à la machine un profil à elle : un administrateur crée une clé d'« Outil de données », dpk_… ; votre tâche l'envoie dans un en-tête, appelle stats_schema puis stats_query, et suit le curseur pour lire toutes les lignes. La clé lit les statistiques en masse. Elle n'ouvre aucune question sur le code.

Cette page s'adresse à l'équipe data à qui l'on demande de mettre le travail de chaque développeur à côté des autres chiffres de l'entreprise. Elle suit un chargement, de la première requête à la dernière page : la trace d'un appel.

Que lit une personne dans Claude, et que lit l'entrepôt ?

Les mêmes faits. Voici la personne.

Dans votre Claude · exemple

Fais-moi le suivi d'octobre, développeur par développeur.

Voici octobre, développeur par développeur. La note du code se lit avec le nombre de commits qu'elle résume.

DéveloppeurCommits livrésRelusTestésNote du code
Camille R.4671 %52 %3,9
Idriss B.3860 %31 %3,2
Léa M.3566 %40 %4,1
Tiré de vos commits119 commits intégrés · données d'exemple

Une personne du profil « Direction » demande. Claude fait deux appels d'outils, stats_schema puis stats_query, et compose le tableau. Un entrepôt fait les deux mêmes appels, sans personne et sans Claude.

DeployIt n'a pas de tableau de bord et n'envoie aucun rapport par e-mail. Si vous voulez ces chiffres sur vos propres graphiques, c'est le chemin.

Comment les métriques des développeurs arrivent-elles dans l'entrepôt de données ?

En quatre étapes. Les blocs de code sont la trace des appels ; leurs valeurs sont des exemples.

1. Présenter la clé

POST https://mcp.deployit.ai/acme
Authorization: Bearer dpk_…

Un entrepôt ou un outil de BI ne s'inscrit pas. Il présente une clé d'« Outil de données », créée par un administrateur et montrée une seule fois, dans un en-tête. acme tient la place de votre entreprise.

Le corps de chaque requête est un message MCP. La spécification du protocole dit qu'un client envoie chaque message JSON-RPC par un POST HTTP, avec un en-tête Accept qui liste application/json et text/event-stream, et qu'une session commence par un échange d'initialisation (modelcontextprotocol.io, vérifié le 17/11/2026). Une bibliothèque cliente MCP s'en charge. Les deux appels qui comptent viennent ensuite.

2. Lire le contrat : stats_schema

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": { "name": "stats_schema", "arguments": {} }
}

Il ne reçoit rien. Il rend les jeux de statistiques, la définition de chaque mesure, et l'heure du dernier calcul. Pour les colonnes de chaque jeu et pour les limites, il fait foi : construisez votre correspondance d'après sa réponse, pas d'après un article.

Les jeux de données, tels que la documentation les liste :

JeuUne ligne, c'est
commitsUn commit intégré : son auteur, sa date d'arrivée, sa PR, ses tests, son ticket, son module, sa note et ses cinq critères
pull_requestsUne PR : qui l'a ouverte, qui l'a relue, en combien de temps
reviewsUne relecture : qui a relu quelle PR, et son verdict
defectsUn défaut : le commit d'origine, son correctif, qui a corrigé, « confirmé » ou « à confirmer »
peopleUne personne suivie, ou un agent de code
absencesUne plage d'absence déclarée pour une personne
repositoriesUn dépôt couvert, sa branche d'arrivée, l'heure de son dernier calcul
module_ownershipQui a écrit chaque module sur les 12 derniers mois
person_period, team_periodLes synthèses par développeur et par équipe, au mois, au trimestre, au semestre ou à l'année

3. Demander des lignes : stats_query

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "stats_query",
    "arguments": {
      "dataset": "commits",
      "period": { "unit": "month", "value": "2026-10" },
      "limit": 5000
    }
  }
}

Une requête est structurée : un jeu de données, une période, des filtres, des regroupements, des mesures, une limite. Jamais du SQL libre. Le SQL est le vôtre, ensuite, dans votre entrepôt.

Le même outil peut agréger au lieu de lister. Ses arguments nomment alors filtres, regroupements et mesures :

{
  "dataset": "commits",
  "period": { "unit": "quarter", "value": "2026-Q3" },
  "filters": [{ "field": "repository", "op": "eq", "value": "acme/billing" }],
  "group_by": ["person"],
  "measures": ["commits", "code_note"]
}

Quand vous demandez la note du code, gardez dans la colonne voisine le nombre de commits qu'elle résume. La note est une moyenne. Elle ne se lit jamais seule.

4. Lire la réponse, suivre le curseur

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "structuredContent": {
      "dataset": "commits",
      "rows": [{ "…": "un objet par commit intégré" }],
      "next_cursor": "eyJ2IjoxLCJoIjoi…",
      "computed_at": "2026-11-17T02:12:44Z"
    }
  }
}

Cette réponse est abrégée. Une requête de statistiques rend 5 000 lignes au plus (500 pour le profil « Direction ») et répond en 10 secondes au plus ; au-delà, suivez le curseur ou découpez par période. Suivre le curseur, c'est renvoyer la même requête avec le curseur reçu :

{
  "dataset": "commits",
  "period": { "unit": "month", "value": "2026-10" },
  "limit": 5000,
  "cursor": "eyJ2IjoxLCJoIjoi…"
}

Arrêtez-vous quand aucun curseur ne revient. Une clé d'outil de données peut faire 600 appels par minute. Ces chiffres sont dans les limites de la documentation, et la clé est décrite dans brancher un outil de données.

À quelle fréquence charger, et que faut-il relire ?

Les statistiques sont des faits écrits une fois par commit intégré, mis à jour chaque nuit. Un chargement par jour suffit. Ce que vous rechargez compte plus que la fréquence.

Ce que dit la documentationCe que cela veut dire pour votre chargement
Un commit peut changer après coup : un défaut se révèle dans les 60 joursRelisez au moins les 60 derniers jours à chaque passage ; faites un upsert sur le commit, pas un ajout
Une période close peut encore bouger : un commit arrivé tard, deux identités réunies, un défaut écartéNe figez pas un mois clos ; gardez l'heure du dernier calcul de chaque synthèse
Un commit daté d'avant mais intégré ce mois-ci compte pour ce mois-ciDatez vos faits par l'arrivée sur la branche d'arrivée, pas par la date d'écriture
Les robots sont exclus ; les agents de code détectés sont comptés à part ; un agent non déclaré compte comme travail humainSéparez personnes et agents dans vos modèles
La note du code est une moyenneRangez à côté le nombre de commits qu'elle résume

Pourquoi un défaut demande ces 60 jours, et ce que veut dire « à confirmer » tant que personne n'a tranché : c'est dans comment un correctif retrouve le commit qu'il répare. Les règles de lecture elles-mêmes sont dans la partie statistiques de la documentation.

Que ne peut pas faire une clé d'outil de données ?

  • Poser une question sur le code. ask_code et recent_changes sont pour les personnes : les profils « Tout le monde », « Développeurs » et « Direction ». La clé sert à stats_schema et à stats_query.
  • Écrire. Aucun outil ne modifie vos dépôts ni vos réglages, et chaque appel est inscrit au journal de votre entreprise.
  • Attendre qu'on lui envoie. DeployIt n'envoie ni rapport par e-mail, ni webhook sortant. C'est votre tâche qui vient lire.
  • Fonctionner sans forfait. Sans forfait ni essai, une clé d'outil de données reçoit un refus. Les statistiques sont gardées 24 mois par défaut (12, 24, ou tant que l'entreprise existe) : si vous comptez arrêter, exportez tant que le forfait ou l'essai court.

Ce que la clé transporte, en revanche : des noms. Les statistiques portent le nom de chaque développeur et le détail de son travail, modules et chemins compris. Les tables que vous chargez sont des données personnelles sur les personnes que votre entreprise suit.

Donnez-leur le public que vous donneriez au profil « Direction » ; la page confidentialité dit aux développeurs suivis que l'outil de données branché par leur employeur lit leurs statistiques. Traitez la clé comme un secret : elle n'est montrée qu'une fois.

Sans besoin de graphique, les mêmes faits arrivent en tableau dans Claude : voir le suivi mensuel des développeurs, ou quels modules reposent sur un seul développeur.

Ce que fait DeployIt ici

DeployIt est un serveur MCP. Votre entreprise a un lien, https://mcp.deployit.ai/<entreprise>/<code> ; chacun l'ajoute à son Claude (web, bureau ou Claude Code) et s'inscrit avec un nom et un e-mail, qui n'est pas vérifié ; ses questions sont journalisées sous ce nom. Tout le monde commence avec le profil « Tout le monde » : des questions sur le produit, répondues depuis le code ; un filtre retire des réponses le code, les chemins de fichiers et les noms des membres de l'équipe qu'il reconnaît, sans prouver leur absence, et un test de fuite vous dit ce qui passe encore. Un administrateur donne le profil « Développeurs » (des extraits) ou « Direction » (les statistiques des développeurs) à qui en a besoin. Les dépôts se connectent depuis GitHub ou GitLab ; DeployIt n'y fait ni commit, ni branche, ni PR, et y pose seulement un webhook par dépôt.

Une copie de travail du code est gardée tant que le dépôt est connecté, chez DigitalOcean à Londres (Royaume-Uni) ; à l'indexation, chaque fichier source est envoyé au modèle pour en écrire un résumé, puis les passages utiles à une réponse et le diff des commits notés ; chez OpenAI par défaut, ou chez le fournisseur dont vous apportez la clé.

Les quatre profils et le reste du produit sont dans ce que fait DeployIt, en une page.

Prochaine étape : pendant l'essai, demandez à un administrateur de créer une clé d'« Outil de données », appelez stats_schema, et chargez un mois de commits dans une table de brouillon : assez pour voir si le grain convient à vos modèles.

Prix. Plan gratuit : 15 questions par semaine pour toute l'entreprise. Essai de 30 jours, sans carte. Forfaits à partir de 290 € HT par mois pour 25 développeurs suivis : voir le tarif.

Interrogez votre code depuis Claude

Essai de 30 jours, sans carte. Ou essayez d'abord la démonstration : ajoutez https://mcp.deployit.ai/demo aux connecteurs de votre Claude.

Connecter mon code

Questions fréquentes

Comment charger les métriques des développeurs dans un entrepôt de données ?

Avec DeployIt, un administrateur crée une clé d'« Outil de données », montrée une seule fois. Votre tâche la présente dans un en-tête, appelle l'outil stats_schema pour lire les jeux de données et leurs définitions, puis stats_query pour lire les lignes, en suivant le curseur jusqu'à ce qu'il n'y en ait plus. La clé lit les statistiques en masse et n'ouvre aucune question sur le code.

Peut-on interroger les statistiques des développeurs en SQL ?

Pas du côté de DeployIt : stats_query est une requête structurée, faite d'un jeu de données, d'une période, de filtres, de regroupements, de mesures et d'une limite, jamais du SQL libre. Une fois les lignes dans votre entrepôt, le SQL est le vôtre. L'outil stats_schema fait foi pour les colonnes et les mesures que vous pouvez demander.

Combien de lignes rend une requête de statistiques ?

5 000 lignes au plus avec une clé d'« Outil de données » (500 pour le profil « Direction »), en 10 secondes au plus. Au-delà, suivez le curseur ou découpez la requête par période. Une clé d'outil de données peut faire 600 appels par minute.

À quelle fréquence recharger les statistiques dans l'entrepôt ?

Les statistiques sont mises à jour chaque nuit : un chargement par jour suffit. Relisez au moins les 60 derniers jours à chaque passage, car un commit peut changer après coup : un défaut se révèle dans les 60 jours. Une période close peut aussi bouger, et chaque synthèse porte l'heure de son dernier calcul.

Une clé d'outil de données peut-elle lire le code source ?

La clé n'ouvre aucune question sur le code : elle sert aux outils de statistiques, pas à ask_code. Les statistiques portent en revanche le détail, noms des développeurs, modules et chemins compris : les tables que vous chargez sont des données personnelles sur les personnes que votre entreprise suit. Un administrateur crée la clé, et elle n'est montrée qu'une fois.

Continuer la lecture

Connecter mon code