Servidor MCP de Codemagic

Un servidor MCP de Python local que expone la API REST de CI/CD de Codemagic como herramientas invocables por Claude. Inicia compilaciones, gestiona aplicaciones, descarga artefactos y limpia cachés, todo desde Claude Code o Claude Desktop sin salir del chat.

Herramientas

Aplicaciones

Compilaciones

Artefactos

Cachés

Variables de entorno

Webhooks

⚠️ Estas herramientas están marcadas como destructivas y solicitarán confirmación antes de ejecutarse.

Inicio rápido

La forma más rápida de empezar con Claude Code — no se necesita ningún paso de instalación por separado:

# 1. Add the server (uses uvx to run it on-demand)
claude mcp add codemagic -e CODEMAGIC_API_KEY=your-api-key-here -- uvx codemagic-mcp

# 2. Restart Claude Code — tools will appear in /tools

Eso es todo. Consulta Configuración para ver ajustes opcionales como CODEMAGIC_DEFAULT_APP_ID.

Instalación

Requisitos: Python 3.11+

Opción 1 — uvx (recomendado, no requiere instalación)

uvx codemagic-mcp

Opción 2 — pip

pip install codemagic-mcp

Opción 3 — desde el código fuente

git clone https://github.com/AgiMaulana/CodemagicMcp.git
cd CodemagicMcp
python3 -m venv .venv
.venv/bin/pip install -e .

Configuración

Obtén tu token de API en Codemagic User Settings → Integrations → Codemagic API.

Puedes proporcionar los ajustes como variables de entorno o mediante un archivo .env:

# .env
CODEMAGIC_API_KEY=your-api-key-here

# Optional: set a default app so you don't have to specify it every time
CODEMAGIC_DEFAULT_APP_ID=your-app-id-here

# Optional: customize managed temp log storage for get_step_logs(..., delivery="file")
CODEMAGIC_LOG_TEMP_DIR=/tmp/codemagic-mcp
CODEMAGIC_LOG_TTL_SECONDS=3600
CODEMAGIC_LOG_CLEANUP_INTERVAL_SECONDS=300
CODEMAGIC_LOG_MAX_TOTAL_BYTES=524288000
CODEMAGIC_LOG_MAX_FILE_COUNT=200

ID de aplicación predeterminado

CODEMAGIC_DEFAULT_APP_ID es opcional pero recomendado si trabajas principalmente con una aplicación. Cuando se establece, la IA lo usará automáticamente siempre que una herramienta requiera un app_id y no se haya especificado ninguno. Si no se establece, la IA:

1. Llamará a list_apps para descubrir las aplicaciones disponibles.

2. Usará la aplicación automáticamente si solo existe una.

3. Presentará la lista y te pedirá que elijas si se encuentran varias aplicaciones.

Entrega de archivos de registro de pasos

get_step_logs admite dos modos de entrega:

• delivery="file" es el predeterminado y escribe el registro en un archivo temporal local gestionado, devolviendo metadatos como artifact_id, file_path, bytes, line_count y expires_at.

• delivery="inline" devuelve el texto del registro del paso sin procesar directamente.

El modo de archivo local es útil cuando un registro de paso es demasiado grande para devolverlo cómodamente en línea. Los archivos de registro gestionados se almacenan en CODEMAGIC_LOG_TEMP_DIR y los archivos caducados se limpian de forma oportunista cada vez que se escribe un nuevo archivo de registro. La ventana de retención predeterminada está controlada por CODEMAGIC_LOG_TTL_SECONDS y es de 3600 segundos por defecto.

El servidor también ejecuta una pasada de limpieza al inicio y un bucle de limpieza en segundo plano periódico. El intervalo del bucle está controlado por CODEMAGIC_LOG_CLEANUP_INTERVAL_SECONDS y es de 300 segundos por defecto. Como medida de seguridad adicional, el directorio temporal gestionado está limitado por CODEMAGIC_LOG_MAX_TOTAL_BYTES y CODEMAGIC_LOG_MAX_FILE_COUNT; cuando se supera cualquiera de los límites, se eliminan primero los archivos más antiguos.

get_step_log_artifact(build_id, step_id) comprueba si ese artefacto gestionado todavía existe sin volver a llamar a Codemagic ni devolver el contenido del archivo. Los metadatos del artefacto incluyen un artifact_id determinista en este formato:

artifact_<build_id>_<step_id>

Si el artefacto falta, el servidor devuelve status="missing" con el motivo not_generated_or_expired, lo que significa que el archivo nunca se generó o caducó y fue eliminado.

Registrar con Claude Code

Ejecuta el siguiente comando para añadir el servidor:

claude mcp add codemagic -- codemagic-mcp

Luego establece tu clave API en la configuración de entorno de MCP, o expórtala en tu shell antes de iniciar Claude Code:

export CODEMAGIC_API_KEY=your-api-key-here

Alternativamente, añádelo manualmente a ~/.claude.json:

{
  "mcpServers": {
    "codemagic": {
      "command": "codemagic-mcp",
      "env": {
        "CODEMAGIC_API_KEY": "your-api-key-here",
        "CODEMAGIC_DEFAULT_APP_ID": "your-app-id-here"
      }
    }
  }
}

Usando uvx (no se requiere instalación previa)

{
  "mcpServers": {
    "codemagic": {
      "command": "uvx",
      "args": ["codemagic-mcp"],
      "env": {
        "CODEMAGIC_API_KEY": "your-api-key-here",
        "CODEMAGIC_DEFAULT_APP_ID": "your-app-id-here"
      }
    }
  }
}

Reinicia Claude Code — las herramientas aparecerán en /tools.

Registrar con Claude Desktop

Añádelo a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "codemagic": {
      "command": "codemagic-mcp",
      "env": {
        "CODEMAGIC_API_KEY": "your-api-key-here",
        "CODEMAGIC_DEFAULT_APP_ID": "your-app-id-here"
      }
    }
  }
}

Reinicia Claude Desktop para aplicar los cambios.

Estructura del proyecto

codemagic_mcp/
├── config.py        # pydantic-settings config (validates API key at startup)
├── client.py        # httpx async client, one method per endpoint
├── server.py        # FastMCP instance
└── tools/
    ├── apps.py
    ├── builds.py
    ├── artifacts.py
    ├── caches.py
    ├── variables.py
    └── webhooks.py

Añadir nuevas herramientas

1. Añade un método a client.py

2. Añade la función de la herramienta al archivo tools/*.py correspondiente

3. Eso es todo — server.py nunca necesita cambiar