Buildkite über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Buildkite klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Buildkite + Gemini

Prüfe Buildkite aus deinem KI-Agent: Pipelines, Builds und Jobs, Job-Logs, Artefakte und Annotations, Agents, Cluster und Queues sowie Test-Engine-Suites mit instabilen und langsamen Tests; nach deiner Bestätigung Builds starten, neu bauen und wiederholen, Schritte freigeben und Annotations hinzufügen.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

BUILDKITE_API_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 3 Minuten. Du brauchst ein Buildkite-Konto mit Zugriff auf die Organisation.

1. Öffne in Buildkite deinen Avatar, Personal Settings, API Access Tokens (https://buildkite.com/user/api-access-tokens) und klicke auf New API Access Token.
2. Wähle die Organisationen und diese Scopes: read_builds, read_build_logs, read_pipelines, read_artifacts, read_agents, read_clusters, read_organizations, read_user und für Test Engine read_suites. Für die Schreibaktionen kommt write_builds dazu. Lass weg, was die KI nicht tun soll.
3. Füge das Token (es beginnt meist mit bkua_) in BUILDKITE_API_TOKEN ein. Es wird als Authorization: Bearer <token> nur an api.buildkite.com gesendet, und die KI handelt als der Benutzer, dem es gehört.
4. Installiere den Connector und führe buildkite_get_access_token aus: Es zeigt die Scopes des Tokens. Danach listet buildkite_list_organizations die Slugs der Organisationen.

Slugs und Nummern: Die Tools nehmen den Slug der Organisation (org) und den Slug der Pipeline (pipeline) wie in buildkite.com/<org>/<pipeline> und die Build-Nummer (#123), nicht die UUID des Builds. Jobs, Artefakte und Agents nutzen UUIDs. buildkite_list_test_runs filtert nach der UUID des Builds (dessen id).

Was er liest:

• Organisationen und Pipelines: buildkite_get_current_user, buildkite_list_organizations, buildkite_get_organization, buildkite_list_pipelines (Filter nach Teil des Namens oder der Repository-URL) und buildkite_get_pipeline mit Repository, Default-Branch, Branch-Filtern, Cluster und den YAML-Steps.
• Builds: buildkite_list_builds für die ganze Organisation oder buildkite_list_pipeline_builds für eine Pipeline, neueste zuerst, gefiltert nach Branch, Status (failed, running, blocked und weitere), Commit, Ersteller oder Datum. Jobs lassen sie standardmäßig weg; buildkite_get_build zeigt sie mit Status, Exit-Code, Step-Key und Agent.
• Warum ein Build fehlgeschlagen ist: buildkite_list_jobs mit state auf failed, dann buildkite_get_job und buildkite_get_job_log, das das Ende des Logs als Klartext liefert, standardmäßig die letzten 100.000 Bytes, wo der Fehler meist steht (tail_bytes bis 5.000.000). buildkite_list_annotations enthält oft die Test- oder Coverage-Zusammenfassung.
• Artefakte: buildkite_list_build_artifacts, buildkite_list_job_artifacts (Filter nach Status oder Pfad-Glob) und buildkite_get_artifact mit Größe, MIME-Typ, SHA1 und Download-URL; die Datei selbst öffnet sich in der Buildkite-App.
• Agents und Kapazität: buildkite_list_agents (Hostname, Version, Queue, Tags, Verbindungsstatus, aktueller Job), buildkite_get_agent, buildkite_list_clusters, buildkite_get_cluster und buildkite_list_cluster_queues (ob das Dispatching pausiert ist).
• Test Engine: buildkite_list_test_suites, buildkite_list_tests mit Zuverlässigkeit, Laufzeiten, Ausführungszahlen, Labels wie flaky und Ownern (sort_by=reliability mit order=asc für die unzuverlässigsten), buildkite_get_test mit Flakiness-Scores, buildkite_list_test_runs, buildkite_get_test_run und buildkite_list_failed_executions mit Fehlergrund und auf Wunsch dem Backtrace.

Was er nach deiner Bestätigung ändert: buildkite_create_build (Pipeline, Commit, Branch, Nachricht, Umgebung), buildkite_rebuild_build, buildkite_retry_failed_jobs, buildkite_retry_job, buildkite_unblock_job und buildkite_create_annotation. Builds führen echte Steps auf deinen Agents aus, auch Deployments, und verbrauchen Rechenzeit. Deshalb nennt die KI Pipeline, Build und Branch und wartet auf dein Ja. buildkite_unblock_job gibt ein manuelles Gate frei, oft das vor der Produktion: Die KI ruft es nur auf, wenn du es ausdrücklich sagst.

Bei der Installation abgeschaltet: buildkite_cancel_build. Ein abgebrochener Build stoppt seine laufenden Jobs, kann ein Deployment halb fertig zurücklassen und lässt sich nicht fortsetzen, nur neu bauen. Ein Workspace-Admin schaltet es ein, wenn das Team es braucht.

Datenformate: Status sind kleingeschrieben (passed, failed, running, blocked, canceled). Zeiten sind ISO 8601 in UTC. web_url öffnet Build oder Job in Buildkite. Log-Zeilen können ANSI-Farbcodes enthalten. Testlaufzeiten sind in Sekunden, die Zuverlässigkeit ist ein Bruch (0,95 = 95 %).

Paging: Listen-Tools nehmen page und per_page (Standard 30, bis 100). Gibt es mehr Ergebnisse, enthält die Antwort _pagination.nextUrl; die KI fragt die nächste page ab (bei buildkite_list_jobs mit after), bis _pagination fehlt. Sehr tiefe Build-Listen antworten mit 400; die KI grenzt sie dann mit branch oder created_from ein.

Limits: Buildkite begrenzt REST-Aufrufe pro Organisation und pro Benutzer und Minute und antwortet mit 429, wenn eines davon aufgebraucht ist; warte die Sekunden aus RateLimit-Reset ab und versuche es erneut.

Häufige Fehler: 401 bedeutet, dass das Token falsch, abgelaufen oder widerrufen ist. 403 bedeutet, dass dem Token der Scope für den Aufruf fehlt (prüfe mit buildkite_get_access_token) oder es keinen Zugriff auf diese Organisation hat. 404 bedeutet einen falschen Slug, eine falsche Nummer oder ID. 422 erklärt, warum ein Build oder Job nicht erstellt, wiederholt oder freigegeben werden kann.

Der Connector liest keine Umgebungsvariablen von Jobs (sie enthalten Secrets), löscht keine Logs, Artefakte, Annotations oder Pipelines, erstellt oder ändert keine Pipelines, Cluster, Queues oder Agent-Tokens, stoppt oder pausiert keine Agents und deckt Teams, Mitglieder, Audit-Events, Package Registries und Teststatus-Änderungen wie Mute und Skip nicht ab.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Buildkite-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Warum ist der letzte Build der Pipeline api auf main fehlgeschlagen? Zeig mir den Fehler aus dem Log des fehlgeschlagenen Jobs.“
• „Welche Builds sind gerade blockiert und warten auf eine Freigabe?“
• „Liste die 10 unzuverlässigsten Tests unserer Test-Engine-Suite der letzten 7 Tage auf.“
• „Wiederhole die fehlgeschlagenen Jobs von Build #4821 in der Pipeline web.“
• „Wie viele Agents sind in der Default-Queue verbunden, und welche davon sind beschäftigt?“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden