CircleCI, vérifié

Claude Code

1. Lancez ceci dans un terminal, dans le dossier de votre projet :

claude mcp add --transport http circleci https://mcp.circleci.com/v1/mcp

1. Démarrez Claude Code, tapez /mcp, choisissez circleci puis Authenticate. Une fenêtre de navigateur s’ouvre pour la connexion à CircleCI.

Ajoutez --scope user pour le rendre disponible dans tous vos projets, pas seulement celui-ci.

Claude Desktop

1. Ouvrez Settings → Connectors et cliquez sur Add custom connector.
2. Nommez-le CircleCI et collez cette URL :

https://mcp.circleci.com/v1/mcp

1. Cliquez sur Add, puis sur Connect, et connectez-vous quand CircleCI le demande.

Le fichier de configuration JSON de Claude Desktop ne lance que des serveurs locaux. Les serveurs distants passent par les Connectors, et les connecteurs ajoutés sur claude.ai apparaissent aussi ici.

claude.ai

1. Ouvrez le formulaire des connecteurs sur claude.ai. Ce bouton remplit le nom et l’URL pour vous :

Ajouter à claude.ai (s’ouvre dans un nouvel onglet)

1. Vérifiez que l’URL est https://mcp.circleci.com/v1/mcp et cliquez sur Add.
2. Cliquez sur Connect et connectez-vous quand CircleCI le demande.

Les offres gratuites permettent un connecteur personnalisé. Sur les offres Team et Enterprise, un propriétaire l’ajoute dans Organization settings → Connectors.

ChatGPT

1. Sur chatgpt.com, ouvrez Settings → Security and login et activez Developer mode.
2. Allez sur chatgpt.com/plugins et cliquez sur + pour créer une application pour un serveur MCP distant.
3. Collez https://mcp.circleci.com/v1/mcp comme URL du serveur et choisissez OAuth. ChatGPT vous envoie chez CircleCI pour vous connecter.

Le mode développeur est disponible sur le web pour les comptes Plus, Pro, Business, Enterprise et Education.

Cursor

Ajouter à Cursor (s’ouvre dans un nouvel onglet)

Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :

{
  "mcpServers": {
    "circleci": {
      "url": "https://mcp.circleci.com/v1/mcp"
    }
  }
}

Cursor affiche Needs login à côté du serveur. Cliquez dessus pour vous connecter.

VS Code

Installer dans VS Code (s’ouvre dans un nouvel onglet)

Ou depuis un terminal :

code --add-mcp '{"name":"circleci","type":"http","url":"https://mcp.circleci.com/v1/mcp"}'

Ou committez-le dans le dépôt, dans .vscode/mcp.json :

{
  "servers": {
    "circleci": {
      "type": "http",
      "url": "https://mcp.circleci.com/v1/mcp"
    }
  }
}

VS Code vous demande de vous connecter au premier démarrage du serveur.

Devin Desktop

1. Ajoutez-le à ~/.config/devin/mcp_config.json (macOS et Linux) ou %APPDATA%\devin\mcp_config.json (Windows) :

{
  "mcpServers": {
    "circleci": {
      "serverUrl": "https://mcp.circleci.com/v1/mcp"
    }
  }
}

1. Actualisez la liste des serveurs MCP dans Cascade et connectez-vous quand c’est demandé.

Devin Desktop est le nouveau nom de Windsurf. Pour les serveurs distants, il lit serverUrl (ou url).

Codex

codex mcp add circleci --url https://mcp.circleci.com/v1/mcp
codex mcp login circleci

Ou modifiez directement ~/.codex/config.toml :

[mcp_servers.circleci]
url = "https://mcp.circleci.com/v1/mcp"

Gemini CLI

gemini mcp add --transport http circleci https://mcp.circleci.com/v1/mcp

Puis, dans Gemini CLI, lancez /mcp auth circleci pour vous connecter.

Cela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.

Tout client

La plupart des clients acceptent cette forme. Certains nomment autrement le champ de l’URL : serverUrl dans Devin Desktop, httpUrl dans le fichier de réglages de Gemini CLI.

{
  "mcpServers": {
    "circleci": {
      "type": "http",
      "url": "https://mcp.circleci.com/v1/mcp"
    }
  }
}

Zed place les serveurs sous context_servers dans ses réglages. Cline a besoin de "type": "streamableHttp", sinon il suppose SSE.

Votre client ne lance que des serveurs locaux ? Reliez-le avec npx -y mcp-remote https://mcp.circleci.com/v1/mcp.

Badge pour README

[![CircleCI on mcp.tc](https://mcp.tc/i/circleci/badge.svg)](https://mcp.tc/i/circleci)

<a href="https://mcp.tc/i/circleci"><img src="https://mcp.tc/i/circleci/badge.svg" alt="CircleCI on mcp.tc" height="20"></a>

Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.

Carte pour site web

<script src="https://mcp.tc/w/circleci.js" async></script>

La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun cookie.

iframe

<iframe src="https://mcp.tc/embed/circleci" title="CircleCI on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.

JSON

La fiche sous forme de données pour vos pages et vos outils : nom, accroche, URL du serveur, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).

https://mcp.tc/i/circleci.json

Ce que signifie chaque champ