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

設定

環境変数:

変数	必須	デフォルト	備考
`CODEMAGIC_API_KEY`	はい	—	Teams設定 → Personal Account → API から取得
`CODEMAGIC_BASE_URL`	いいえ	`https://api.codemagic.io`	セルフホスト/ステージング用の上書き
`CODEMAGIC_TIMEOUT_MS`	いいえ	`30000`	リクエストごとのタイムアウト
`CODEMAGIC_MAX_RETRIES`	いいえ	`3`	408/425/429/5xxおよびネットワークエラー時のリトライ（ジッター付き指数バックオフ、`Retry-After`を尊重）

実行

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 に一致するオブジェクトキーをマスクするリダクターを通過します。
エラーは型付きクラス（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