Documentation : brancher DeployIt à votre Claude
Tout DeployIt tient en une page : se brancher, cinq outils, et comment lire une réponse.
Se brancher
Votre administrateur vous a donné le lien de votre entreprise. Il ressemble à ceci :
https://mcp.deployit.ai/acme/k7mq-x2pf-9tdrDans Claude
- Ouvrez Personnaliser, puis Connecteurs, et ajoutez un connecteur personnalisé. Sur un compte Team ou Enterprise, c'est un propriétaire qui l'ajoute une fois pour toute l'organisation, depuis Paramètres de l'organisation, puis Connecteurs ; chacun clique ensuite « Connecter ».
- Collez le lien. Claude ouvre une page de DeployIt : donnez votre nom et votre e-mail (l'adresse n'est pas vérifiée).
- C'est fait. Posez une question : « Que sais-tu de ce produit ? »
Dans Claude Code
claude mcp add --transport http deployit https://mcp.deployit.ai/acme/k7mq-x2pf-9tdrÀ la première question, Claude Code ouvre la même page d'inscription.
Connexion automatique (bêta, sur demande)
Si votre organisation Claude gère les connexions par son fournisseur d'identité, la connexion automatique peut vous inscrire sans rien saisir. Elle est en bêta, sur demande : votre administrateur DeployIt nous écrit pour l'ouvrir. Votre adresse est alors attestée quand l'émetteur est Claude ou quand votre fournisseur d'identité la marque vérifiée ; sinon, elle reste déclarée.
Pour l'administrateur
- Dans la configuration de la connexion automatique de votre organisation Claude, remplissez toujours « Tenant ID » avec l'identifiant de votre entreprise dans DeployIt (la partie de votre lien qui suit mcp.deployit.ai/) : seule votre entreprise reçoit alors vos assertions.
- Une fois la connexion automatique allumée, l'identifiant de votre entreprise ne change plus.
- Un profil que vous avez attribué d'avance à une adresse n'est donné qu'à une adresse attestée : l'émetteur est Claude, ou votre fournisseur d'identité marque l'adresse vérifiée. Sinon, la personne entre avec « Tout le monde ».
- Une personne que vous avez retirée ne revient pas par la connexion automatique.
DeployIt est un serveur MCP en HTTP, avec une autorisation OAuth ouverte à Claude (web et bureau) et aux clients locaux comme Claude Code. Les autres clients web ne peuvent pas s'inscrire, et Cursor ou Windsurf ne le peuvent pas encore.
Une ancienne adresse à clé répond « ce lien a changé » : demandez le lien de votre entreprise à votre administrateur.
Les cinq outils
Vous n'avez pas à les appeler : l'assistant choisit. Aucun ne modifie vos dépôts ni vos réglages ; chaque appel est inscrit au journal de votre entreprise ; un outil de votre entreprise que vous ouvrez à l'agent agit avec ses propres droits.
| Outil | Profils | Reçoit | Rend |
|---|---|---|---|
| server_info | Tous | rien | Le produit, ses dépôts, la fraîcheur de la lecture, et ce que votre profil ouvre. |
| ask_code | Tout le monde, Développeurs, Direction | une question, et au besoin « approfondi », si votre profil le permet | Une réponse, son statut, et ce qui a été consulté. De 20 à 60 secondes la première fois ; immédiat ensuite pour la même question posée dans les mêmes termes et sans contexte, tant que le code n'a pas changé. |
| recent_changes | Tout le monde, Développeurs, Direction | un nombre de jours, de 1 à 90, 14 par défaut ; au besoin, un dépôt | Ce qui est arrivé sur la branche suivie, regroupé en livraisons (par PR, ou par jour, module et type) : date, type, titre, modules, nombre de commits ; sans nom de personne. Immédiat. |
| stats_schema | Direction, Outil de données | rien | Les jeux de statistiques, la définition de chaque mesure, et l'heure du dernier calcul. |
| stats_query | Direction, Outil de données | une requête structurée : jeu de données, période, filtres, regroupements, mesures, limite | Des lignes : par équipe ou par développeur, au mois, au trimestre, au semestre ou à l'année. |
Le serveur propose aussi trois demandes prêtes à l'emploi, pour que le même tableau revienne à l'identique d'un mois sur l'autre :
| Demande | Profils | Rend |
|---|---|---|
team_reportperiod_unit, period (facultatifs) | Direction | Le suivi de l'équipe sur une période. |
developer_profiledeveloper · period_unit, period (facultatifs) | Direction | La fiche d'un développeur sur une période. |
what_changeddays (facultatif, 7 par défaut) | Tout le monde, Développeurs, Direction | Ce qui a changé dans le produit. |
Lire une réponse
Chaque réponse sur le code porte un statut. C'est lui qui dit si vous pouvez la répéter.
- Vérifié
verified - Confirmé dans le code. Vous pouvez le répéter.
- Côté serveur seulement
backend_only - Le produit sait le faire, mais aucun écran n'y mène.
- Introuvable
not_found - Cherché sans être trouvé : très probablement absent du produit. Ce n'est pas une preuve.
- Sans conclusion
unknown - L'enquête n'a pas abouti. Ne la répétez pas comme un fait ; reposez la question en « approfondi », si votre profil le permet.
Quand DeployIt ne répond pas
- Votre accès a été retiré par un administrateur.
- Le sujet fait partie de ceux que votre entreprise a refusés.
- Votre plafond mensuel de questions est atteint (le profil « Tout le monde » en a un par défaut).
- Votre entreprise a atteint le volume mensuel de questions prévu par son forfait : le compteur repart le mois suivant.
- Le plan gratuit a utilisé ses 15 questions de la semaine : elles reviennent lundi.
- Sans forfait ni essai, le profil « Direction » ne voit pas les outils de statistiques, et une clé d'outil de données reçoit un refus.
Chaque refus est dit en clair à votre assistant, qui vous le répète.
Les statistiques
Des faits écrits une fois par commit intégré, mis à jour chaque nuit. Chaque ligne se relie à ses commits.
Les jeux de données
- commits
- Un 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_requests
- Une PR : qui l'a ouverte, qui l'a relue (un collègue, pas son auteur ni un robot), en combien de temps.
- reviews
- Une relecture : qui a relu quelle PR, si c'est un collègue de l'auteur, et son verdict (approuvée, changements demandés ; sur GitLab, les approbations seulement).
- defects
- Un défaut : le commit d'origine, son correctif, qui a corrigé, et s'il est « confirmé » ou « à confirmer ».
- people
- Une personne suivie, ou un agent de code : ses identités, son rôle, son temps de travail, si c'est un prestataire.
- absences
- Les plages d'absence déclarées pour une personne, pour lire son activité sans fausse baisse.
- repositories
- Les dépôts couverts, leur branche d'arrivée, depuis quand leur historique est lu, et l'heure du dernier calcul.
- module_ownership
- Qui a écrit chaque module sur les 12 derniers mois, pour voir ceux qui reposent sur une seule personne.
- person_period, team_period
- Les synthèses par développeur et par équipe, au mois, au trimestre, au semestre ou à l'année.
Les colonnes de chaque jeu, la définition de chaque mesure et les limites se lisent avec l'outil stats_schema : il fait foi.
Les règles de lecture
- La note du code est une moyenne : elle se rend toujours avec le nombre de commits qu'elle résume.
- Un défaut se révèle après coup : les 60 derniers jours ne sont pas encore mûrs, et l'outil
stats_schemale dit. - Une période close peut encore bouger (un commit arrivé tard, deux identités réunies, un défaut écarté) : chaque synthèse porte l'heure de son dernier calcul.
- Seul le travail arrivé sur la branche d'arrivée de chaque dépôt compte, et il compte à son arrivée : un commit daté d'avant mais intégré ce mois-ci compte pour ce mois-ci. Les robots sont exclus ; les agents de code détectés sont comptés à part ; un agent non déclaré compte comme travail humain.
Brancher un outil de données
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.
POST https://mcp.deployit.ai/acme
Authorization: Bearer dpk_…Il appelle stats_query et suit le curseur pour lire toutes les lignes. Un commit peut changer après coup (un défaut se révèle dans les 60 jours) : relisez au moins les 60 derniers jours à chaque passage. La clé n'ouvre aucune question sur le code.
Limites
- 120 appels par minute et par personne ; 600 par minute pour une clé d'outil de données.
- L'attente est limitée à une minute ; l'enquête continue ensuite en arrière-plan : reposez la même question, dans les mêmes termes et sans contexte, un peu plus tard.
- Plan gratuit : 15 questions sur le code par semaine pour toute l'entreprise, du lundi au dimanche. Une réponse déjà connue ne compte pas.
- Sur un forfait, les questions sont comprises dans la limite d'un usage normal, affichée dans votre espace. Le profil « Tout le monde » est plafonné par défaut à 40 questions par mois et par personne ; l'administrateur règle ce plafond, profil par profil. Une fois le plafond atteint, les réponses déjà connues restent servies.
- 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.
- La démonstration répond avec le profil « Tout le monde », sans statistiques, et limite le nombre de questions par adresse.
Adresse de la démonstration :
https://mcp.deployit.ai/demoBranchez votre code, posez votre première question
30 jours d'essai, sans carte bancaire. DeployIt lit vos dépôts : aucun commit, aucune branche, aucune PR.