# Apple Ads MCP

Локальный MCP-сервер для работы с Apple Ads Platform API v1 через Claude Code и другие клиенты. Помогает изучать кампании, проверять поисковые фразы и безопасно вносить правки.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Автор: zelentsov-dev
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/zelentsov-dev/apple-ads-mcp
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/mcp/apple-ads-mcp

## Что делает

Сервер связывает ассистента напрямую с рекламным API App Store для работы с четырьмя плейсментами: Search Results, Search Tab, Today Tab и страницами приложений. По умолчанию среда работает строго в режиме чтения. Все токены и приватные ключи остаются на вашей машине, а любой запрос привязан к конкретному профилю и рекламному счёту. Фонового планировщика здесь нет. Агент не сможет изменить бюджет самостоятельно.

Для записи действует многоступенчатая защита из шести проверок. Любая модификация требует запуска отдельного инструмента предпросмотра, который создаёт одноразовую квитанцию со сроком жизни десять минут. Применение изменений через `operations_apply` сработает только при совпадении состояния кампании и наличии флага `--allow-writes`. Любые списки ограничены лимитом в 200 записей со стандартной пагинацией через курсор `next`. Без предварительно созданного локального профиля и проверки ключей через `auth_check` сервер не начнёт обработку аккаунта.

## Требования
- Нужно: Docker
- Переменные окружения: `APPLE_ADS_MCP_CONFIG` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

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

## Примеры запросов агенту
- Вызови server_info и проверь статус account_health для моего профиля без включения записи.
- Найди перспективные ключевые слова для поисковой кампании и отдели данные Apple от своих выводов.
- Проверь доступность плейсментов и покажи отчёт по текущим группам объявлений.

## Похожие
- [labelhead-artist-momentum](https://affpapa.org/nevibecode/mcp/labelhead-artist-momentum.md) — MCP-сервер · ★ 107701
- [openshorts](https://affpapa.org/nevibecode/mcp/openshorts.md) — MCP-сервер · ★ 7132
- [OpenScreen](https://affpapa.org/nevibecode/mcp/openscreen.md) — MCP-сервер · ★ 4963
- [Usertour MCP Server](https://affpapa.org/nevibecode/mcp/usertour-mcp-server.md) — MCP-сервер · ★ 2329
- [Appllama](https://affpapa.org/nevibecode/mcp/appllama.md) — MCP-сервер · ★ 3228
- [obsei](https://affpapa.org/nevibecode/mcp/obsei.md) — MCP-сервер · ★ 1441

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