app-store-connect — MCP-сервер для Claude Code: обзор и запуск
Сервер подключает ИИ-агента к официальному App Store Connect API. Он позволяет управлять версиями приложений, бета-тестами в TestFlight и подписками через диалог в терминале.
claude mcp add --env APP_STORE_CONNECT_KEY_ID=<APP_STORE_CONNECT_KEY_ID> --env APP_STORE_CONNECT_ISSUER_ID=<APP_STORE_CONNECT_ISSUER_ID> --env APP_STORE_CONNECT_P8_PATH=<APP_STORE_CONNECT_P8_PATH> --env APP_STORE_CONNECT_VENDOR_NUMBER=<APP_STORE_CONNECT_VENDOR_NUMBER> --transport stdio app-store-connect -- npx -y mcp-ascЧто делает app-store-connect
Сервер запускает пакет mcp-asc через npx и транслирует вызовы инструментов в официальный REST API Apple. Для связи с клиентом доступен стандартный ввод-вывод или локальный HTTP-сервер на порту 3001. Агент получает доступ к данным каталога: спискам сборок, локализациям описаний, сертификатам и профилям подготовки.
С его помощью можно обновлять текст «Что нового», добавлять тестировщиков в группы TestFlight или проверять отзывы пользователей. Дополнительно поддерживаются настройка групп подписок, создание цен и запуск поэтапного релиза. Работа требует среды Node 20+.
Для авторизации сервер генерирует JWT на основе приватного ключа. Без пути к файлу .p8, идентификатора ключа и Issuer ID подключение завершится с ошибкой. Отчёты о продажах и финансах требуют ещё одну переменную — APP_STORE_CONNECT_VENDOR_NUMBER. Если номер вендора не передан, выгрузка финансовых таблиц не сработает.
Какие задачи решает
- добавить тестировщиков в группу TestFlight
- обновить локализованный текст «Что нового» для версии
- просмотреть отзывы покупателей и отправить официальный ответ
- выгрузить отчёты о продажах и доходах через API
- создать группу подписок и настроить уровни цен
Примеры запросов агенту
- Покажи список последних сборок в TestFlight для нашего приложения.
- Добавь тестировщика [email protected] в бета-группу QA Team.
- Проверь свежие отзывы пользователей в App Store и покажи оценки.
Как установить app-store-connect
Командой платформы
claude mcp add --env APP_STORE_CONNECT_KEY_ID=<APP_STORE_CONNECT_KEY_ID> --env APP_STORE_CONNECT_ISSUER_ID=<APP_STORE_CONNECT_ISSUER_ID> --env APP_STORE_CONNECT_P8_PATH=<APP_STORE_CONNECT_P8_PATH> --env APP_STORE_CONNECT_VENDOR_NUMBER=<APP_STORE_CONNECT_VENDOR_NUMBER> --transport stdio app-store-connect -- npx -y mcp-ascВместо <…> подставьте свои значения
Командой платформы
codex mcp add app-store-connect --env APP_STORE_CONNECT_KEY_ID=<APP_STORE_CONNECT_KEY_ID> --env APP_STORE_CONNECT_ISSUER_ID=<APP_STORE_CONNECT_ISSUER_ID> --env APP_STORE_CONNECT_P8_PATH=<APP_STORE_CONNECT_P8_PATH> --env APP_STORE_CONNECT_VENDOR_NUMBER=<APP_STORE_CONNECT_VENDOR_NUMBER> -- npx -y mcp-ascВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"app-store-connect": {
"command": "npx",
"args": [
"-y",
"mcp-asc"
],
"env": {
"APP_STORE_CONNECT_KEY_ID": "<APP_STORE_CONNECT_KEY_ID>",
"APP_STORE_CONNECT_ISSUER_ID": "<APP_STORE_CONNECT_ISSUER_ID>",
"APP_STORE_CONNECT_P8_PATH": "<APP_STORE_CONNECT_P8_PATH>",
"APP_STORE_CONNECT_VENDOR_NUMBER": "<APP_STORE_CONNECT_VENDOR_NUMBER>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"app-store-connect": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-asc"
],
"env": {
"APP_STORE_CONNECT_KEY_ID": "<APP_STORE_CONNECT_KEY_ID>",
"APP_STORE_CONNECT_ISSUER_ID": "<APP_STORE_CONNECT_ISSUER_ID>",
"APP_STORE_CONNECT_P8_PATH": "<APP_STORE_CONNECT_P8_PATH>",
"APP_STORE_CONNECT_VENDOR_NUMBER": "<APP_STORE_CONNECT_VENDOR_NUMBER>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e APP_STORE_CONNECT_KEY_ID=<APP_STORE_CONNECT_KEY_ID> -e APP_STORE_CONNECT_ISSUER_ID=<APP_STORE_CONNECT_ISSUER_ID> -e APP_STORE_CONNECT_P8_PATH=<APP_STORE_CONNECT_P8_PATH> -e APP_STORE_CONNECT_VENDOR_NUMBER=<APP_STORE_CONNECT_VENDOR_NUMBER> app-store-connect npx -y mcp-ascВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о app-store-connect
Как установить app-store-connect в Claude Code?
Выполните команду в терминале: `claude mcp add --env APP_STORE_CONNECT_KEY_ID=<APP_STORE_CONNECT_KEY_ID> --env APP_STORE_CONNECT_ISSUER_ID=<APP_STORE_CONNECT_ISSUER_ID> --env APP_STORE_CONNECT_P8_PATH=<APP_STORE_CONNECT_P8_PATH> --env APP_STORE_CONNECT_VENDOR_NUMBER=<APP_STORE_CONNECT_VENDOR_NUMBER> --transport stdio app-store-connect -- npx -y mcp-asc` Замените значения в угловых скобках на данные своего ключа API из App Store Connect.
Что делает app-store-connect?
Сервер связывает агента с API App Store Connect, открывая доступ к управлению приложениями, сборками, бета-тестами, ценами на подписки и отзывами прямо из чата.
Зачем указывать APP_STORE_CONNECT_VENDOR_NUMBER?
Эта переменная окружения нужна только для инструментов download-sales-report и download-finance-report. Для управления сборками, подписками и версиями она не требуется.
