# Snapchat Ads

Подключает рекламные аккаунты Snapchat к вашему ИИ-клиенту: 21 инструмент чтения кампаний и статистики, плюс 25 инструментов записи, выключенных по умолчанию.

- 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/snapchat-ads-mcp-server
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/snapchat-ads

## Что делает

Сервер работает с Snap Marketing API напрямую: запросы уходят на `adsapi.snapchat.com` и `accounts.snapchat.com`, без посредников. Читать можно кампании, ad squads, объявления и их показатели. Записывающие инструменты меняют кампании, но включаются только если `SNAPCHAT_ADS_ENABLE_WRITES` выставлена ровно в `true` — любое другое значение останавливает сервер на старте. Каждая запись сначала показывает превью и ждёт `confirm: true`, а созданные кампании, ad squads и объявления появляются на паузе.

Обязательна переменная `SNAPCHAT_ADS_ACCOUNT_IDS`: это список UUID аккаунтов через запятую. Всё, что относится к другому аккаунту, отсекается ещё на вашей машине. Для работы нужен OAuth-приложение Snap Marketing API и refresh-токен со scope `snapchat-marketing-api`; браузерный вход сервер не запускает, токен обновляется в памяти и после перезапуска берётся из настроек заново. Заодно понадобится Node.js 22.23.4, 24.22.1 или 26.12.1 и новее: на более старых сборках сервер пишет предупреждение в stderr, потому что в этих версиях есть октябрьские правки безопасности 2026 года.

Исходники ставятся из GitHub-релиза v1.0.0: `git clone`, затем `npm ci` и `npm run build`, а клиент запускает `node` с абсолютным путём к `dist/cli.js`. Хостинговые галереи креативов, оповещения и MCP Apps в этот релиз не входят — здесь только нативные инструменты API. Перед раздачей доступов помощнику проверьте `npm run doctor`: он покажет, какие переменные заданы, не раскрывая значения.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `SNAPCHAT_ADS_ACCOUNT_IDS`, `SNAPCHAT_ADS_ACCESS_TOKEN`, `SNAPCHAT_ADS_REFRESH_TOKEN`, `SNAPCHAT_ADS_CLIENT_ID`, `SNAPCHAT_ADS_CLIENT_SECRET`, `SNAPCHAT_ADS_ENABLE_WRITES` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env SNAPCHAT_ADS_ACCOUNT_IDS=<SNAPCHAT_ADS_ACCOUNT_IDS> --env SNAPCHAT_ADS_ACCESS_TOKEN=<SNAPCHAT_ADS_ACCESS_TOKEN> --env SNAPCHAT_ADS_REFRESH_TOKEN=<SNAPCHAT_ADS_REFRESH_TOKEN> --env SNAPCHAT_ADS_CLIENT_ID=<SNAPCHAT_ADS_CLIENT_ID> --env SNAPCHAT_ADS_CLIENT_SECRET=<SNAPCHAT_ADS_CLIENT_SECRET> --transport stdio snapchat-ads -- npx -y @getmcpads/snapchat-ads-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add snapchat-ads --env SNAPCHAT_ADS_ACCOUNT_IDS=<SNAPCHAT_ADS_ACCOUNT_IDS> --env SNAPCHAT_ADS_ACCESS_TOKEN=<SNAPCHAT_ADS_ACCESS_TOKEN> --env SNAPCHAT_ADS_REFRESH_TOKEN=<SNAPCHAT_ADS_REFRESH_TOKEN> --env SNAPCHAT_ADS_CLIENT_ID=<SNAPCHAT_ADS_CLIENT_ID> --env SNAPCHAT_ADS_CLIENT_SECRET=<SNAPCHAT_ADS_CLIENT_SECRET> -- npx -y @getmcpads/snapchat-ads-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "snapchat-ads": {
            "command": "npx",
            "args": [
                "-y",
                "@getmcpads/snapchat-ads-mcp-server"
            ],
            "env": {
                "SNAPCHAT_ADS_ACCOUNT_IDS": "<SNAPCHAT_ADS_ACCOUNT_IDS>",
                "SNAPCHAT_ADS_ACCESS_TOKEN": "<SNAPCHAT_ADS_ACCESS_TOKEN>",
                "SNAPCHAT_ADS_REFRESH_TOKEN": "<SNAPCHAT_ADS_REFRESH_TOKEN>",
                "SNAPCHAT_ADS_CLIENT_ID": "<SNAPCHAT_ADS_CLIENT_ID>",
                "SNAPCHAT_ADS_CLIENT_SECRET": "<SNAPCHAT_ADS_CLIENT_SECRET>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "snapchat-ads": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@getmcpads/snapchat-ads-mcp-server"
            ],
            "env": {
                "SNAPCHAT_ADS_ACCOUNT_IDS": "<SNAPCHAT_ADS_ACCOUNT_IDS>",
                "SNAPCHAT_ADS_ACCESS_TOKEN": "<SNAPCHAT_ADS_ACCESS_TOKEN>",
                "SNAPCHAT_ADS_REFRESH_TOKEN": "<SNAPCHAT_ADS_REFRESH_TOKEN>",
                "SNAPCHAT_ADS_CLIENT_ID": "<SNAPCHAT_ADS_CLIENT_ID>",
                "SNAPCHAT_ADS_CLIENT_SECRET": "<SNAPCHAT_ADS_CLIENT_SECRET>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e SNAPCHAT_ADS_ACCOUNT_IDS=<SNAPCHAT_ADS_ACCOUNT_IDS> -e SNAPCHAT_ADS_ACCESS_TOKEN=<SNAPCHAT_ADS_ACCESS_TOKEN> -e SNAPCHAT_ADS_REFRESH_TOKEN=<SNAPCHAT_ADS_REFRESH_TOKEN> -e SNAPCHAT_ADS_CLIENT_ID=<SNAPCHAT_ADS_CLIENT_ID> -e SNAPCHAT_ADS_CLIENT_SECRET=<SNAPCHAT_ADS_CLIENT_SECRET> snapchat-ads npx -y @getmcpads/snapchat-ads-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

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

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