codemagic_mcp

Servidor MCP para la API de CI/CD de Codemagic. Bun + TypeScript, transporte stdio.

Herramientas

Aplicaciones

• codemagic_get_all_applications

• codemagic_get_application

• codemagic_add_application

• codemagic_add_application_private

Compilaciones

• codemagic_start_build

• codemagic_get_builds

• codemagic_get_build_status

• codemagic_cancel_build

Artefactos

• codemagic_get_artifact (devuelve metadatos + vista previa en base64; utilice la herramienta de URL pública para descargas completas)

• codemagic_create_public_artifact_url

Cachés

• codemagic_get_app_caches

• codemagic_delete_all_app_caches

• codemagic_delete_app_cache

Equipos

• codemagic_invite_team_member

• codemagic_delete_team_member

Configuración

Variables de entorno:

Ejecución

bun install
CODEMAGIC_API_KEY=... bun run start

Modo de observación:

CODEMAGIC_API_KEY=... bun run dev

Inspeccionar con el inspector oficial de MCP:

CODEMAGIC_API_KEY=... bun run inspect

Configuración de Claude Code / Claude Desktop

Configuración en una línea:

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

O manualmente en claude_desktop_config.json:

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

Notas de seguridad

• La clave API se lee solo desde el entorno.

• Las solicitudes salientes envían la clave a través de x-auth-token; nunca se registra.

• Toda la salida de la herramienta (texto y estructurada) se procesa a través de un redactor que enmascara el valor de la clave y cualquier clave de objeto que coincida con authorization, x-auth-token, api[-_]?key, password, passphrase, ssh[-_]?key, secret o token.

• Los errores se asignan a clases tipadas (CodemagicAuthError, CodemagicNotFoundError, CodemagicValidationError, CodemagicRateLimitError, CodemagicServerError, CodemagicNetworkError) y se muestran como mensajes procesables; los seguimientos de pila internos no se exponen al cliente.

Diseño

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