MCP Ads

Открытый MCP-сервер для маркетинга. Запускайте Google Ads, Meta Ads, GA4, Search Console, Tag Manager, WordPress и другие платформы из Claude, ChatGPT, Cursor или любого MCP-клиента — читайте показатели, аудируйте неэффективные расходы, собирайте отчёты и запускайте кампании (всё создаётся на паузе, пока вы явно не скажете иначе).

~3,100 зарегистрированных действий на 12+ платформах, распределённых по 17 категорийным диспетчерам, поэтому ваш агент загружает ~20 определений инструментов вместо тысяч.

Выберите свой путь

☁️ Облако — подключение за 2 минуты, бесплатный тариф

Зайдите на mcp-ads.com, войдите в систему, авторизуйте свои рекламные аккаунты по OAuth в браузере и вставьте одну ссылку в Claude. Готово.

• Никаких заявок на API, никаких токенов разработчика, никаких ревью приложений — одобрения платформ (токен разработчика Google Ads, Meta App Review и остальные) уже получены

• Бесплатный тариф: 30 вызовов инструментов в месяц на любой платформе. Платные тарифы — для безлимитного использования

• Ваши учётные данные хранятся в зашифрованном виде; отозвать их можно в любой момент из панели управления

Это правильный выбор почти для всех, кто хочет использовать инструменты, а не размещать их у себя.

🔧 Self-hosted — бесплатно навсегда, ваши ключи, ваша машина

Клонируйте этот репозиторий и запустите его со своими учётными данными платформ. Лицензия MIT, никаких обязательств, ничего не отправляется на ваши серверы. Ваши токены никогда не покидают вашу машину.

Честная цена: некоторым рекламным платформам требуется подавать заявку на доступ к API (см. таблицу ниже). Если у вас уже есть эти учётные данные — вы агентство с токеном разработчика Google Ads или разработчик с проверенным приложением Meta, — развернуть у себя займёт вечер. Если нет, закладывайте дни в недели на очереди одобрения платформ или просто используйте облачную версию.

Тот же код, те же действия — в любом случае. Облачный продукт — это именно этот сервер плюс многопользовательская авторизация и уже пройденные одобрения.

Related MCP server: AdLoop: Google Ads, Reddit Ads & GA4

Быстрый старт для self-hosted

git clone https://github.com/RoyAzran/mcp-ads.git
cd mcp-ads
pip install -r requirements.txt
cp .env.example .env      # fill in the platforms you use
python server.py doctor   # shows what's connected

Затем добавьте его в Claude Desktop (claude_desktop_config.json) или Claude Code (.mcp.json):

{
  "mcpServers": {
    "mcp-ads": {
      "command": "python",
      "args": ["/absolute/path/to/mcp-ads/server.py"]
    }
  }
}

Вот и вся установка. Попросите агента «проверь, сколько бюджета моих Google Ads уходит впустую» — и наблюдайте, как он работает.

Вместо этого — Docker:

cp .env.example .env
docker compose up -d      # HTTP server on 127.0.0.1:8000, MCP endpoint at /mcp

HTTP-режим без Docker: python server.py serve --transport http

OAuth-помощник для платформ с bearer-токеном (открывает браузер, сохраняет и автоматически обновляет токен):

python server.py auth snapchat_ads

Что работает из коробки — честно

Self-hosted означает, что ключи к каждой платформе — ваши собственные. Некоторые выдают их за минуты, другие заставляют подавать заявку. Вот реальная картина:

Если от этой таблицы портится настроение — именно для этого и существует облачная Мощка: одобрения уже получены, вам остаётся только подключить аккаунты.

Как устроена поверхность инструментов

Ваш агент видит по одному диспетчеру на платформу плюс list_actions:

1. list_actions(category="meta_ads_action", search="budget")
2. meta_ads_action(action="<name from step 1>", params={...})

• Действия на запись создают всё на паузе, только если явно не отсобачено по инструкции

• Ролевое разделение (permissions.py) отделяет инструменты чтения от инструментов записи по названию

• --surface full регистрирует каждое действие как отдельный MCP-инструмент — подходит программным клиентам; для чат-клиента таких инструментов слишком много

NPX CLI

Нет Python на клиентской машине? CLI — это stdio-прокси примерно из 300 строк (cli/), который пересылает запросы любому MCP Ads-серверу:

# against your self-hosted server
MCP_ADS_BASE_URL=http://127.0.0.1:8000 npx -y @marketingmcp/cli

# against the cloud (API key from mcp-ads.com/manage)
MCP_ADS_API_KEY=mcp_live_xxx npx -y @marketingmcp/cli

Примечание о Google Ads Transparency

tools/google_ads_transparency.py читает публичный центр прозрачности Google (Ads Transparency Center) через те же конца, которые использует сам сайт. Google не документирует API для этих данных; эндпоинты могут остаться без предупреждения или начать отказываться от запросов, и автоматический доступ к ним Google не воплодствовал. Этот модуль отключён по умолчанию — ставьте GOOGLE_ADS_TRANSPER_TRANSPARENCY_ENABLED=true только после прочтения docstring этого модуля. Инструменты Meta Ad Library работают через официальный API Meta и таких оговорок не имеют.

Модель безопасности

• Учётные данные берутся из .env и необязательного локального хранилища с шифрованием Fernet (MCP_ADS_SECRET_KEY). Никакой домашней телеметрии: телеметрия полностью по опционалу и выключена по умолчанию, пока вы не сконфигурируете собственный аналитический проект.

• HTTP-режим умышленно работает без аутентификации (это вы и ваш loopback). Сервер отказывается от связываться с публичным интерфейсом, пока вы не зададите MCP_ADS_ALLOW_PUBLIC_BIND=true, потому что он хранит учётные данные, которые могут тратить реальные деньги.

• В CI работает контрольная граница (tests/test_no_private_imports.py), которая валится на всём, что похоже на секрет, попавший в дерево.

Об уязвимостях — в SECURITY.md.

Contributing

Issues и PR приветствуются — см. CONTRIBUTING.md. Скрипты проверки в scripts/ — это планка ревью: каждый из них стягивает на лопатку отказ, который действительно случился в проде, а python scripts/check_tools_execute.py перед PR ловит практически всё, что заметит ревью.

Единственное, в чём мы не помогаем, — это получение доступа к API платформ. Именно с этими очередями решения работают Google, Meta, LinkedIn, TikTok и Microsoft.

Лицензия

MIT.