MCP-Server für KI-Assistenten

Das Model Context Protocol (MCP) ist ein offener Standard, über den KI-Assistenten Werkzeuge auf deinem Rechner benutzen. Die Build Station ist selbst ein MCP-Server: Die App stellt ihn unter einer lokalen Adresse bereit, solange sie läuft. Ein Assistent wie Claude Code oder Claude Desktop kann darüber Builds starten, Logs lesen, Artefakte hochladen und einen gescheiterten Build selbst reparieren.

Was der Assistent damit tun kann

Ein typischer Ablauf: Du bittest den Assistenten, eine neue Version für einen Kunden zu bauen und hochzuladen. Er startet den Build, wartet auf das Ende, liest bei einem Fehler das Log, behebt die Ursache im Code und versucht es erneut. Für Codemagic-Builds geht das genauso, inklusive Reparatur der codemagic.yaml.

Lokale Builds

Werkzeug	Was es tut
list_projects	Projekte mit Pfad, gekoppeltem Branch, Codemagic-Verknüpfung und Workflows
start_build	reiht einen lokalen Build ein, optional mit Version, Build-Nummer, flutter clean und Upload danach
list_runs	die letzten lokalen Läufe: Builds, Uploads, Reparaturen
get_run	ein Lauf im Detail: Status, Version, Git-Stand, Artefakte, Fehlerzeilen, offene Checklisten-Punkte
get_run_log	das Log eines Laufs, gekürzt auf die letzten Zeilen
wait_for_run	wartet, bis ein Lauf fertig ist
upload_build	lädt die Artefakte eines erfolgreichen Builds in die eingerichteten Stores, optional mit Release Notes
cancel_run	bricht einen laufenden oder wartenden Lauf ab
list_uploads	welche Version in welchem Store liegt, mit Commit, Tag und Release Notes

Reparatur

Werkzeug	Was es tut
diagnose_build	Befund und Reparaturvorschläge mit Diff zu einem gescheiterten Build, lokal oder in Codemagic
apply_build_fix	wendet einen Vorschlag mit Sicherung an
undo_build_fix	nimmt eine Anwendung zurück

Das sind dieselben Vorschläge, die auch die App über dem Log anzeigt, siehe Wenn ein Build scheitert.

Codemagic

Werkzeug	Was es tut
codemagic_list_builds	letzte Builds, optional nach Branch oder Workflow
codemagic_get_build	Status, Schritte, gescheiterte Schritte, Artefakte
codemagic_get_build_log	Log der gescheiterten Schritte bzw. eines Schritts
codemagic_start_build	Build auf Branch oder Tag starten, mit denselben Prüfungen wie die App
codemagic_wait_for_build	warten, bis der Build fertig ist
codemagic_cancel_build	Build abbrechen
codemagic_get_config	Inhalt, Workflows und Befunde der codemagic.yaml
codemagic_validate_config	Datei oder Entwurf prüfen, ohne zu schreiben
codemagic_write_config	codemagic.yaml schreiben, verweigert Inhalte mit Fehlern
codemagic_apply_fixes	automatische Korrekturen anwenden

Wie der Server arbeitet

Der MCP-Server läuft in der Build Station selbst, unter http://127.0.0.1:8788/mcp. Der Assistent verbindet sich per HTTP (MCP „Streamable HTTP“) und meldet sich mit einem Token an. Es gibt kein Zusatzprogramm zu installieren.

Lokale Builds und Uploads landen in der normalen Warteschlange. So gilt auch für Aufträge einer KI die Regel „pro Ordner eine Operation“, und du siehst jeden Lauf im Fenster und im Verlauf. Daraus folgt:

• Die Build Station muss laufen, damit der Assistent sie erreicht.
• Aufträge nimmt die App erst an, nachdem dem Nutzungshinweis zugestimmt wurde.

upload_build lädt wirklich hoch, in die Stores, die für das Projekt eingerichtet sind. Gib dem Assistenten dieses Werkzeug nur frei, wenn du das willst.

Was der Server bewusst nicht tut

Committen und pushen. Das bleibt beim Assistenten bzw. bei dir, mit den Rechten und Rückfragen, die dafür ohnehin gelten.

Schreiben darf der Server nur:

• die codemagic.yaml eines verknüpften Projekts
• über apply_build_fix die Dateien eines Reparaturvorschlags

Beides jeweils mit Sicherung, sodass sich eine Änderung zurücknehmen lässt.

Einrichten

Unter Einstellungen › MCP-Server zeigt die Station die Adresse, das Token und fertige Befehle zum Kopieren. Für Claude Code:

claude mcp add --transport http buildstation http://127.0.0.1:8788/mcp \
  --header "Authorization: Bearer <Token>"

Für ein Projekt kannst du den Server auch in die .mcp.json eintragen:

{
  "mcpServers": {
    "buildstation": {
      "type": "http",
      "url": "http://127.0.0.1:8788/mcp",
      "headers": { "Authorization": "Bearer <Token>" }
    }
  }
}

Claude Desktop startet nur lokale Programme. Dort bindest du die Adresse über npx mcp-remote an, das Node.js voraussetzt. Den fertigen Eintrag für claude_desktop_config.json zeigt die Station ebenfalls an. Andere MCP-Clients richtest du mit Adresse und Authorization-Header ein.

Token und Port

Das Token gilt pro Installation und öffnet nur /mcp, nicht die übrige Schnittstelle der App. Neues Token ersetzt es, das alte gilt dann sofort nicht mehr. Anfragen aus einer Webseite mit fremdem Origin lehnt der Server ab.

Ist Port 8788 belegt, weicht die Station auf einen freien Port aus und warnt in den Einstellungen, dass die Adresse nur bis zum nächsten Start gilt. Einen festen anderen Port trägst du als "port" in die Datei mcp.json im Ordner der App-Daten ein.

Von einem anderen Rechner

Läuft der Fernzugriff (mit Lizenz), ist der MCP-Server auch unter dessen Adresse erreichbar, mit demselben Token. Ohne HTTPS gilt dafür dasselbe wie für den Fernzugriff: nur im eigenen Netz oder hinter einem Proxy mit HTTPS.

Codemagic-Token für den Server

Der Server nutzt das Token aus dem Schlüsselbund, das du unter Einstellungen › Codemagic hinterlegt hast.

Sicherheit

Ein Assistent mit Zugriff auf diesen Server kann Builds starten, Dateien im Projekt ändern und Apps in Stores hochladen. Behalte die Freigaben deines MCP-Clients im Blick und lass schreibende Werkzeuge nur nach Rückfrage laufen. Was über die Werkzeuge hinaus an den Anbieter des Assistenten geht, etwa Logs und Code-Ausschnitte, regeln dessen Bedingungen.