CircleCI, verifiziert

MCP-Server von CircleCI · Verifiziert

Inspect CircleCI projects, pipelines, workflows, jobs, logs, tests and artifacts, and rerun or cancel workflows.

OAuth-Anmeldung (Beim ersten Verbinden meldest du dich beim Anbieter an)Streamable HTTP

Mit CircleCI verbinden

CircleCI braucht eine Anmeldung. Verbinde dich mit seiner eigenen URL:

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

Dein Client öffnet beim ersten Mal die Anmeldung von CircleCI. Das Token bleibt zwischen deinem Client und CircleCI.

Diesen Server teilen

Öffnet diese Seite, mit der URL und den Einrichtungsschritten.

mcp.tc/i/circleci

Über den Server

Connects an AI assistant to CircleCI so it can inspect projects, runs, workflows, jobs, logs, tests and artifacts. It is aimed at day-to-day diagnostic work: finding why a build failed, reading job logs, and rerunning or canceling workflows without leaving the editor.

The server is hosted by CircleCI at https://mcp.circleci.com/v1/mcp and uses streamable HTTP, so nothing is installed locally. Users sign in with OAuth, or send a CircleCI personal API token as a Bearer token in the Authorization header. It replaces the older local npx-based server, which is deprecated.

Was du damit machen kannst

  • Inspect projects, pipelines, workflows and jobs
  • Read job logs to diagnose build failures
  • View test results and artifacts
  • Rerun workflows
  • Cancel running workflows

Tools

CircleCI zeigt seine Tools erst nach der Anmeldung, deshalb können wir sie hier nicht auflisten. Dein Client zeigt sie, sobald du verbunden bist.

Beispiel-Prompts

  • Why did the latest workflow on main fail in my CircleCI project?

  • Show the logs for the failed job in my last pipeline.

  • Rerun the failed workflow from the most recent run.

  • Which tests failed in the last CircleCI run?

Einrichtung

Jeder Client verbindet sich mit mcp.circleci.com, und beim ersten Mal fragt CircleCI nach deiner Anmeldung. Wähl deinen; die Seite merkt sich deine Wahl.

Claude Code

  1. Führe das in einem Terminal in deinem Projektordner aus:
claude mcp add --transport http circleci https://mcp.circleci.com/v1/mcp
  1. Starte Claude Code, tippe /mcp, wähle circleci und dann Authenticate. Ein Browserfenster öffnet sich für die Anmeldung bei CircleCI.

Ergänze --scope user, damit er in jedem Projekt verfügbar ist, nicht nur in diesem.

Claude Desktop

  1. Öffne Settings → Connectors und klick auf Add custom connector.
  2. Nenne ihn CircleCI und füge diese URL ein:
https://mcp.circleci.com/v1/mcp
  1. Klick auf Add, dann auf Connect, und melde dich an, wenn CircleCI danach fragt.

Die JSON-Konfigurationsdatei von Claude Desktop startet nur lokale Server. Remote-Server laufen über Connectors, und Connectors, die du auf claude.ai hinzufügst, erscheinen auch hier.

claude.ai

  1. Öffne das Connector-Formular auf claude.ai. Dieser Button füllt Name und URL für dich aus:
  1. Prüfe, dass die URL https://mcp.circleci.com/v1/mcp lautet, und klick auf Add.
  2. Klick auf Connect und melde dich an, wenn CircleCI danach fragt.

Kostenlose Pläne erlauben einen benutzerdefinierten Connector. In Team- und Enterprise-Plänen fügt ihn ein Owner unter Organization settings → Connectors hinzu.

ChatGPT

  1. Öffne auf chatgpt.com Settings → Security and login und schalte Developer mode ein.
  2. Geh zu chatgpt.com/plugins und klick auf +, um eine App für einen Remote-MCP-Server anzulegen.
  3. Füge https://mcp.circleci.com/v1/mcp als Server-URL ein und wähle OAuth. ChatGPT schickt dich zur Anmeldung zu CircleCI.

Der Entwicklermodus steht im Web für Plus-, Pro-, Business-, Enterprise- und Education-Konten zur Verfügung.

Cursor

Oder trag ihn von Hand in ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (dieses Projekt) ein:

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

Cursor zeigt neben dem Server Needs login. Klick darauf, um dich anzumelden.

VS Code

Oder aus einem Terminal:

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

Oder committe ihn ins Repository in .vscode/mcp.json:

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

VS Code bittet dich beim ersten Start des Servers um eine Anmeldung.

Devin Desktop

  1. Füge ihn zu ~/.config/devin/mcp_config.json (macOS und Linux) oder %APPDATA%\devin\mcp_config.json (Windows) hinzu:
mcp_config.json
{
  "mcpServers": {
    "circleci": {
      "serverUrl": "https://mcp.circleci.com/v1/mcp"
    }
  }
}
  1. Aktualisiere die Liste der MCP-Server in Cascade und melde dich an, wenn du gefragt wirst.

Devin Desktop ist der neue Name von Windsurf. Für Remote-Server liest es serverUrl (oder url).

Codex

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

Oder bearbeite ~/.codex/config.toml direkt:

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

Führe dann in Gemini CLI /mcp auth circleci aus, um dich anzumelden.

Damit fügst du ihn dem aktuellen Projekt hinzu. Ergänze -s user, um ihn überall zu nutzen.

Jeder Client

Die meisten Clients akzeptieren diese Form. Manche nennen das URL-Feld anders: serverUrl in Devin Desktop, httpUrl in der Einstellungsdatei von Gemini CLI.

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

Zed legt Server in seinen Einstellungen unter context_servers ab. Cline braucht "type": "streamableHttp", sonst nimmt es SSE an.

Dein Client startet nur lokale Server? Binde ihn mit npx -y mcp-remote https://mcp.circleci.com/v1/mcp an.

Häufige Fragen

Kann ich mcp.tc/i/circleci in meinen MCP-Client einfügen?

Nein. mcp.tc-Links sind Seiten, keine Server-Adressen. Verbinde dich mit https://mcp.circleci.com/v1/mcp, damit dein Client direkt mit CircleCI spricht. Das Anmelde-Token funktioniert ohnehin nur dort. Der Quick-Link ist zum Teilen da: Er öffnet diese Seite, mit Einrichtungsschritten für jeden Client.

Braucht CircleCI einen API-Schlüssel oder eine Anmeldung?

Ja, du brauchst ein Konto bei CircleCI. Wenn sich dein Client zum ersten Mal verbindet, öffnet er die Anmeldeseite von CircleCI. Das Token geht direkt an die eigene URL des Servers, nie über mcp.tc.

Ist CircleCI ein Remote- oder ein lokaler Server?

Remote. CircleCI hostet ihn unter https://mcp.circleci.com/v1/mcp, und er spricht Streamable HTTP. Es gibt nichts zu installieren.

Welche Clients können ihn nutzen?

Jeder Client, der Remote-MCP-Server unterstützt: Claude Code, Claude Desktop, claude.ai, ChatGPT im Entwicklermodus, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed und andere. Die Einrichtungsschritte decken jeden davon ab.

Wer hat diese Seite geschrieben?

Der Roboter von mcp.tc hat die eigenen Metadaten von CircleCI (seinen MCP-Handshake, seine Tool-Liste und öffentliche Seiten) gelesen, und ein KI-Modell hat daraus den Text entworfen. Ein Mensch prüft alles, was die Prüfungen nicht bestätigen können. Der Text kann trotzdem falsch sein; wenn dir ein Fehler auffällt, nutze Eintrag melden auf dieser Seite.

Einbinden

Zeig CircleCI in einem README oder auf deiner Website. Jede Einbindung verlinkt auf diese Seite, nutzt die eigene URL des Servers und setzt keine Cookies. So funktionieren Einbindungen

README-Badge

Badge-Vorschau, hellBadge-Vorschau, dunkel
Markdown
[![CircleCI on mcp.tc](https://mcp.tc/i/circleci/badge.svg)](https://mcp.tc/i/circleci)
HTML
<a href="https://mcp.tc/i/circleci"><img src="https://mcp.tc/i/circleci/badge.svg" alt="CircleCI on mcp.tc" height="20"></a>

Es folgt dem hellen oder dunklen Modus der Lesenden. Hänge ?theme=light oder ?theme=dark an, um ihn festzulegen, oder ?style=compact, um das Zeichen ohne Schriftzug zu zeigen.

Website-Karte

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

Die Karte erscheint dort, wo das Tag steht. Füge dem Tag data-theme="dark" oder data-size="compact" hinzu, um sie zu ändern. Die Datei enthält alles, was sie braucht, stellt also keine weiteren Anfragen und setzt keine Cookies.

iframe

HTML
<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>

Nutze es auf Seiten, die keine Skripte erlauben. Hänge ?theme=light oder ?theme=dark an die Adresse an, um die Farben festzulegen.

JSON

Der Eintrag als Daten für deine eigenen Seiten und Tools: Name, Kurzbeschreibung, die eigene URL des Servers, Tools und die „Add to“-Links. Jede Website kann ihn lesen (CORS ist offen).

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

Was jedes Feld bedeutet

mcp.tc ist nicht mit CircleCI verbunden. Diese Seite entstand aus den öffentlichen Metadaten von CircleCI, zuletzt geprüft am 3. Okt. 2026, und ein KI-Modell hat die Beschreibung geschrieben, sie kann also Fehler enthalten. Namen und Marken gehören ihren Inhabern. Stimmt etwas nicht? Eintrag melden.