codemagic_mcp

Codemagic CI/CD API를 위한 MCP 서버입니다. Bun + TypeScript, stdio 전송 방식을 사용합니다.

도구

앱

• codemagic_get_all_applications

• codemagic_get_application

• codemagic_add_application

• codemagic_add_application_private

빌드

• codemagic_start_build

• codemagic_get_builds

• codemagic_get_build_status

• codemagic_cancel_build

아티팩트

• codemagic_get_artifact (메타데이터 + base64 미리보기를 반환합니다. 전체 다운로드는 공개 URL 도구를 사용하세요)

• codemagic_create_public_artifact_url

캐시

• codemagic_get_app_caches

• codemagic_delete_all_app_caches

• codemagic_delete_app_cache

팀

• codemagic_invite_team_member

• codemagic_delete_team_member

Related MCP server: Codemagic

구성

환경 변수:

실행

bun install
CODEMAGIC_API_KEY=... bun run start

감시 모드:

CODEMAGIC_API_KEY=... bun run dev

공식 MCP 인스펙터로 검사:

CODEMAGIC_API_KEY=... bun run inspect

Claude Code / Claude Desktop 설정

한 줄 설정:

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

또는 claude_desktop_config.json에서 수동 설정:

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

보안 참고 사항

• API 키는 환경 변수에서만 읽어옵니다.

• 나가는 요청은 x-auth-token을 통해 키를 전송하며, 절대 로그에 남지 않습니다.

• 모든 도구 출력(텍스트 및 구조화된 데이터)은 키 값과 authorization, x-auth-token, api[-_]?key, password, passphrase, ssh[-_]?key, secret, token과 일치하는 모든 객체 키를 마스킹하는 리액터(redactor)를 거칩니다.

• 오류는 유형별 클래스(CodemagicAuthError, CodemagicNotFoundError, CodemagicValidationError, CodemagicRateLimitError, CodemagicServerError, CodemagicNetworkError)로 매핑되어 실행 가능한 메시지로 표시되며, 내부 스택 트레이스는 클라이언트에 노출되지 않습니다.

레이아웃

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