Apple Ads — MCP-сервер для Claude Code: кампании App Store в чате
Читает кампании и статистику Apple Ads прямо из вашего MCP-клиента. Правки готовит заранее и применяет только после подтверждения.
claude mcp add apple-ads -e APPLE_ADS_CLIENT_ID=<APPLE_ADS_CLIENT_ID> -e APPLE_ADS_TEAM_ID=<APPLE_ADS_TEAM_ID> -e APPLE_ADS_KEY_ID=<APPLE_ADS_KEY_ID> -e APPLE_ADS_PRIVATE_KEY=<APPLE_ADS_PRIVATE_KEY> -e APPLE_ADS_AD_ACCOUNT_IDS=<APPLE_ADS_AD_ACCOUNT_IDS> -- npx -y @getmcpads/apple-ads-mcp-serverЧто делает Apple Ads
Сервер подключается к Apple Ads Platform API v1 по OAuth 2 client credentials. В комплекте 9 инструментов чтения и 11 инструментов записи, которые по умолчанию выключены. Запросы уходят напрямую в Apple, без промежуточного шлюза.
Токен сервер подписывает сам: EC P-256 ключ читается из окружения один раз при старте и держится в памяти. Нужен Node.js 22.23.4, 24.22.1 или 26.12.1 и новее — на старом рантайме в stderr уйдёт предупреждение. Обязательна переменная APPLE_ADS_AD_ACCOUNT_IDS со списком аккаунтов от 1 до 200: каждый запрос ограничен этими аккаунтами. Без ключа и валидного списка аккаунтов сервер ничего не покажет.
Каждая запись сначала показывается как превью, обновления привязаны к снимку данных, а новые сущности создаются на паузе. apple_ads_list_ad_accounts заменяет выбор аккаунта на хосте и возвращает только настроенные. Сверьте список до того, как включать запись через APPLE_ADS_ENABLE_WRITES.
Какие задачи решает
- посмотреть кампании App Store и их показатели без захода в веб-интерфейс
- подготовить правку ставки и увидеть превью до применения
- создать новую кампанию или группу сразу на паузе
- ограничить доступ агента конкретными рекламными аккаунтами
- проверить, какие аккаунты вообще настроены в этом подключении
Примеры запросов агенту
- Покажи кампании в аккаунте и их расход за последнюю неделю
- Подготовь снижение ставки в группе объявлений, покажи превью без применения
- Выведи список рекламных аккаунтов, к которым у тебя есть доступ
Как установить Apple Ads
Командой платформы
claude mcp add apple-ads -e APPLE_ADS_CLIENT_ID=<APPLE_ADS_CLIENT_ID> -e APPLE_ADS_TEAM_ID=<APPLE_ADS_TEAM_ID> -e APPLE_ADS_KEY_ID=<APPLE_ADS_KEY_ID> -e APPLE_ADS_PRIVATE_KEY=<APPLE_ADS_PRIVATE_KEY> -e APPLE_ADS_AD_ACCOUNT_IDS=<APPLE_ADS_AD_ACCOUNT_IDS> -- npx -y @getmcpads/apple-ads-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add get-mcp-ads-apple-ads --env APPLE_ADS_CLIENT_ID=<APPLE_ADS_CLIENT_ID> --env APPLE_ADS_TEAM_ID=<APPLE_ADS_TEAM_ID> --env APPLE_ADS_KEY_ID=<APPLE_ADS_KEY_ID> --env APPLE_ADS_PRIVATE_KEY=<APPLE_ADS_PRIVATE_KEY> --env APPLE_ADS_PRIVATE_KEY_PATH=<APPLE_ADS_PRIVATE_KEY_PATH> -- npx -y @getmcpads/apple-ads-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"get-mcp-ads-apple-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/apple-ads-mcp-server"
],
"env": {
"APPLE_ADS_CLIENT_ID": "<APPLE_ADS_CLIENT_ID>",
"APPLE_ADS_TEAM_ID": "<APPLE_ADS_TEAM_ID>",
"APPLE_ADS_KEY_ID": "<APPLE_ADS_KEY_ID>",
"APPLE_ADS_PRIVATE_KEY": "<APPLE_ADS_PRIVATE_KEY>",
"APPLE_ADS_PRIVATE_KEY_PATH": "<APPLE_ADS_PRIVATE_KEY_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"get-mcp-ads-apple-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getmcpads/apple-ads-mcp-server"
],
"env": {
"APPLE_ADS_CLIENT_ID": "<APPLE_ADS_CLIENT_ID>",
"APPLE_ADS_TEAM_ID": "<APPLE_ADS_TEAM_ID>",
"APPLE_ADS_KEY_ID": "<APPLE_ADS_KEY_ID>",
"APPLE_ADS_PRIVATE_KEY": "<APPLE_ADS_PRIVATE_KEY>",
"APPLE_ADS_PRIVATE_KEY_PATH": "<APPLE_ADS_PRIVATE_KEY_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e APPLE_ADS_CLIENT_ID=<APPLE_ADS_CLIENT_ID> -e APPLE_ADS_TEAM_ID=<APPLE_ADS_TEAM_ID> -e APPLE_ADS_KEY_ID=<APPLE_ADS_KEY_ID> -e APPLE_ADS_PRIVATE_KEY=<APPLE_ADS_PRIVATE_KEY> -e APPLE_ADS_PRIVATE_KEY_PATH=<APPLE_ADS_PRIVATE_KEY_PATH> get-mcp-ads-apple-ads npx -y @getmcpads/apple-ads-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apple Ads
Как установить Apple Ads в Claude Code?
Добавьте сервер командой `claude mcp add apple-ads -e APPLE_ADS_CLIENT_ID=<APPLE_ADS_CLIENT_ID> -e APPLE_ADS_TEAM_ID=<APPLE_ADS_TEAM_ID> -e APPLE_ADS_KEY_ID=<APPLE_ADS_KEY_ID> -e APPLE_ADS_PRIVATE_KEY=<APPLE_ADS_PRIVATE_KEY> -e APPLE_ADS_AD_ACCOUNT_IDS=<APPLE_ADS_AD_ACCOUNT_IDS> -- npx -y @getmcpads/apple-ads-mcp-server`. Все переменные окружения подставьте свои.
Что делает Apple Ads?
Даёт агенту инструменты чтения кампаний и статистики Apple Ads, а также инструменты записи, которые включаются отдельно. Каждая правка проходит через превью и подтверждение.
Что нужно для работы?
Ключ EC P-256, загруженный в настройках API аккаунта Apple Ads, значения clientId, teamId и keyId оттуда же, список ID аккаунтов и Node.js нужной версии.
