CircleCI

Prérequis :

• Jeton d’API personnel CircleCI (en savoir plus)
• NPX : Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 et pnpm
• Docker : Docker

Utiliser NPX dans un serveur MCP local

Ajoutez ce qui suit à la configuration MCP de Cursor :

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

CIRCLECI_BASE_URL est facultatif — requis uniquement pour les clients sur site. MAX_MCP_OUTPUT_LENGTH est facultatif — longueur maximale de sortie des réponses MCP (valeur par défaut : 50000).

Utiliser Docker dans un serveur MCP local

Ajoutez ce qui suit à la configuration MCP de Cursor :

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CIRCLECI_TOKEN",
        "-e",
        "CIRCLECI_BASE_URL",
        "-e",
        "MAX_MCP_OUTPUT_LENGTH",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

Utiliser un serveur MCP distant autogéré

Consultez Serveur MCP distant autogéré. Utilisez la configuration client par utilisateur et ajoutez-la à la configuration MCP de Cursor (Cursor Settings → MCP).

Prérequis :

• Jeton d’API personnel CircleCI (en savoir plus)
• NPX : Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 et pnpm
• Docker : Docker

Utiliser NPX dans un serveur MCP local

Ajoutez ce qui suit à .vscode/mcp.json dans votre projet :

{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "CircleCI API Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "circleci-base-url",
      "description": "CircleCI Base URL",
      "default": "https://circleci.com"
    }
  ],
  "servers": {
    "circleci-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "${input:circleci-token}",
        "CIRCLECI_BASE_URL": "${input:circleci-base-url}"
      }
    }
  }
}

💡 Les informations sont demandées au premier démarrage du serveur, puis stockées de manière sécurisée par VS Code.

Utiliser Docker dans un serveur MCP local

Ajoutez ce qui suit à .vscode/mcp.json dans votre projet :

{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "CircleCI API Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "circleci-base-url",
      "description": "CircleCI Base URL",
      "default": "https://circleci.com"
    }
  ],
  "servers": {
    "circleci-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CIRCLECI_TOKEN",
        "-e",
        "CIRCLECI_BASE_URL",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "${input:circleci-token}",
        "CIRCLECI_BASE_URL": "${input:circleci-base-url}"
      }
    }
  }
}

Utiliser un serveur MCP distant autogéré

Consultez Serveur MCP distant autogéré. Utilisez la configuration client par utilisateur dans .vscode/mcp.json.

Prérequis :

• Jeton d’API personnel CircleCI (en savoir plus)
• NPX : Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 et pnpm
• Docker : Docker

Utiliser NPX dans un serveur MCP local

Ajoutez ce qui suit à votre claude_desktop_config.json :

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

Utiliser Docker dans un serveur MCP local

Ajoutez ce qui suit à votre claude_desktop_config.json :

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CIRCLECI_TOKEN",
        "-e",
        "CIRCLECI_BASE_URL",
        "-e",
        "MAX_MCP_OUTPUT_LENGTH",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

Utiliser un serveur MCP distant autogéré

Consultez Serveur MCP distant autogéré. Créez un script wrapper comme indiqué dans Clients Claude Desktop et CLI, puis indiquez son chemin dans votre claude_desktop_config.json.

Pour trouver ou créer votre fichier de configuration, ouvrez les paramètres de Claude Desktop, cliquez sur Developer dans la barre latérale gauche, puis sur Edit Config. Le fichier de configuration se trouve à l’emplacement suivant :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

Pour en savoir plus : https://modelcontextprotocol.io/quickstart/user

Prérequis :

• Jeton d’API personnel CircleCI (en savoir plus)
• NPX : Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 et pnpm
• Docker : Docker

Utiliser NPX dans un serveur MCP local

claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci@latest

Utiliser Docker dans un serveur MCP local

claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -e CIRCLECI_BASE_URL=https://circleci.com -- docker run --rm -i -e CIRCLECI_TOKEN -e CIRCLECI_BASE_URL circleci/mcp-server-circleci

Utiliser un serveur MCP distant autogéré

Consultez Serveur MCP distant autogéré et la configuration du client Claude Code qui s’y trouve.

Prérequis :

• Jeton d’API personnel CircleCI (en savoir plus)
• NPX : Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 et pnpm
• Docker : Docker

Utiliser NPX dans un serveur MCP local

Ajoutez ce qui suit à votre mcp_config.json Windsurf :

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

Utiliser Docker dans un serveur MCP local

Ajoutez ce qui suit à votre mcp_config.json Windsurf :

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CIRCLECI_TOKEN",
        "-e",
        "CIRCLECI_BASE_URL",
        "-e",
        "MAX_MCP_OUTPUT_LENGTH",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

Utiliser un serveur MCP distant autogéré

Consultez Serveur MCP distant autogéré. Utilisez la configuration client par utilisateur dans votre mcp_config.json Windsurf.

Pour en savoir plus : https://docs.windsurf.com/windsurf/mcp

Prérequis :

• Jeton d’API personnel CircleCI (en savoir plus)
• NPX : Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 et pnpm

La configuration du client MCP dans Amazon Q Developer est stockée au format JSON dans un fichier nommé mcp.json. Deux niveaux de configuration sont pris en charge :

• Global : ~/.aws/amazonq/mcp.json — s’applique à tous les espaces de travail
• Espace de travail : .amazonq/mcp.json — propre à l’espace de travail actuel

Si les deux fichiers existent, leur contenu est fusionné. En cas de conflit, la configuration de l’espace de travail est prioritaire.

Utiliser NPX dans un serveur MCP local

Modifiez ~/.aws/amazonq/mcp.json ou créez .amazonq/mcp.json avec le contenu suivant :

{
  "mcpServers": {
    "circleci-local": {
      "command": "npx",
      "args": [
        "-y",
        "@circleci/mcp-server-circleci@latest"
      ],
      "env": {
        "CIRCLECI_TOKEN": "YOUR_CIRCLECI_TOKEN",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      },
      "timeout": 60000
    }
  }
}

Utiliser un serveur MCP distant autogéré

Consultez Serveur MCP distant autogéré. Utilisez un script wrapper comme indiqué dans Clients Claude Desktop et CLI, puis enregistrez-le avec q mcp add.

Prérequis :

• Jeton d’API personnel CircleCI (en savoir plus)
• NPX : Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 et pnpm

Utiliser NPX dans un serveur MCP local

Modifiez ~/.aws/amazonq/mcp.json ou créez .amazonq/mcp.json avec le contenu suivant :

{
  "mcpServers": {
    "circleci-local": {
      "command": "npx",
      "args": [
        "-y",
        "@circleci/mcp-server-circleci@latest"
      ],
      "env": {
        "CIRCLECI_TOKEN": "YOUR_CIRCLECI_TOKEN",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      },
      "timeout": 60000
    }
  }
}

Utiliser un serveur MCP distant autogéré

Consultez Serveur MCP distant autogéré. Utilisez un script wrapper comme indiqué dans Clients Claude Desktop et CLI, puis ajoutez-le via l’interface de configuration MCP :

1. Accéder à l’interface de configuration MCP
2. Choisissez le symbole +
3. Sélectionnez la portée : global ou local
4. Saisissez un nom (par exemple circleci-remote-mcp)
5. Sélectionnez le protocole de transport : stdio
6. Saisissez le chemin de la commande vers votre script
7. Cliquez sur Save

Pour installer automatiquement le serveur MCP CircleCI pour Claude Desktop via Smithery :

npx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci --client claude

Exemple : « Trouve le dernier pipeline en échec sur ma branche et récupère les journaux » — consultez le wiki pour d’autres exemples.

https://github.com/user-attachments/assets/3c765985-8827-442a-a8dc-5069e01edb74

Aide à effectuer des tâches de configuration CircleCI en fournissant des conseils et une validation.

• Valide votre .circleci/config.yml pour détecter les erreurs de syntaxe et de sémantique
• Fournit des résultats de validation détaillés et des recommandations de configuration
• Exemple : « Valide ma configuration CircleCI »

Télécharge les données d’utilisation de l’API Usage de CircleCI pour une organisation donnée. Accepte des dates exprimées de manière flexible (par ex. « mars 2025 » ou « le mois dernier »). Fonctionnalité réservée au cloud.

Option 1 : Lancez une nouvelle tâche d’export en fournissant :

• orgId, startDate, endDate (32 jours maximum), outputDir

Option 2 : Vérifiez ou téléchargez une tâche d’export existante en fournissant :

• orgId, jobId, outputDir

Renvoie un fichier CSV contenant les données d’utilisation de CircleCI pour la période spécifiée.

[!NOTE] Les données d’utilisation peuvent être transmises à l’outil find_underused_resource_classes pour analyser les possibilités d’optimisation des coûts.

Identifie les tests instables dans votre projet CircleCI en analysant l’historique de leur exécution. S’appuie sur la fonctionnalité de détection des tests instables de CircleCI.

Cet outil peut être utilisé de trois façons :

1. Avec un slug de projet (recommandé) :

   • Utilisez d’abord list_followed_projects pour obtenir vos projets, puis :
   • Exemple : « Trouve les tests instables de my-project »

2. Avec l’URL d’un projet CircleCI :

   • Exemple : « Trouve les tests instables dans https://app.circleci.com/pipelines/github/org/repo »

3. Avec le contexte d’un projet local :

   • Fonctionne depuis votre espace de travail local en fournissant la racine de l’espace de travail et l’URL du dépôt Git distant
   • Exemple : « Trouve les tests instables dans mon projet actuel »

Modes de sortie :

• Texte (par défaut) : Renvoie les détails des tests instables au format texte
• Fichier (nécessite la variable d’environnement FILE_OUTPUT_DIRECTORY) : Crée un répertoire contenant les détails des tests instables

Analyse un fichier CSV de données d’utilisation CircleCI pour trouver les tâches dont l’utilisation moyenne ou maximale du processeur ou de la mémoire vive est inférieure à un seuil donné (40 % par défaut).

Fournissez un fichier CSV obtenu avec download_usage_api_data.

Renvoie une liste Markdown des tâches sous-utilisées, classées par projet et par workflow — utile pour repérer les possibilités d’optimisation des coûts.

Récupère les journaux détaillés des échecs de compilation CircleCI. Cet outil peut être utilisé de trois façons :

1. Avec un slug de projet et une branche (recommandé) :

   • Utilisez d’abord list_followed_projects pour obtenir vos projets, puis :
   • Exemple : « Récupère les échecs de compilation de my-project sur la branche main »

2. Avec des URL CircleCI :

   • Fournissez directement l’URL d’une tâche en échec ou d’un pipeline
   • Exemple : « Récupère les journaux de https://app.circleci.com/pipelines/github/org/repo/123 »

3. Avec le contexte d’un projet local :

   • Fonctionne depuis votre espace de travail local en fournissant la racine de l’espace de travail, l’URL du dépôt Git distant et le nom de la branche
   • Exemple : « Trouve le dernier pipeline en échec sur ma branche actuelle »

L’outil renvoie des journaux mis en forme, notamment :

• Noms des tâches
• Détails d’exécution étape par étape
• Messages d’échec et contexte

Récupère les métadonnées des tests des tâches CircleCI, ce qui vous permet d’analyser les résultats des tests sans quitter votre IDE. Cet outil peut être utilisé de trois façons :

1. Avec un slug de projet et une branche (recommandé) :

   • Exemple : « Récupère les résultats des tests de my-project sur la branche main »

2. Avec une URL CircleCI :

   • URL de tâche : https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def/jobs/789
   • URL de workflow : https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def
   • URL de pipeline : https://app.circleci.com/pipelines/github/org/repo/123

3. Avec le contexte d’un projet local :

   • Fonctionne depuis votre espace de travail local en fournissant la racine de l’espace de travail, l’URL du dépôt Git distant et le nom de la branche

L’outil renvoie :

• Un récapitulatif de tous les tests (nombre total, réussis, échoués)
• Des informations détaillées sur les tests échoués : nom, classe, fichier, message d’erreur, durée
• La liste des tests réussis avec leur durée
• Un filtre par résultat de test

[!NOTE] Les métadonnées des tests doivent être configurées dans votre configuration CircleCI. Consultez Collecter les données de test pour les instructions de configuration.

1. Avec le slug du projet et la branche (recommandé) :

   • Exemple : « Obtenir l’état du dernier pipeline de my-project sur la branche main »

2. Avec l’URL du projet CircleCI :

   • Exemple : « Obtenir l’état du dernier pipeline pour https://app.circleci.com/pipelines/github/org/repo »

3. Avec le contexte du projet local :

   • Fonctionne depuis votre espace de travail local en fournissant la racine de l’espace de travail, l’URL du dépôt git et le nom de la branche

Exemple de sortie :

---
Workflow: build
Status: success
Duration: 5 minutes
Created: 4/20/2025, 10:15:30 AM
Stopped: 4/20/2025, 10:20:45 AM
---
Workflow: test
Status: running
Duration: unknown
Created: 4/20/2025, 10:21:00 AM
Stopped: in progress

Récupère la liste des artefacts produits par un job CircleCI. Cet outil peut être utilisé de trois façons :

1. Avec le slug du projet et la branche (recommandé) :

   • Utilisez d’abord list_followed_projects pour obtenir vos projets, puis :
   • Exemple : « Lister les artefacts de my-project sur la branche main »

2. Avec une URL CircleCI :

   • URL du job : https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/789
   • URL du workflow : https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def
   • URL du pipeline : https://app.circleci.com/pipelines/gh/organization/project/123

3. Avec le contexte du projet local :

   • Fonctionne depuis votre espace de travail local en fournissant la racine de l’espace de travail, l’URL du dépôt git et le nom de la branche

Utile pour :

• Trouver les URL de téléchargement des artefacts de build (binaires, rapports, journaux)
• Vérifier quels artefacts ont été produits par une exécution de pipeline

Répertorie toutes les versions d’un composant CircleCI spécifique dans un environnement. Inclut l’état du déploiement, les informations sur le commit et les horodatages.

L’outil vous invitera à sélectionner le composant et l’environnement s’ils ne sont pas indiqués.

Utile pour :

• Identifier la version actuellement en production
• Sélectionner les versions cibles pour les opérations de restauration
• Obtenir les détails du déploiement (pipeline, workflow, job)

Répertorie tous les projets CircleCI suivis par l’utilisateur.

• Affiche tous les projets auxquels vous avez accès avec leur projectSlug
• Exemple : « Lister mes projets CircleCI »

Exemple de sortie :

Projects followed:
1. my-project (projectSlug: gh/organization/my-project)
2. another-project (projectSlug: gh/organization/another-project)

[!NOTE] Le projectSlug (et non le nom du projet) est requis par de nombreux autres outils CircleCI.

Relance un workflow depuis son début ou à partir du job ayant échoué.

Renvoie l’ID du workflow nouvellement créé et un lien permettant de le suivre.

Déclenche l’exécution d’un pipeline. Cet outil peut être utilisé de trois façons :

1. Avec le slug du projet et la branche (recommandé) :

   • Exemple : « Exécuter le pipeline de my-project sur la branche main »

2. Avec une URL CircleCI :

   • URL du pipeline, du workflow, du job ou du projet avec la branche
   • Exemple : « Exécuter le pipeline pour https://app.circleci.com/pipelines/github/org/repo/123 »

3. Avec le contexte du projet local :

   • Fonctionne depuis votre espace de travail local en fournissant la racine de l’espace de travail, l’URL du dépôt git et le nom de la branche

L’outil renvoie un lien permettant de suivre l’exécution du pipeline.

Déclenche une restauration pour un projet CircleCI. L’outil vous guide de manière interactive à travers les étapes suivantes :

1. Sélection du projet — répertorie les projets suivis parmi lesquels choisir
2. Sélection de l’environnement — répertorie les environnements disponibles (sélection automatique s’il n’y en a qu’un)
3. Sélection du composant — répertorie les composants disponibles (sélection automatique s’il n’y en a qu’un)
4. Sélection de la version — affiche les versions disponibles ; vous sélectionnez la cible de la restauration
5. Détection du mode de restauration — vérifie si un pipeline de restauration est configuré
6. Exécution de la restauration — deux options :
   • Restauration par pipeline : déclenche le pipeline de restauration
   • Relance du workflow : relance un workflow précédent à l’aide de son ID
7. Confirmation — récapitule et demande confirmation avant l’exécution

Problèmes les plus courants :

1. Vider les caches des packages :

   npx clear-npx-cache
   npm cache clean --force
   

2. Forcer l’utilisation de la dernière version : ajoutez @latest à votre configuration :

   "args": ["-y", "@circleci/mcp-server-circleci@latest"]
   

3. Redémarrez complètement votre IDE (ne vous contentez pas de recharger la fenêtre)

• Erreurs de jeton invalide : vérifiez votre CIRCLECI_TOKEN dans Personal API Tokens
• Erreurs d’autorisation : assurez-vous que le jeton dispose d’un accès en lecture à vos projets
• Variables d’environnement non chargées : testez avec echo $CIRCLECI_TOKEN (Mac/Linux) ou echo %CIRCLECI_TOKEN% (Windows)

• URL de base : vérifiez que CIRCLECI_BASE_URL est https://circleci.com
• Réseaux d’entreprise : configurez les paramètres du proxy npm si vous êtes derrière un pare-feu
• Blocage par le pare-feu : vérifiez si un logiciel de sécurité bloque les téléchargements de packages

• Version de Node.js : assurez-vous qu’elle satisfait ^22.23.4 || ^24.22.1 || >=26.12.1 avec node --version
• Mettre à jour Node.js : envisagez la dernière version LTS en cas de problèmes de compatibilité
• Gestionnaire de packages : vérifiez que npm/pnpm fonctionne : npm --version

• Emplacement du fichier de configuration : vérifiez le chemin correspondant à votre système d’exploitation
• Erreurs de syntaxe : validez la syntaxe JSON de votre fichier de configuration
• Journaux de la console : consultez la console de développement de l’IDE pour repérer les erreurs spécifiques
• Essayez un autre IDE : testez dans un autre éditeur pris en charge pour isoler le problème

Processus bloqués — arrêtez les processus MCP existants :

# Mac/Linux:
pkill -f "mcp-server-circleci"

# Windows:
taskkill /f /im node.exe

Conflits de ports : redémarrez votre IDE si la connexion semble bloquée.

• Tester directement le package : npx @circleci/mcp-server-circleci@latest --help
• Journalisation détaillée : DEBUG=* npx @circleci/mcp-server-circleci@latest
• Solution de repli avec Docker : essayez l’installation Docker si npx échoue systématiquement

Vous avez encore besoin d’aide ?

1. Consultez GitHub Issues pour trouver des problèmes similaires
2. Indiquez votre système d’exploitation, votre version de Node et votre IDE lorsque vous signalez un problème
3. Partagez les messages d’erreur pertinents de la console de l’IDE