codemagic_mcp

MCP-Server für die Codemagic CI/CD-API. Bun + TypeScript, stdio-Transport.

Tools

Apps

• codemagic_get_all_applications

• codemagic_get_application

• codemagic_add_application

• codemagic_add_application_private

Builds

• codemagic_start_build

• codemagic_get_builds

• codemagic_get_build_status

• codemagic_cancel_build

Artefakte

• codemagic_get_artifact (gibt Metadaten + base64-Vorschau zurück; verwenden Sie das Tool für öffentliche URLs für vollständige Downloads)

• codemagic_create_public_artifact_url

Caches

• codemagic_get_app_caches

• codemagic_delete_all_app_caches

• codemagic_delete_app_cache

Teams

• codemagic_invite_team_member

• codemagic_delete_team_member

Konfiguration

Umgebungsvariablen:

Ausführen

bun install
CODEMAGIC_API_KEY=... bun run start

Watch-Modus:

CODEMAGIC_API_KEY=... bun run dev

Mit dem offiziellen MCP-Inspektor untersuchen:

CODEMAGIC_API_KEY=... bun run inspect

Claude Code / Claude Desktop Konfiguration

Einzeilige Einrichtung:

claude mcp add codemagic --scope user \
  -e CODEMAGIC_API_KEY=<your_key> \
  -- bunx codemagic_mcp

Oder manuell in claude_desktop_config.json:

{
  "mcpServers": {
    "codemagic": {
      "command": "bunx",
      "args": ["codemagic_mcp"],
      "env": { "CODEMAGIC_API_KEY": "..." }
    }
  }
}

Sicherheitshinweise

• Der API-Schlüssel wird nur aus der Umgebung gelesen.

• Ausgehende Anfragen senden den Schlüssel über x-auth-token; er wird niemals protokolliert.

• Alle Tool-Ausgaben (Text und strukturiert) werden durch einen Redactor geleitet, der den Schlüsselwert sowie alle Objektschlüssel maskiert, die authorization, x-auth-token, api[-_]?key, password, passphrase, ssh[-_]?key, secret oder token entsprechen.

• Fehler werden typisierten Klassen zugeordnet (CodemagicAuthError, CodemagicNotFoundError, CodemagicValidationError, CodemagicRateLimitError, CodemagicServerError, CodemagicNetworkError) und als umsetzbare Nachrichten ausgegeben — interne Stack-Traces werden dem Client nicht offengelegt.

Layout

src/
  index.ts          stdio entrypoint
  schemas.ts        Zod input schemas
  lib/
    config.ts       env loading + validation
    client.ts       fetch wrapper: timeouts, retries, status mapping
    errors.ts       typed error classes + user-facing formatter
    redact.ts       secret/string + key-pattern redaction
    response.ts     jsonResult / textResult / errorResult helpers
  tools/
    apps.ts builds.ts artifacts.ts caches.ts teams.ts