todah-zg/codemagic-mcp

Добавляет новое приложение в Codemagic, подключая Git-репозиторий. Для HTTPS-URL: если вы подключили свою учётную запись GitHub, GitLab или Bitbucket через Codemagic Settings → Integrations, приватные репозитории доступны просто по URL — никаких учётных данных не требуется. Для SSH-URL (git@... или ssh://git@...): автоматически генерируется свежий ключ развёртывания Ed25519. Приватный ключ сохраняется непосредственно в Codemagic, а публичный ключ добавляется в GitHub автоматически, если установлен и аутентифицирован gh CLI, или показывается для ручной настройки в противном случае. Примечание: после добавления приложение показывает 'Set up build' в интерфейсе Codemagic — это нормально.

Добавляет тестировщика в TestFlight по адресу электронной почты. Опционально назначает его в конкретную бета-группу: используйте list_testflight_groups, чтобы получить названия групп. Тестировщик получает письмо-приглашение от Apple.

Добавляет несекретную переменную в группу переменных Codemagic. Для секретных значений (ключи API, сертификаты, токены) используйте Codemagic UI - секреты никогда не должны проходить через агент.

Отменяет выполняющуюся или находящуюся в очереди сборку Codemagic. Используйте, когда запущенная сборка больше не нужна: например, если была указана неверная ветка или после запуска обнаружена ошибка. Не влияет на сборки, которые уже завершились.

Агрегирует проверки готовности к публикации для iOS или Android в единый отчёт «пройдено/не пройдено». Проверки, доступные через API (валидная сборка, полнота карточки в магазине, валидация бинарного файла), выполняются в реальном времени. Пункты, у которых нет API (возрастной рейтинг, этикетки конфиденциальности, политика контента, юридические соглашения), всегда помечаются как 'human required' — чтобы ничего не пропускалось молча. Каждый пункт получает метку 'agent can fix' или 'human required', что даёт чёткий план действий. Вызывай этот инструмент перед submit_for_app_store_review (iOS) или продвижением в production (Android). Для одноразовой настройки аккаунта и записи приложения используй промпты first_publish_ios или first_publish_android.

Создаёт временную публичную ссылку для скачивания артефакта сборки. Передайте URL артефакта из get_build или wait_for_build. Полученная ссылка доступна без аутентификации - любой, у кого есть ссылка, может скачать артефакт. Используйте для передачи IPA или AAB тестировщикам, у которых нет доступа к Codemagic.

Создаёт новую группу бета-тестирования TestFlight для приложения. Внешние группы требуют проверки бета-версии приложения перед тем, как тестировщики смогут устанавливать сборки. Внутренние группы (члены организации Apple) не требуют проверки — полезно для быстрого внутреннего QA.

Создайте новую группу переменных в Codemagic. Требуется team_id (личные аккаунты не поддерживают глобальные группы переменных) или app_id для групп уровня приложения. После создания добавьте несекретные переменные через add_variable или добавьте секретные значения непосредственно в интерфейсе Codemagic.

Удаляет кэш сборки для приложения Codemagic. Если передан cache_id, удаляет кэш указанного рабочего процесса. Если не указан, удаляет все кэши приложения. Удаление асинхронно - API возвращает ответ немедленно и завершает операцию в фоне.

Удаляет переменную из группы переменных Codemagic. Variable_id берётся из list_variable_groups. Это действие нельзя отменить.

Удаляет подписку на вебхук из приложения Codemagic.

Определяет тип проекта Codemagic из списка файлов репозитория. Возвращает рекомендуемый тип шаблона, уровень уверенности и предлагаемый шаблон отладки для начального ознакомления. Для проектов JavaScript/TypeScript предоставление содержимого package.json значительно повышает точность.

Получает текущее описание магазина Google Play для определённого языка. Возвращает заголовок, краткое описание и полное описание. Используйте перед set_android_store_listing для просмотра существующего текста.

Получает полную панель состояния конвейера выпуска для приложения, включая последнюю сборку, TestFlight, версию App Store и статус отправки.

Получает текущий статус проверки в App Store для приложения. Вызывайте его после отправки в App Store, чтобы отслеживать прогресс и проверять наличие блокирующих проблем.

Получает полные сведения об одной сборке, включая URL-адреса для загрузки артефактов. Идентификатор сборки поступает из trigger_build или list_builds. URL-адреса артефактов требуют x-auth-token. Используйте их с upload_to_testflight, upload_to_google_play или create_public_artifact_url.

Получает логи для сборки Codemagic. По умолчанию возвращает логи только для неудачных шагов. Основное применение — диагностика причин сбоя сборки. Передайте step_name, чтобы получить логи для конкретного шага независимо от его статуса (например, 'building_ios', 'testing', 'publishing'). Всегда сначала возвращает список шагов с их статусами.

Извлекает текущий текст листинга App Store для всех локалей версии приложения. Возвращает поля информации о приложении (название, подзаголовок, URL-адреса конфиденциальности) и поля версии (описание, ключевые слова, рекламный текст, URL поддержки, что нового), сгруппированные по локали. Используйте перед set_ios_store_listing, чтобы просмотреть, что сейчас опубликовано.

Получает наибольший versionCode, который в настоящее время находится на Google Play, во всех треках (или в конкретных треках). Используйте это перед запуском сборки релиза, чтобы определить следующий BUILD_NUMBER: увеличьте результат на 1.

Получает и разбирает результаты тестов из сборки Codemagic. Ищет в списке артефактов сборки файлы JUnit XML и возвращает структурированную сводку pass/fail/error/skip с деталями по каждому сбою (сообщение + фрагмент стека). Охватывает Flutter, инструментированные тесты Android и iOS (xcresult, преобразованный CLI-инструментами Codemagic). Передавайте artifact_url напрямую, если уже получили его из wait_for_build - пропускает поиск артефактов. Сборка должна находиться в конечном состоянии (finished или failed), чтобы артефакты были доступны. Требует, чтобы workflow в codemagic.yaml содержал test_report glob, указывающий на вывод JUnit XML.

Получает URL входящего вебхука для приложения Codemagic. Вставьте этот URL в настройки репозитория вашего Git-провайдера (GitHub, GitLab или Bitbucket), чтобы автоматически запускать сборки при событиях push или pull request.

Получает начальный шаблон codemagic.yaml для заданного типа проекта. Шаблоны охватывают только сборку и подписание - публикация обрабатывается отдельно через инструменты App Store Connect. Вызовите list_yaml_template_types, чтобы увидеть все допустимые значения project_type. ВАЖНО: шаблоны Android по умолчанию используют linux_x2 (дешевле, Mac не нужен). Личные аккаунты (без команды) не могут использовать linux_x2 - замените его на mac_mini_m2 для личных аккаунтов.

Перечисляет все приложения в вашем аккаунте Codemagic. Вызывайте его первым, чтобы получить ID приложений, нужные для всех остальных инструментов Codemagic.

Выводит список приложений в App Store Connect. Сначала вызовите его, чтобы получить ASC app ID, необходимый для всех остальных инструментов App Store Connect.

Перечисляет сборки TestFlight для приложения в App Store Connect. Находит наибольший номер версии, увеличивает на 1 и передаёт его как BUILD_NUMBER в переменные trigger_build перед запуском релизной сборки.

Перечисляет сборки для команды с опциональными фильтрами. Возвращает идентификаторы сборок и статус. Используйте get_build с идентификатором сборки, чтобы получить полные сведения и URL-адреса для загрузки артефактов.

Выводит список кэшей сборок для приложения Codemagic. Каждый кэш привязан к workflow. Используйте идентификаторы кэша с delete_cache, чтобы освободить место или выполнить чистую сборку.

Перечисляет все загруженные App Bundles (AAB) для приложения в Google Play с их кодами версий. Используйте это, чтобы проверить, что уже было загружено, перед запуском новой сборки.

Перечисляет последние отзывы пользователей Google Play для приложения. Возвращаются только отзывы, содержащие текст: оценки только со звёздами исключаются API. Используйте max_star_rating, чтобы сосредоточиться на негативных отзывах (например, max_star_rating=2 для отзывов с 1–2 звёздами). Каждый отзыв включает идентификатор отзыва, необходимый для reply_to_google_play_review. Отзывы упорядочены по дате последнего изменения: сначала самые новые.

Выведи список треков Google Play (внутренний, альфа, бета, продакшн) с данными о текущем релизе и кодами версий. Найди наибольший versionCode среди всех треков, увеличь на 1 и передай его как BUILD_NUMBER в переменные trigger_build перед запуском сборки релиза.

Перечисляет поддерживаемые типы устройств для скриншотов App Store и их требуемые размеры в пикселях. По умолчанию возвращает два наиболее требуемых типа: IPHONE_65 и IPAD_PRO_3GEN_129. Передайте all=true, чтобы получить полную матрицу всех поддерживаемых типов устройств. Используйте значения deviceType, возвращённые здесь, как параметр device_type для upload_ios_screenshots.

Перечисляет команды, к которым принадлежит аутентифицированный аккаунт Codemagic. Используйте идентификаторы команд, возвращённые здесь, с list_applications, list_builds и другими инструментами, которые принимают опциональный параметр team_id.

Перечислите группы бета-тестирования TestFlight для приложения. Используйте имя группы из этого списка в параметре beta_group функции upload_to_testflight, чтобы автоматически распространять сборку среди тестировщиков после загрузки.

Перечисляет группы переменных для команды или приложения в Codemagic. Используйте названия групп для ссылок на них в trigger_build. Секретные значения никогда не возвращаются — управляйте секретами напрямую в Codemagic UI.

Перечисляет переменные в группе переменных Codemagic. Возвращает идентификаторы переменных, имена и значения. Значения секретных переменных возвращаются как null, видны только несекретные значения. Используйте идентификаторы переменных с update_variable и delete_variable.

Выводит список подписок на вебхуки, настроенных для приложения Codemagic.

Перечисляет workflows для приложения. Возвращает имена и ID workflows: используйте ID в trigger_build для запуска конкретного workflow. Примечание: workflows, определенные в YAML, появляются только после первого запуска сборки.

Перечисли все доступные типы шаблонов codemagic.yaml

Проверяет, что сервер работает, и возвращает его версию.

Проверяет локализованные примечания к выпуску перед отправкой в App Store или Google Play. Проверяет, что каждая локаль соответствует действительному коду BCP-47 (например, en-US, fr-FR, zh-Hans) и что текст укладывается в ограничения платформы по символам (Android: 500, iOS: 4000). Передайте platform='both', чтобы проверить по более строгому лимиту Android для примечаний, которые будут отправлены в оба магазина.

Продвигает релиз между треками Google Play (например, internal → alpha → beta → production) без повторной загрузки. Устанавливает user_fraction, чтобы включить поэтапное развёртывание на целевом треке (0.1 = 10% пользователей). Чтобы остановить выполняющееся поэтапное развёртывание: установите source_track=target_track='production' и release_status='halted'. Чтобы возобновить остановленное развёртывание: те же треки с release_status='inProgress' и user_fraction.

Выпускает версию App Store, которая была одобрена и ожидает в состоянии 'Pending Developer Release'. Это немедленно делает обновление доступным для всех пользователей (или запускает поэтапное развертывание, если оно было настроено). Используйте set_phased_release с action=create перед отправкой, если хотите постепенного развертывания вместо мгновенного выпуска.

Отправляет или обновляет ответ разработчика на отзыв пользователя Google Play. Ответы ограничены 350 символами. Если в отзыве уже есть ответ разработчика, этот вызов заменяет его. Получите review_id из list_google_play_reviews. Напишите личный, полезный ответ - реагирование на негативные отзывы улучшает рейтинг магазина и доверие пользователей.

Отправляет декларацию безопасности данных для приложения Google Play. Декларация описывает, какие данные собирает приложение, как они используются и передаются ли они. Принимает необработанный CSV, экспортированный из Play Console → App content → Data safety → Export CSV. Повторно загружает данные при каждом изменении правил обработки (новый тип данных, обновлённая политика хранения и т.д.). Вступает в силу немедленно. Нет этапа подготовки и конечной точки GET для получения текущих меток.

Обновляет страницу приложения в Google Play для определённого языка. Обновляются только те поля, которые вы указали - пропущенные поля остаются без изменений. Изменения вступают в силу сразу после сохранения; в Google Play нет этапа предварительного просмотра.

Устанавливает декларацию о соответствии экспортным требованиям для сборки iOS. Требуется перед отправкой в App Store и для внешнего распространения через TestFlight. Большинство приложений используют только стандартный HTTPS/TLS — установите uses_non_exempt_encryption в false. Устанавливайте его в true только если приложение реализует пользовательское или проприетарное шифрование, выходящее за рамки стандартных протоколов. По умолчанию применяется к последней сборке приложения; передайте build_id, чтобы указать конкретную сборку.

Обновляет текст в карточке приложения App Store для одной локали. Изменяются только те поля, которые вы указываете, — пропущенные поля остаются без изменений. Поля информации о приложении (name, subtitle) применяются ко всем версиям приложения. Поля версии (description, keywords, whatsNew и т. д.) применяются только к указанной версии. Изменения подготавливаются через CLI asc и проверяются перед применением.

Управляет поэтапным развертыванием для версии App Store. Поэтапное развертывание постепенно выпускает обновление в течение 7 дней: 1% → 2% → 5% → 10% → 20% → 50% → 100%. Действия: 'create' - настраивает поэтапное развертывание перед отправкой на проверку. 'pause' - приостанавливает текущее развертывание (используйте, если после релиза обнаружена критическая ошибка). 'resume' - возобновляет приостановленное развертывание. 'complete' - немедленно выпускает обновление для всех оставшихся пользователей.

Настраивает процент поэтапного развертывания для существующего релиза на канале Google Play. Используйте это, чтобы постепенно расширять развертывание (например, 10% → 25% → 50% → 100%). Требует код версии релиза, который в данный момент находится в поэтапном развертывании.

Обновляет метаданные локализации версии в App Store: текст «Что нового», описание, ключевые слова и другое. Поле «Что нового» обязательно для каждого релиза перед отправкой на проверку. Вызывайте один раз на локаль; en-US обязателен по умолчанию; добавляйте другие локали, если приложение их поддерживает. После этого используйте validate_app_submission, чтобы убедиться, что обновление устранило блокировку.

Загружает AAB из Codemagic как ссылку внутреннего обмена приложений Google Play. Возвращает установочную ссылку, которой можно мгновенно поделиться с тестировщиками — без трека, без проверки, без возни с кодом версии. Тестировщикам нужно включить функцию внутреннего обмена приложениями на устройстве. Идеально для быстрой проверки качества перед продвижением на трек.

Отправляет сборку на проверку бета-версии TestFlight. Требуется, чтобы внешние бета-группы могли установить сборку, Apple проверяет её один раз, после чего все внешние группы получают к ней доступ. Внутренним группам (сотрудники Apple / участники организации) проверка бета-версии не требуется. Получите идентификатор сборки из list_asc_builds.

Прикрепляет обработанную сборку к версии в App Store и отправляет её на проверку. Сборка должна иметь processingState VALID: перед вызовом убедитесь с помощью list_asc_builds. Требуется сначала задать метаданные версии (What's New) и информацию об экспортном соответствии. Используйте validate_app_submission, чтобы выявить блокирующие факторы перед отправкой.

Запустите новую сборку в Codemagic. Для релизных сборок: сначала определите BUILD_NUMBER с помощью list_asc_builds (iOS) или list_google_play_tracks (Android), затем передайте его в параметре variables. Используйте yaml_content для передачи встроенного codemagic.yaml — получите шаблон из get_yaml_template и проверьте его с помощью validate_codemagic_yaml перед запуском. Вызовите wait_for_build с возвращённым build ID, чтобы дождаться завершения и получить URL артефактов.

Обновляет имя или значение существующей несекретной переменной в группе переменных Codemagic. Переменная variable_id берется из list_variable_groups. Для секретных значений используйте интерфейс Codemagic - секреты никогда не должны проходить через агент.

Загружает скриншоты из URL и отправляет их в Google Play для определённого языка и типа устройства. Google разрешает до 8 скриншотов на тип устройства. Поддерживаемые форматы: JPEG и 24-битный PNG (без альфа-канала). Максимум 8 МБ на файл. Распространённые типы изображений: phoneScreenshots, sevenInchScreenshots, tenInchScreenshots, tvScreenshots, wearScreenshots. Установите replace=true, чтобы удалить все существующие скриншоты этого типа перед загрузкой (рекомендуется при обновлении набора). Все загрузки выполняются атомарно — если хотя бы одна загрузка завершится с ошибкой, ни одно изменение не вступает в силу.

Скачивает IPA из URL артефакта Codemagic и загружает его в App Store Connect. Возвращает управление сразу после фиксации загрузки — НЕ ждёт pipeline обработки Apple. После вызова этого инструмента опрашивайте list_asc_builds, пока processingState сборки не станет VALID, затем вызывайте submit_for_app_store_review с идентификатором сборки.

Загружает скриншоты из URL-адресов и выгружает их в App Store Connect для конкретного типа устройства и локали. Apple допускает до 10 скриншотов на набор. Поддерживаемые форматы: PNG (без альфа-канала) и JPEG. Максимум 10 МБ на файл. Сначала вызовите list_ios_screenshot_types, чтобы получить допустимые значения device_type и требуемые размеры. Установите replace=true, чтобы удалить существующие скриншоты перед загрузкой (рекомендуется при обновлении набора).

Загрузите AAB-артефакт из Codemagic и опубликуйте его на треке Google Play. Используйте URL AAB-артефакта, возвращённый wait_for_build. Начните с внутреннего трека - он самый безопасный для первых загрузок, и его можно продвинуть до alpha/beta/production вручную в Play Console.

Скачивает IPA-артефакт из Codemagic и загружает его в TestFlight через App Store Connect. При необходимости распространяет на бета-группу после загрузки.

Выполняет предварительную проверку готовности версии для App Store перед отправкой на ревью. Проверяет полноту метаданных, прикрепление сборки, соответствие экспортным требованиям, ценообразование, скриншоты и другое. Возвращает упорядоченный план исправлений: исправьте первый пункт, затем вызовите снова, чтобы подтвердить его устранение. Вызовите этот инструмент перед publish_to_app_store с submit_for_review=true.

Проверяет файл codemagic.yaml на соответствие официальной JSON-схеме Codemagic.

Проверяет текущий статус сборки Codemagic. Возвращает результат немедленно - без цикла опроса. Если сборка ещё не завершена, вызовите этот инструмент снова с тем же build_id. Сборка Codemagic занимает 10-40 минут; вызывать инструмент 20+ раз — нормально и ожидаемо. Возвращает полные сведения о сборке и URL-адреса для загрузки артефактов, как только будет достигнуто конечное состояние.