Ressources · Connecteur Claude

Connecteur Claude CircleCICe que Claude sait faire dans ton compte CircleCI.

Le connecteur Claude CircleCI expose 24 outils : 10 lisent, 3 agissent sur tes pipelines, 11 ne sont décrits nulle part. Ici : les runs, logs et tests que Claude consulte, ce qu'il peut relancer, annuler ou faire revenir en arrière, ce que CircleCI demande de vérifier, et qui peut couper l'accès.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Aperçu

Ce que ça change quand un build passe au rouge

Un build en échec, d'habitude, c'est ouvrir CircleCI, retrouver le run, puis le workflow, puis le job, puis dérouler les logs. Avec le connecteur branché, tu demandes à Claude pourquoi le dernier run de ta branche a planté. Il enchaîne seul les recherches, lit la sortie de l'étape fautive et t'explique ce qui a cassé, dans la conversation.

Trouver la cause d'un build rouge. list_runs retrouve le dernier run de la branche, get_run confirme l'échec, et get_job_logs lit les étapes en échec sans que tu aies à les nommer.

Ne relancer que ce qui a échoué. Un long workflow a cassé vers la fin. rerun_workflow peut ne relancer que les jobs en échec et ceux qui en dépendent.

Surveiller coûts et versions. download_usage_data exporte la consommation d'une organisation en fichiers CSV, et list_deploy_component_versions vérifie quelles versions tournent sur ton parc.

Ce que la fiche ne dit pas : il s'agit du serveur hébergé de CircleCI, pensé pour inspecter des runs. Gérer contextes, variables d'environnement, orbs ou règles de conformité relève de l'outil en ligne de commande de CircleCI, pas de ce connecteur. Onze outils de la fiche n'ont aucune description. Et rien ne tourne seul : aucun outil ne réagit de lui-même à un push ou à un échec. Pour réagir automatiquement aux événements d'un pipeline, l'Intégration CircleCI n8n fait ce métier-là, distinct d'une conversation.

Vocabulaire

Le vocabulaire en une minute

Cinq mots que tu vas croiser en branchant CircleCI.

Connecteur
Le lien que tu poses une fois entre Claude et un compte que tu as déjà, pour qu'il puisse y travailler pendant qu'il te répond.
Outil
Une action nommée que le connecteur ouvre à Claude. Il choisit seul ceux dont il a besoin ; le répertoire les liste par leur nom.
Autorisation
L'écran de connexion du service lui-même, où tu confies à Claude l'accès qu'il utilisera. Donnée une fois par personne, reprise quand tu veux.
Approbation
La confirmation que Claude attend avant d'aller au bout d'une action qui modifie un compte, affichée dans la conversation au bon moment.
MCP
Le standard commun sur lequel reposent les connecteurs : c'est lui qui permet à un assistant comme Claude de dialoguer avec un service extérieur.
Connexion

Brancher CircleCI à Claude en trois étapes

  1. 01

    Retrouver CircleCI dans Claude

    Dans les réglages de Claude, ouvre Customize puis Connectors et repère CircleCI dans la liste. Sur un espace Team ou Enterprise, un Owner ou un Primary Owner doit d'abord activer le connecteur pour que chaque membre puisse s'y connecter.

  2. 02

    Lancer le branchement

    Clique sur Connect depuis sa ligne, puis identifie-toi sur CircleCI dans la fenêtre que CircleCI ouvre lui-même. Si le lien casse plus tard, passe par Disconnect puis rebranche ; CircleCI conseille aussi de se réauthentifier quand la connexion échoue.

  3. 03

    Relire l'écran d'autorisation

    Lis l'écran d'autorisation avant de valider. Il appartient à CircleCI, pas à Claude, et c'est lui qui fixe ce que l'accès couvre. Tu peux aussi retirer cet accès plus tard depuis ton compte CircleCI.

Outils

Les 24 outils du connecteur Claude CircleCI

CircleCI donne à Claude 24 outils : 10 qui lisent ton compte, 3 qui y changent quelque chose, et 11 qu'aucune source officielle ne décrit.

Trois groupes : ce que Claude lit, ce qu'il change dans tes pipelines, et ce qu'aucune source officielle ne décrit. Les noms restent ceux que Claude affiche.

  • 10 lecture
  • 3 écriture
  • 11 non documentés

Ce que Claude lit (10)

10 outils

Dix outils qui consultent runs, jobs, logs, tests, artefacts et configuration sans rien modifier.

download_usage_data

Exporte les données de consommation d'une organisation en fichiers CSV téléchargeables, pour une période choisie, à partir de son identifiant.

Quand ça sert
une responsable technique prépare le budget du trimestre et veut la consommation de l'organisation dans un tableur.
Attention
CircleCI limite chaque export à une plage de 31 jours, un trimestre demande donc plusieurs exports.

Sourcecircleci.com · 28 septembre 2026 ↗

get_job

Récupère un job avec sa phase, son résultat et le détail étape par étape, code de sortie de chaque étape compris.

Quand ça sert
un développeur veut savoir quelle étape exacte du job de tests a renvoyé une erreur avant d'ouvrir les logs.

Sourcecircleci.com · 28 septembre 2026 ↗

get_job_logs

Lit la sortie des étapes d'un job. Si tu ne nommes aucune étape, il va directement à celles qui ont échoué, ce qui est en général ce que tu cherches.

Quand ça sert
le job de déploiement est rouge et tu demandes à Claude d'expliquer l'erreur simplement.
Attention
Claude lit ce que contient le log ; un log flou donne un diagnostic flou.

Sourcecircleci.com · 28 septembre 2026 ↗

get_run

Remonte un run avec sa phase, son résultat, les détails de gestion de versions et les éventuelles erreurs de configuration détectées par CircleCI.

Quand ça sert
un pipeline n'a jamais démarré et tu soupçonnes un fichier de configuration cassé plutôt qu'un test.

Sourcecircleci.com · 28 septembre 2026 ↗

get_workflow

Renvoie le nom, la phase et le résultat d'un workflow, ce qui situe un run avant que Claude ne descende dans les jobs.

Quand ça sert
la personne qui gère les mises en production vérifie si le workflow de nuit tourne encore ou s'il est terminé.

Sourcecircleci.com · 28 septembre 2026 ↗

list_deploy_component_versions

D'après la fiche du répertoire, il permet à Claude de vérifier quelles versions de composants tournent sur ton parc, dans la gestion courante des projets.

Quand ça sert
une équipe plateforme veut confirmer que tous les environnements ont la même version après un déploiement.

Sourceclaude.com · 30 septembre 2026 ↗

list_job_artifacts

Selon la fiche du répertoire, il liste les artefacts produits par tes builds, pour récupérer rapports ou paquets sans fouiller l'interface.

Quand ça sert
l'équipe qualité veut le rapport de couverture du build d'hier.
Attention
la page d'outils de CircleCI lui donne un nom légèrement différent.

Sourceclaude.com · 30 septembre 2026 ↗

list_job_tests

Liste les résultats de tests d'un job. Par défaut, seuls les tests en échec remontent, avec une option pour inclure ceux qui passent ou sont ignorés.

Quand ça sert
une suite instable a cassé le build et tu veux les tests en échec avec leur message, pas le rapport entier.

Sourcecircleci.com · 28 septembre 2026 ↗

list_runs

Liste les runs d'un projet, ou tes propres runs sur tous les projets, avec des filtres par branche et par statut.

Quand ça sert
le lundi matin, tu veux voir tous les runs rouges sur la branche principale depuis vendredi.

Sourcecircleci.com · 28 septembre 2026 ↗

validate_config

Présenté par la fiche du répertoire comme une aide à la configuration, il sert à valider et dépanner ton fichier .circleci/config.yml.

Quand ça sert
tu as modifié le fichier du pipeline et tu veux un contrôle avant de pousser.
Attention
la page de CircleCI renvoie vers son outil en ligne de commande quand un assistant doit rédiger ou valider de la configuration : vérifie sur lequel tu t'appuies.

Sourceclaude.com · 30 septembre 2026 ↗

Ce que Claude change (3)

3 outils

Trois outils qui modifient l'état réel de ta CI. Aucune source ne leur prête de confirmation propre ; la règle générale plus bas s'applique.

cancel_workflow

Approbation : voir la règle

Annule un workflow en cours d'exécution.

Ce que Claude demande
aucune source ne décrit de confirmation propre à cet outil, c'est donc la règle générale des approbations qui joue.
Quand ça sert
quelqu'un a poussé la mauvaise branche et un long workflow de déploiement consomme des crédits.
Attention
CircleCI demande de vérifier ce que l'assistant s'apprête à annuler, surtout sur un projet partagé.

Sourcecircleci.com · 28 septembre 2026 ↗

rerun_workflow

Approbation : voir la règle

Redémarre un workflow. Par défaut, tous les jobs repartent ; avec la bonne option, seuls les jobs en échec et ceux qui en dépendent sont relancés.

Ce que Claude demande
rien de précis n'est documenté, la règle générale plus bas le couvre.
Quand ça sert
une coupure réseau a fait tomber un job d'intégration à la fin d'un long pipeline.
Attention
relancer modifie l'état réel de la CI, CircleCI conseille donc de relire l'action d'abord.

Sourcecircleci.com · 28 septembre 2026 ↗

rollback_deploy_component

Approbation : voir la règle

La fiche du répertoire indique qu'on peut demander à Claude de revenir en arrière sur un déploiement depuis la conversation, sans ouvrir CircleCI.

Ce que Claude demande
aucune source ne décrit de confirmation pour cet outil ; reporte-toi à la règle générale.
Quand ça sert
une mise en production a cassé le paiement et l'ingénieur d'astreinte veut vite l'ancienne version.
Attention
la page d'outils de CircleCI ne décrit pas cet outil, seule la fiche parle de retour arrière.

Sourceclaude.com · 30 septembre 2026 ↗

Non documentés (11)

11 outils

Le répertoire publie ces onze noms et rien de plus. Aucun texte officiel ne dit ce qu'ils font, et on ne le devinera pas à partir d'un nom.

get_deploy_component

Ce nom figure dans la liste du répertoire, et c'est tout ce qu'on en publie. Ni la page MCP de CircleCI ni aucun article de Claude ne le décrivent.

Attention
quoi qu'il fasse, la règle générale des approbations le couvre.

get_deploy_environment

Un autre nom listé qu'aucune source officielle ne documente. Mieux vaut signaler le trou que le combler avec une supposition tirée de la sonorité du nom. Le répertoire l'affiche, l'explication manque.

Attention
il relève de la même règle d'approbation que le reste.

get_job_resource_usage

Listé sur la fiche, expliqué nulle part. Ni la page d'outils de CircleCI ni aucun article Claude ne lui consacre une phrase : cette page ne le décrit donc pas et ne suggère rien sur son rôle.

Attention
traite-le comme non documenté, sous la règle par défaut.

get_me

Aucune page de CircleCI ni d'Anthropic ne dit ce que cet outil renvoie. Le répertoire n'imprime que son nom, et cette page s'arrête là, elle aussi : aucune source officielle ne le documente.

Attention
la règle générale des approbations s'applique à lui comme aux autres.

get_orb

Le nom apparaît sur la fiche sans explication officielle. La page MCP de CircleCI n'en dit rien, pas plus qu'aucune page de Claude. Aucune source officielle ne le documente à ce jour.

Attention
il reste couvert par la règle générale des approbations.

get_orb_source

Là encore, un nom et rien d'autre : aucune source officielle ne le documente, et deviner son comportement d'après son libellé serait justement l'erreur que cette page évite. Le trou est réel, pas un oubli.

Attention
c'est la règle d'approbation par défaut qui le régit.

list_deploy_components

Cet outil est imprimé sur la fiche du répertoire sans une seule phrase de CircleCI ou de Claude derrière. Aucune source officielle ne le documente : on sait qu'il existe, pas ce qu'il fait. Si CircleCI publie une description, cette note la suivra.

Attention
la même règle générale d'approbation le couvre.

list_deploy_environments

Aucune source ne documente ce nom. Le répertoire le liste, la page MCP de CircleCI l'omet, et aucun article d'aide de Claude ne couvre ce connecteur. On ne peut honnêtement rien en dire de plus.

Attention
quoi qu'il fasse, la règle générale des approbations s'applique.

list_deployments

Encore un nom que la fiche affiche sans description officielle. Plutôt que d'en déduire quoi que ce soit, cette page constate le silence et passe à la suite.

Attention
il reste sous la règle d'approbation par défaut décrite plus bas.

list_run_workflows

La page MCP de CircleCI décrit un outil au nom proche mais différent, et rien ne documente ce nom exact. La page ne suppose pas qu'il s'agit du même outil, et aucune source officielle ne documente celui-ci.

Attention
la règle générale des approbations le couvre.

list_workflow_jobs

Même décalage : CircleCI documente un outil au nom voisin, tandis que ce nom exact n'a aucune description dans une source officielle. Aucune source officielle ne le documente : traite-le comme non documenté.

Attention
il relève de la règle générale des approbations, comme tous les outils ici.
Approbations

Ce que Claude te demande avant d'agir

Par défaut, Claude s'arrête et demande ton accord avant chaque action qu'il mène sur un compte à ta place. La demande apparaît dans la conversation, au moment où elle compte.

C'est le cas pour relancer, annuler ou revenir en arrière. CircleCI ajoute son propre conseil : relire les actions destructrices avant de confirmer, surtout sur un projet partagé ou proche de la production. Sur Team ou Enterprise, les propriétaires décident si un membre peut laisser passer certaines actions sans demande, et ils peuvent borner ce qu'un connecteur fait pour tous. Claude travaille avec tes droits, rien de plus.

Plans

Sur quels plans Claude c'est disponible

Sur les 819 fiches du répertoire officiel, aucune n'affiche de disponibilité par plan. La réponse connecteur par connecteur n'est publiée nulle part.

La règle générale, elle, est publique : les connecteurs distants sont ouverts à tous les utilisateurs sur Claude, Cowork, Claude Desktop et mobile. Sur Team et Enterprise, un Owner ou un Primary Owner ouvre le connecteur pour l'organisation avant que chaque membre puisse s'y connecter. Pour l'état à jour, consulte la fiche du connecteur dans le répertoire officiel. Bon à savoir : seul CircleCI documente ce connecteur, sans article d'aide Claude dédié.

Limites

Là où ce connecteur s'arrête

Un connecteur n'est pas une automatisation. Claude appelle ces outils pendant qu'il te répond : rien ne démarre quand un build échoue ou qu'un déploiement se termine.

La liste d'outils est un plancher observé, pas une promesse : un administrateur peut ouvrir des actions qu'aucune fiche publique ne montre. Le badge partenaire n'est pas non plus un audit de sécurité, et Anthropic l'écrit sur chaque fiche : il ne choisit pas les outils qu'un éditeur expose et ne garantit pas leur comportement. Ne branche que ce qui vient d'un éditeur de confiance. Les autres connecteurs sont réunis sur la page Intégrations.

Besoin d'aide

Besoin d'aide pour brancher CircleCI sur Claude ?

Une personne lit chaque message.

FAQ

Connecteur Claude CircleCI : questions fréquentes

01Que peut faire Claude avec le connecteur CircleCI ?
Claude peut inspecter tes pipelines de CI pendant qu'il te répond. Les outils documentés listent les runs, récupèrent un run, un workflow ou un job, lisent les logs des étapes en échec, listent résultats de tests et artefacts, exportent la consommation, vérifient les versions de composants et aident à valider la configuration. Claude peut aussi relancer ou annuler un workflow et, selon la fiche du répertoire, revenir sur un déploiement. Onze autres outils de la fiche n'ont aucune description officielle.
02Claude peut-il relancer, annuler ou revenir en arrière dans CircleCI ?
Oui, trois outils documentés modifient l'état réel de ta CI. L'un relance un workflow, en entier ou seulement les jobs en échec et leurs dépendants ; un autre annule un workflow en cours ; le troisième, décrit par la fiche du répertoire, revient sur un déploiement. Rien de documenté ne modifie ton fichier de configuration, tes contextes ou tes variables d'environnement. CircleCI réserve ces tâches d'administration à son outil en ligne de commande, un produit distinct de ce connecteur.
03Claude me demande-t-il avant de relancer ou d'annuler un build ?
La règle par défaut de Claude est de demander une confirmation avant chaque action qu'il mène sur un compte à ta place. Aucune source ne décrit de confirmation propre aux outils CircleCI, c'est donc cette règle qui les couvre. CircleCI ajoute son conseil : vérifie ce que l'assistant va faire avant de confirmer, surtout sur un projet partagé ou proche de la production. Sur Team ou Enterprise, les propriétaires peuvent aussi bloquer ces modifications pour toute l'organisation.
04Sur quels plans le connecteur CircleCI est-il disponible ?
Aucune source officielle ne publie la disponibilité par plan connecteur par connecteur, et aucune des 819 fiches du répertoire ne l'affiche. La règle générale veut que les connecteurs distants soient ouverts à tous les utilisateurs sur Claude, Cowork, Claude Desktop et mobile. Sur Team et Enterprise, un Owner ou un Primary Owner active le connecteur pour l'organisation avant que les membres s'y connectent. La fiche du répertoire montre l'état à jour pour ton compte.
05Claude voit-il tous les projets de notre organisation CircleCI ?
Non, Claude travaille avec tes droits et rien de plus. Il atteint les projets que ton propre accès CircleCI atteint. Si la connexion repose sur un jeton d'API personnel, CircleCI précise que ce jeton doit rester valide et appartenir à quelqu'un qui a accès au projet, sinon les appels échouent. Sur un espace Claude Team ou Enterprise, les propriétaires peuvent encore restreindre ce que le connecteur a le droit de faire, et un membre ne peut pas passer outre.
06Pourquoi Claude ne voit pas un nouvel outil CircleCI ?
Parce que les outils se chargent au moment du branchement. CircleCI indique qu'après la sortie de nouveaux outils, il faut redémarrer le client ou reconnecter le serveur pour les récupérer. Dans Claude, cela revient à débrancher puis rebrancher le connecteur. Pour un souci d'authentification sur une connexion par autorisation, CircleCI conseille de se réauthentifier depuis ton client. Garde aussi en tête que la fiche du répertoire et la page de CircleCI n'affichent pas toujours les mêmes noms.
07Claude ou n8n pour CircleCI ?
Ils ne font pas le même métier, alors choisis selon l'usage. Claude avec le connecteur sert à l'enquête du moment : pourquoi ce build a échoué, quels tests ont cassé, relancer les jobs en échec. Il n'agit que pendant que tu lui parles. n8n sert aux réactions qui doivent se produire sans toi, comme prévenir un canal d'équipe à chaque pipeline en échec. Rien n'empêche d'utiliser les deux, chacun pour ce qu'il fait bien.