CircleCI MCP-Server

Verbinden Sie Ihren KI-Assistenten mit Ihren CircleCI-Daten, um Fehler zu debuggen, Testergebnisse zu analysieren und Pipelines mithilfe natürlicher Sprache zu verbessern.

MCP-Überblick
Was MCP leisten kann
Jetzt starten
Verfügbare Werkzeuge
Mehr erfahren

CI/CD-Kontext für KI-Tools

Der CircleCI MCP-Server macht Ihr Build-System für Cursor, Claude Code, Windsurf und andere KI-Tools verständlich. Er basiert auf dem Model Context Protocol (MCP), einem leichtgewichtigen Standard, der es LLM-gestützten Agenten ermöglicht, strukturierte Daten aus externen Systemen abzurufen.

Durch die Verbindung mit dem CircleCI MCP-Server erhalten Agenten Echtzeit-Einblick in:

Build-Protokolle und Testergebnisse
Pipeline-Status
Aktuelle Konfigurationsänderungen
Workflow-Leistungsmetriken

Das bedeutet, dass Sie sich nicht mehr durch Jobprotokolle oder Dashboard-Benutzeroberflächen wühlen müssen, sondern einfach fragen können:

why did my last build fail?

und erhalten alle Informationen, die Sie benötigen, um das Problem zu beheben und ohne Unterbrechung weiterzuarbeiten.

Build-Daten in Maßnahmen umsetzen

Nach der Installation macht der MCP-Server Ihre CI/CD-Daten über natürliche Sprache zugänglich. LLM-basierte Werkzeuge können:

Fehlerhafte Builds diagnostizieren
Strukturierte Fehlerzusammenfassungen und Logs.

Fehler zu den letzten Änderungen zurückverfolgen
Regressionen mit Commits, Diffs oder Workflows verknüpfen.

Flagy-Tests erkennen
Oberflächeninstabilitätsmuster aus der Testhistorie.

Verbesserungen empfehlen
Konfigurations- oder Timing-Optimierungen im Kontext vorschlagen.

CI-Daten in Ihren Editor einbinden
LLM-Tools verwenden, um Builds zu durchdenken, ohne zwischen Tabs wechseln zu müssen.

Mit Zugriff auf Code und Build-Kontext können Sie mit diesen Tools Fehler schneller beheben, Änderungen sicher bereitstellen und sich auf die wirklich wichtigen Aufgaben konzentrieren.

Jetzt mit MCP starten

Der CircleCI MCP Server läuft lokal und lässt sich in eine Vielzahl von Editoren und LLM-Entwicklungstools integrieren.

Nachfolgend finden Sie sofort einsatzbereite Konfigurationsbeispiele für die Installation des MCP Servers in Ihrer bevorzugten Umgebung.

Voraussetzungen

Stellen Sie vor der Einrichtung Ihrer IDE sicher, dass folgende Voraussetzungen erfüllt sind:

CircleCI Personal API Token (PAT):
- Navigieren Sie zu Benutzereinstellungen > Persönliche API-Token
- Klicken Sie auf Neues Token erstellen
- Kopieren Sie es und bewahren Sie es sicher auf – Sie benötigen es als CIRCLECI_TOKEN bei der Einrichtung
Für die NPX-Installation:
- pnpm-Paketmanager
- Node.js Version ≥ 18.0.0
Für die Docker-Installation:
- Docker

Konfigurationsanleitungen

Cursor

Mit NPX:


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

Mit Docker:


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

Cursor-Einrichtungsdokumentation

VS Code

Mit NPX:


{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "CircleCI API-Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "circleci-base-url",
      "description": "CircleCI Basis-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}"
      }
    }
  }
}

Mit Docker:


{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "CircleCI API-Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "circleci-base-url",
      "description": "CircleCI Basis-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}"
      }
    }
  }
}

VS Code-Einrichtungsdokumentation

Claude Desktop

Mit NPX:


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

Mit Docker:


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

Speicherort der Konfigurationsdatei:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Desktop-Einrichtungsdokumentation

Claude Code

Mit NPX:


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

Mit Docker:


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

Claude Code-Einrichtungsdokumentation

Windsurf

Mit NPX:


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

Mit Docker:


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

Windsurf-Einrichtungsdokumentation

Amazon Q Developer / Kiro

Voraussetzungen:

CircleCI Personal API Token
NPX: Node.js >= v18 und pnpm

Konfigurationsdateien:
Amazon Q Developer und Kiro CLI speichern die MCP-Client-Konfiguration im JSON-Format. Die Konfigurationspfade unterscheiden sich je nach verwendetem Tool:

Amazon Q Developer:
- Lokal: .amazonq/agents/default.json
- Global: ~/.aws/amazonq/agents/default.json

Kiro CLI:
- Arbeitsbereich: .kiro/settings/mcp.json
- Global: ~/.kiro/settings/mcp.json

Die oben genannten Amazon Q Developer-Pfade gelten für den Standard-Agenten. Bei der Verwendung benutzerdefinierter Agenten fügen Sie die MCP-Server-Konfiguration stattdessen zur Konfigurationsdatei des jeweiligen Agenten hinzu.

Beide sind optional. Falls beide vorhanden sind, wird die Konfiguration aus beiden Quellen gelesen. Ist derselbe Server in beiden definiert, hat die lokale/arbeitsbereichsbezogene Konfiguration Vorrang.

Mit NPX (lokaler MCP Server):

Fügen Sie Folgendes zu Ihrer Konfigurationsdatei hinzu:

{
  "mcpServers": {
    "circleci-local": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com" // optional, nur für On-Premises erforderlich
      },
      "timeout": 60000
    }
  }
}

Mit einem selbstverwalteten Remote-MCP-Server:

Erstellen Sie ein Wrapper-Skript (z. B. circleci-remote-mcp.sh):

#!/bin/bash
export CIRCLECI_TOKEN="your-circleci-token"
npx mcp-remote http://your-circleci-remote-mcp-server-endpoint:8000/mcp --allow-http

Machen Sie es ausführbar:

chmod +x circleci-remote-mcp.sh

Hinzufügen des Remote-Servers:

Über Kiro CLI:

kiro-cli mcp add --name circleci --command "/full/path/to/circleci-remote-mcp.sh"

Über die Amazon Q MCP-Konfigurationsoberfläche:

Globalen oder lokalen Gültigkeitsbereich wählen
Servernamen eingeben (z. B. circleci-remote-mcp)
Transportprotokoll festlegen: stdio
Befehl festlegen: Pfad zum Wrapper-Skript (z. B. /full/path/to/circleci-remote-mcp.sh)
Konfiguration speichern

Mit Smithery installieren


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

Verfügbare Werkzeuge

Von der Beschleunigung KI-gestützter Entwicklung bis zur Orchestrierung agentischer Workflows – jedes vom MCP Server bereitgestellte Tool versorgt KI-Entwickler mit strukturiertem CI/CD-Kontext für schnellere und zuverlässigere Release-Zyklen.

Tool	Verwendung
`config_helper`	Konfigurationsprobleme beheben, bevor sie die Pipeline unterbrechen
`create_prompt_template`	Prompts generieren, die konsistentes KI-Verhalten unterstützen
`find_flaky_tests`	Instabile Tests identifizieren und beheben
`get_build_failure_logs`	Fehlgeschlagene Builds schneller debuggen und beheben
`get_job_test_results`	Testfehler und Performance-Probleme analysieren und lösen
`get_latest_pipeline_status`	Pipeline-Zustand überwachen und darauf reagieren
`list_followed_projects`	Beobachtete Projekte und deren `projectSlug` finden
`recommend_prompt_template_tests`	Prompt-Zuverlässigkeit testen und verbessern
`rerun_workflow`	Workflows von Beginn an oder ab einem fehlgeschlagenen Job erneut ausführen
`run_pipeline`	Builds direkt aus dem Editor heraus auslösen
`run_rollback_pipeline`	Fehlerhafte Deployments mit einem einzigen Befehl zurückrollen

Mehr erfahren

Starten Sie mit dem CircleCI MCP Server, erkunden Sie Beispiele oder bleiben Sie über Plattform-Updates auf dem Laufenden:

Projekt-Repository – Quellcode, Issues und Beitragsleitfaden.
MCP Cookbook – Prompt-Beispiele und Tool-Verwendungsmuster.
Blogbeitrag: Einführung des CircleCI MCP Servers – Hintergrund zum Design und Anwendungsfälle.
CircleCI Changelog – Die neuesten Plattform-Updates und Feature-Releases einsehen.

Überblick

Funktionen

Integrationen

Rolle

Anwendungsfall

Unternehmensgröße

Entwickler

Entdecken

Community

Vorteile

Vergleichen

Unternehmen

Überblick

Funktionen

Integrationen

Rolle

Anwendungsfall

Unternehmensgröße

Entwickler

Entdecken

Community

Vorteile

Vergleichen

Unternehmen

CircleCI MCP-Server

CI/CD-Kontext für KI-Tools

Build-Daten in Maßnahmen umsetzen

Jetzt mit MCP starten

Voraussetzungen

Konfigurationsanleitungen

Verfügbare Werkzeuge

Mehr erfahren