# Apple Ads

Читает кампании и статистику Apple Ads прямо из вашего MCP-клиента. Правки готовит заранее и применяет только после подтверждения.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: get-mcp-ads
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/get-mcp-ads/apple-ads-mcp-server
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/get-mcp-ads-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`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `APPLE_ADS_CLIENT_ID`, `APPLE_ADS_TEAM_ID`, `APPLE_ADS_KEY_ID`, `APPLE_ADS_PRIVATE_KEY`, `APPLE_ADS_PRIVATE_KEY_PATH`, `APPLE_ADS_AD_ACCOUNT_IDS`, `APPLE_ADS_ENABLE_WRITES` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- посмотреть кампании App Store и их показатели без захода в веб-интерфейс
- подготовить правку ставки и увидеть превью до применения
- создать новую кампанию или группу сразу на паузе
- ограничить доступ агента конкретными рекламными аккаунтами
- проверить, какие аккаунты вообще настроены в этом подключении

## Примеры запросов агенту
- Покажи кампании в аккаунте и их расход за последнюю неделю
- Подготовь снижение ставки в группе объявлений, покажи превью без применения
- Выведи список рекламных аккаунтов, к которым у тебя есть доступ

## Похожие
- [asc-apple-ads](https://affpapa.org/nevibecode/skills/asc-apple-ads.md) — скилл · 3000 установок
- [ads-apple](https://affpapa.org/nevibecode/skills/ads-apple.md) — скилл · 3700 установок
- [spotify-ads-api](https://affpapa.org/nevibecode/plugins/spotify-ads-api.md) — плагин · ★ 20
- [thought-leadership-ads](https://affpapa.org/nevibecode/skills/thought-leadership-ads.md) — скилл · 19900 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md