CircleCI

Prérequis :

• Jeton API personnel CircleCI (en savoir plus)
• NPX : Node.js >= v18 et pnpm
• Docker : Docker

Utilisation de NPX dans un serveur MCP local

Ajoutez ce qui suit à votre configuration MCP 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 optionnel — requis uniquement pour les clients on-prem. MAX_MCP_OUTPUT_LENGTH est optionnel — longueur maximale de sortie pour les réponses MCP (défaut : 50000).

Utilisation de Docker dans un serveur MCP local

Ajoutez ce qui suit à votre configuration MCP 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"
      }
    }
  }
}

Utilisation d'un serveur MCP distant auto-géré

Voir Serveur MCP distant auto-géré. Utilisez la configuration client par utilisateur et ajoutez-la à votre configuration MCP Cursor (Cursor Settings → MCP).

Prérequis :

• Jeton API personnel CircleCI (en savoir plus)
• NPX : Node.js >= v18 et pnpm
• Docker : Docker

Utilisation de 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 entrées sont demandées au premier démarrage du serveur, puis stockées en toute sécurité par VS Code.

Utilisation de 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}"
      }
    }
  }
}

Utilisation d'un serveur MCP distant auto-géré

Voir Serveur MCP distant auto-géré. Utilisez la configuration client par utilisateur dans .vscode/mcp.json.

Prérequis :

• Jeton API personnel CircleCI (en savoir plus)
• NPX : Node.js >= v18 et pnpm
• Docker : Docker

Utilisation de 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"
      }
    }
  }
}

Utilisation de 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"
      }
    }
  }
}

Utilisation d'un serveur MCP distant auto-géré

Voir Serveur MCP distant auto-géré. Créez un script wrapper comme indiqué dans Clients Claude Desktop et CLI, puis pointez votre claude_desktop_config.json vers celui-ci.

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 à :

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

Pour plus d'informations : https://modelcontextprotocol.io/quickstart/user

Prérequis :

• Jeton API personnel CircleCI (en savoir plus)
• NPX : Node.js >= v18 et pnpm
• Docker : Docker

Utilisation de 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

Utilisation de 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

Utilisation d'un serveur MCP distant auto-géré

Voir Serveur MCP distant auto-géré et la configuration du client Claude Code là-bas.

Prérequis :

• Jeton API personnel CircleCI (en savoir plus)
• NPX : Node.js >= v18 et pnpm
• Docker : Docker

Utilisation de 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"
      }
    }
  }
}

Utilisation de 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"
      }
    }
  }
}

Utilisation d'un serveur MCP distant auto-géré

Voir Serveur MCP distant auto-géré. Utilisez la configuration client par utilisateur dans votre mcp_config.json Windsurf.

Pour plus d'informations : https://docs.windsurf.com/windsurf/mcp

Prérequis :

• Jeton API personnel CircleCI (en savoir plus)
• NPX : Node.js >= v18 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 — spécifique à 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 a priorité.

Utilisation de NPX dans un serveur MCP local

Modifiez ~/.aws/amazonq/mcp.json ou créez .amazonq/mcp.json avec ce qui suit :

{
  "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
    }
  }
}

Utilisation d'un serveur MCP distant auto-géré

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

Prérequis :

• Jeton API personnel CircleCI (en savoir plus)
• NPX : Node.js >= v18 et pnpm

Utilisation de NPX dans un serveur MCP local

Modifiez ~/.aws/amazonq/mcp.json ou créez .amazonq/mcp.json avec ce qui suit :

{
  "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
    }
  }
}

Utilisation d'un serveur MCP distant auto-géré

Voir Serveur MCP distant auto-gé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. Entrez un nom (par exemple circleci-remote-mcp)
5. Sélectionnez le protocole de transport : stdio
6. Entrez le chemin de commande de votre script
7. Cliquez sur Enregistrer

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 : « Trouver le dernier pipeline en échec sur ma branche et obtenir les journaux » — voir le wiki pour plus d'exemples.

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

Assiste les tâches de configuration CircleCI en fournissant des conseils et une validation.

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

Télécharge les données d'utilisation depuis l'API d'utilisation CircleCI pour une organisation donnée. Accepte une saisie de date flexible (p. ex., « mars 2025 » ou « le mois dernier »). Fonctionnalité cloud uniquement.

Option 1 : Démarrer un nouveau travail d'export en fournissant :

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

Option 2 : Vérifier/télécharger un travail d'export existant en fournissant :

• orgId, jobId, outputDir

Renvoie un fichier CSV avec les données d'utilisation CircleCI pour la période spécifiée.

[!NOTE] Les données d'utilisation peuvent être alimentées dans l'outil find_underused_resource_classes pour l'analyse d'optimisation des coûts.

Identifie les tests instables dans votre projet CircleCI en analysant l'historique d'exécution des tests. Exploite la fonctionnalité de détection des tests instables de CircleCI.

Cet outil peut être utilisé de trois manières :

1. Utilisation du slug de projet (recommandé) :

   • Utilisez d'abord list_followed_projects pour obtenir vos projets, puis :
   • Exemple : « Obtenir les tests instables pour mon-projet »

2. Utilisation de l'URL du projet CircleCI :

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

3. Utilisation du contexte de 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 : « Trouver les tests instables dans mon projet actuel »

Modes de sortie :

• Texte (défaut) : Renvoie les détails des tests instables au format texte
• Fichier (requiert la variable d'environnement FILE_OUTPUT_DIRECTORY) : Crée un répertoire avec les détails des tests instables

Analyse un fichier CSV de données d'utilisation CircleCI pour trouver les tâches dont l'utilisation CPU/RAM moyenne ou maximale est inférieure à un seuil donné (défaut : 40 %).

Fournissez un fichier CSV obtenu depuis download_usage_api_data.

Renvoie une liste Markdown de tâches sous-utilisées organisée par projet et workflow — utile pour identifier les opportunités d'optimisation des coûts.

Récupère les journaux d'échec détaillés des builds CircleCI. Cet outil peut être utilisé de trois manières :

1. Utilisation du slug de projet et de la branche (recommandé) :

   • Utilisez d'abord list_followed_projects pour obtenir vos projets, puis :
   • Exemple : « Obtenir les échecs de build pour mon-projet sur la branche principale »

2. Utilisation des URL CircleCI :

   • Fournissez directement une URL de tâche en échec ou une URL de pipeline
   • Exemple : « Obtenir les journaux depuis https://app.circleci.com/pipelines/github/org/repo/123 »

3. Utilisation du contexte de 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 : « Trouver le dernier pipeline en échec sur ma branche actuelle »

L'outil renvoie des journaux formatés comprenant :

• Les noms des tâches
• Les détails d'exécution étape par étape
• Les messages d'échec et le contexte

Récupère les métadonnées de test pour les tâches CircleCI, vous permettant d'analyser les résultats de test sans quitter votre IDE. Cet outil peut être utilisé de trois manières :

1. Utilisation du slug de projet et de la branche (recommandé) :

   • Exemple : « Obtenir les résultats de test pour mon-projet sur la branche principale »

2. Utilisation de l'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. Utilisation du contexte de 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ésumé de tous les tests (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
• Filtrer par résultat de test

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

1. Utilisation du slug de projet et de la branche (recommandé) :

   • Exemple : « Obtenir le statut du dernier pipeline pour mon-projet sur la branche principale »

2. Utilisation de l'URL du projet CircleCI :

   • Exemple : « Obtenir le statut du dernier pipeline pour https://app.circleci.com/pipelines/github/org/repo »

3. Utilisation du contexte de 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 travail CircleCI. Cet outil peut être utilisé de trois manières :

1. Utilisation du slug de projet et de la branche (recommandé) :

   • Utilisez d'abord list_followed_projects pour obtenir vos projets, puis :
   • Exemple : « Lister les artefacts pour mon-projet sur la branche principale »

2. Utilisation de l'URL CircleCI :

   • URL du travail : 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. Utilisation du contexte de 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

Liste toutes les versions d'un composant CircleCI spécifique dans un environnement. Inclut le statut de déploiement, les informations de commit et les horodatages.

L'outil vous demandera de sélectionner le composant et l'environnement s'ils ne sont pas fournis.

Utile pour :

• Identifier quelle version est actuellement en production
• Sélectionner les versions cibles pour les opérations de rollback
• Obtenir les détails de déploiement (pipeline, workflow, travail)

Liste tous les projets que l'utilisateur suit sur CircleCI.

• 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 (pas le nom du projet) est requis pour de nombreux autres outils CircleCI.

Relance un workflow depuis son début ou depuis le travail ayant échoué.

Renvoie l'ID du workflow nouvellement créé et un lien pour le surveiller.

Déclenche l'exécution d'un pipeline. Cet outil peut être utilisé de trois manières :

1. Utilisation du slug de projet et de la branche (recommandé) :

   • Exemple : « Exécuter le pipeline pour mon-projet sur la branche principale »

2. Utilisation de l'URL CircleCI :

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

3. Utilisation du contexte de 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 pour surveiller l'exécution du pipeline.

Déclenche un rollback pour un projet CircleCI. L'outil vous guide de manière interactive à travers :

1. Sélection du projet — liste les projets suivis pour que vous choisissiez
2. Sélection de l'environnement — liste les environnements disponibles (sélection automatique s'il n'y en a qu'un)
3. Sélection du composant — liste 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 pour le rollback
5. Détection du mode de rollback — vérifie si un pipeline de rollback est configuré
6. Exécution du rollback — deux options :
   • Rollback de pipeline : déclenche le pipeline de rollback
   • Relance de workflow : relance un workflow précédent en utilisant son ID de workflow
7. Confirmation — résume et confirme avant l'exécution

Problèmes les plus courants :

1. Vider les caches de packages :

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

2. Forcer la dernière version : Ajoutez @latest à votre configuration :

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

3. Redémarrez complètement votre IDE (pas seulement recharger la fenêtre)

• Erreurs de jeton invalide : Vérifiez votre CIRCLECI_TOKEN dans Jetons API personnels
• Erreurs de permission : Assurez-vous que le jeton a 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 : Confirmez que CIRCLECI_BASE_URL est https://circleci.com
• Réseaux d'entreprise : Configurez les paramètres de proxy npm si vous êtes derrière un pare-feu
• Blocage par pare-feu : Vérifiez si un logiciel de sécurité bloque les téléchargements de packages

• Version de Node.js : Assurez-vous d'avoir >= 18.0.0 avec node --version
• Mise à jour de Node.js : Envisagez la dernière LTS si vous rencontrez des problèmes de compatibilité
• Gestionnaire de packages : Vérifiez que npm/pnpm fonctionne : npm --version

• Emplacement du fichier de configuration : Vérifiez à nouveau le chemin pour votre système d'exploitation
• Erreurs de syntaxe : Validez la syntaxe JSON dans votre fichier de configuration
• Journaux de la console : Consultez la console de développement de l'IDE pour des erreurs spécifiques
• Essayez un autre IDE : Testez dans un autre éditeur pris en charge pour isoler le problème

Processus bloqués — tuez 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.

• Testez le package directement : npx @circleci/mcp-server-circleci@latest --help
• Journalisation verbeuse : DEBUG=* npx @circleci/mcp-server-circleci@latest
• Solution de repli Docker : Essayez l'installation Docker si npx échoue systématiquement

Besoin d'aide supplémentaire ?

1. Consultez Problèmes GitHub pour des problèmes similaires
2. Incluez votre système d'exploitation, la version de Node et l'IDE lors du signalement de problèmes
3. Partagez les messages d'erreur pertinents de la console de l'IDE