Apple Ads MCP — MCP-сервер для Claude Code: обзор и запуск
Локальный MCP-сервер для работы с Apple Ads Platform API v1 через Claude Code и другие клиенты. Помогает изучать кампании, проверять поисковые фразы и безопасно вносить правки.
claude mcp add --env APPLE_ADS_MCP_CONFIG=<APPLE_ADS_MCP_CONFIG> --transport stdio apple-ads-mcp -- docker run -i --rm -e APPLE_ADS_MCP_CONFIG ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.7Что делает Apple Ads MCP
Сервер связывает ассистента напрямую с рекламным API App Store для работы с четырьмя плейсментами: Search Results, Search Tab, Today Tab и страницами приложений. По умолчанию среда работает строго в режиме чтения. Все токены и приватные ключи остаются на вашей машине, а любой запрос привязан к конкретному профилю и рекламному счёту. Фонового планировщика здесь нет. Агент не сможет изменить бюджет самостоятельно.
Для записи действует многоступенчатая защита из шести проверок. Любая модификация требует запуска отдельного инструмента предпросмотра, который создаёт одноразовую квитанцию со сроком жизни десять минут. Применение изменений через operations_apply сработает только при совпадении состояния кампании и наличии флага --allow-writes. Любые списки ограничены лимитом в 200 записей со стандартной пагинацией через курсор next. Без предварительно созданного локального профиля и проверки ключей через auth_check сервер не начнёт обработку аккаунта.
Какие задачи решает
- собрать аналитику и отчёты по поисковым фразам в App Store
- проверить структуру существующих кампаний и групп объявлений без риска изменений
- найти новые ключевые слова и оценить популярность поисковых запросов
- безопасно обновить ставки через предпросмотр с одноразовой квитанцией
Примеры запросов агенту
- Вызови server_info и проверь статус account_health для моего профиля без включения записи.
- Найди перспективные ключевые слова для поисковой кампании и отдели данные Apple от своих выводов.
- Проверь доступность плейсментов и покажи отчёт по текущим группам объявлений.
Как установить Apple Ads MCP
Командой платформы
claude mcp add --env APPLE_ADS_MCP_CONFIG=<APPLE_ADS_MCP_CONFIG> --transport stdio apple-ads-mcp -- docker run -i --rm -e APPLE_ADS_MCP_CONFIG ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.7Вместо <…> подставьте свои значения
Командой платформы
codex mcp add apple-ads-mcp --env APPLE_ADS_MCP_CONFIG=<APPLE_ADS_MCP_CONFIG> -- docker run -i --rm -e APPLE_ADS_MCP_CONFIG ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.7Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"apple-ads-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"APPLE_ADS_MCP_CONFIG",
"ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.7"
],
"env": {
"APPLE_ADS_MCP_CONFIG": "<APPLE_ADS_MCP_CONFIG>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"apple-ads-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"APPLE_ADS_MCP_CONFIG",
"ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.7"
],
"env": {
"APPLE_ADS_MCP_CONFIG": "<APPLE_ADS_MCP_CONFIG>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e APPLE_ADS_MCP_CONFIG=<APPLE_ADS_MCP_CONFIG> apple-ads-mcp docker run -i --rm -e APPLE_ADS_MCP_CONFIG ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.7Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apple Ads MCP
Как установить Apple Ads MCP в Claude Code?
Выполните команду `claude mcp add --env APPLE_ADS_MCP_CONFIG=<APPLE_ADS_MCP_CONFIG> --transport stdio apple-ads-mcp -- docker run -i --rm -e APPLE_ADS_MCP_CONFIG ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.7`. Она настроит запуск сервера через Docker-контейнер и передаст переменную конфигурации.
Что делает Apple Ads MCP?
Инструмент предоставляет агенту набор типизированных функций для работы с Apple Ads Platform API v1. С его помощью можно проверять готовность приложений, изучать поисковые запросы, анализировать ставки и управлять кампаниями в App Store.
Как сервер предотвращает случайные изменения бюджета?
По умолчанию сервер запускается только на чтение. Для любой записи требуется флаг --allow-writes, предварительный просмотр параметров и применение изменений по одноразовой квитанции, которая сгорает через десять минут.
