# AdButler

Подключает рекламную платформу AdButler к ИИ-ассистенту: кампании, зоны, креативы, VAST и отчёты создаются прямо из чата.

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

## Что делает

Сервер открывает доступ к AdButler v2 API — больше 600 инструментов для рекламодателей, кампаний, зон, креативов, плейсментов, VAST-видео, программатика и отчётности. Плюс 9 готовых промптов-сценариев, которые ведут ассистента по шагам: запуск кампании, настройка retail media, сборка отчёта, VAST-ролик, программатик-сделки.

Два способа подключения. Хостинговый вариант — просто URL `https://mcp.adbutler.com/mcp` и заголовок с ключом, ничего ставить не надо. Локальный stdio через `npx -y @adbutler/mcp-server` держит ключ на вашей машине и годится для self-hosted AdButler. Ключ берётся в панели AdButler: Settings → API Keys.

На хостинге ключ, введённый прямо в чате, живёт только до конца сессии — сервер обслуживает много клиентов и не сохраняет его на диск. Если приходится вставлять ключ каждый раз, пропишите его один раз в настройках подключения: заголовок `Authorization: Bearer` для Claude, Claude Desktop и Cursor, либо параметр `?api_key=` в URL для claude.ai custom connectors.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.adbutler.com/mcp`
- Переменные окружения: `ADBUTLER_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp-server https://mcp.adbutler.com/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env ADBUTLER_API_KEY=<ADBUTLER_API_KEY> --transport stdio adbutler -- npx -y @adbutler/mcp-server
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add adbutler --url https://mcp.adbutler.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add adbutler --env ADBUTLER_API_KEY=<ADBUTLER_API_KEY> -- npx -y @adbutler/mcp-server
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "adbutler": {
            "url": "https://mcp.adbutler.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "adbutler": {
            "command": "npx",
            "args": [
                "-y",
                "@adbutler/mcp-server"
            ],
            "env": {
                "ADBUTLER_API_KEY": "<ADBUTLER_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "adbutler": {
            "type": "http",
            "url": "https://mcp.adbutler.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "adbutler": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@adbutler/mcp-server"
            ],
            "env": {
                "ADBUTLER_API_KEY": "<ADBUTLER_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http adbutler https://mcp.adbutler.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e ADBUTLER_API_KEY=<ADBUTLER_API_KEY> adbutler npx -y @adbutler/mcp-server
```
Вместо <…> подставьте свои значения

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

## Примеры запросов агенту
- Создай кампанию для нового клиента с бюджетом 5000 и повесь её на зону Homepage Banner
- Покажи объявления с худшим CTR за последние 7 дней
- Запусти сценарий `launch-campaign` и проведи меня по шагам

## Похожие
- [ads-report](https://affpapa.org/nevibecode/skills/ads-report.md) — скилл · 645 установок
- [VASTlint](https://affpapa.org/nevibecode/mcp/vastlint.md) — MCP-сервер · ★ 19
- [ima-sdk-client-side](https://affpapa.org/nevibecode/skills/ima-sdk-client-side.md) — скилл · 4500 установок
- [ad-swipe-file](https://affpapa.org/nevibecode/skills/ad-swipe-file.md) — скилл · 20600 установок
- [ad-account-diagnostic](https://affpapa.org/nevibecode/skills/ad-account-diagnostic.md) — скилл · 20600 установок
- [ads-tiktok](https://affpapa.org/nevibecode/skills/ads-tiktok.md) — скилл · 4100 установок

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