Как подключить Meta Ads к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Meta Ads, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Meta Ads + Gemini

Дайте ИИ анализировать вашу рекламу в Facebook и Instagram: расходы, охват, клики и конверсии по кампаниям, группам объявлений, объявлениям, возрасту, странам или местам размещения, а также кампании, креативы, аудитории и историю изменений. После подтверждения может приостанавливать и включать объявления и менять бюджеты.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

META_ADS_ACCESS_TOKEN, META_ADS_ACCOUNT_ID

Шаг 1 — Получите учётные данные

1. Откройте https://developers.facebook.com/apps/creation/ и создайте приложение с вариантом использования Create & manage ads with Marketing API, подключённое к вашему бизнес-портфолио. Так приложение получает разрешения ads_read, ads_management и business_management.
2. Рекомендуется токен, который никогда не истекает: в Business Settings (https://business.facebook.com/settings) откройте Users → System users и добавьте системного пользователя (роль Admin или Employee только для чтения). В Assign assets назначьте ему ваш рекламный аккаунт (Manage campaigns или View performance только для чтения). Нажмите Generate token, выберите приложение, укажите срок действия Never и отметьте ads_read, а также ads_management для изменения статусов и бюджетов. Meta может сначала попросить подтвердить бизнес-портфолио (Business Settings → Security Center); до этого используйте токен из шага 3.
3. Быстрее, для теста: в Graph API Explorer (https://developers.facebook.com/tools/explorer/) выберите своё приложение и User Token с ads_read и ads_management. Он действует один-два часа, поэтому откройте его в Access Token Debugger (https://developers.facebook.com/tools/debug/accesstoken) и нажмите Extend Access Token, чтобы получить токен на 60 дней.
4. Вставьте токен в META_ADS_ACCESS_TOKEN (он начинается с EA; вставляйте его без слова Bearer). Укажите ID рекламного аккаунта в META_ADS_ACCOUNT_ID с префиксом act_, например act_1234567890. Ads Manager показывает номер в адресной строке (act=1234567890).
5. Установите коннектор и запустите meta_ads_list_ad_accounts. Он выводит все рекламные аккаунты, доступные токену, со статусом, валютой и часовым поясом.

Уровень доступа: у нового приложения Limited access (раньше Standard). Этого хватает для рекламных аккаунтов вашей собственной компании, но лимиты запросов очень жёсткие. Для рекламных аккаунтов других компаний нужен Full access (раньше Advanced) через App Review. Оставьте Require App Secret (App settings → Advanced) выключенным: если он включён, Meta отклоняет вызовы коннектора.

Сначала подтверждение: meta_ads_update_status приостанавливает или включает кампанию, группу объявлений или объявление, а meta_ads_update_budget меняет дневной бюджет или бюджет на весь срок. Оба действуют сразу и меняют ваши расходы: включение запускает траты, приостановка останавливает показ. ИИ называет объект (название и ID), текущее и новое значение и ждёт вашего согласия. Объявление показывается, только когда само объявление, его группа объявлений и его кампания находятся в статусе ACTIVE. Бюджеты задаются целыми числами в минимальной единице валюты аккаунта (2000 означает 20,00 EUR); у таких валют, как JPY или KRW, дробной единицы нет.

Что он читает: рекламные аккаунты, кампании, группы объявлений с таргетингом, объявления с причиной, по которой объявление не показывается, креативы, пользовательские и похожие аудитории, историю изменений (кто, что и когда изменил) и результаты. Insights показывают расходы, охват, клики и конверсии по аккаунту или по отдельной кампании, группе объявлений или объявлению за готовый период, например последние 7 дней или прошлый месяц, или за любые даты до 37 месяцев назад, при желании по дням и с разбивкой по возрасту, полу, стране, региону или месту размещения.

Частые ошибки: 190: токен недействителен или истёк, создайте новый. 10 или от 200 до 299: не хватает разрешения (294 означает ads_management) или у токена нет доступа к этому рекламному аккаунту. 100: неверный параметр; с подкодом 1487534 запрос слишком большой, поэтому сократите период или уберите разбивки. 4, 17, 613, 80000 и 80004 означают лимиты запросов: подождите несколько минут.

Коннектор ничего не создаёт: он не создаёт и не редактирует кампании, группы объявлений, объявления, креативы и аудитории, не загружает медиафайлы и не работает с лид-формами, пикселями и Conversions API.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Meta Ads.

Доступные инструменты

Примеры запросов

• «Сколько мы потратили на Facebook и Instagram в прошлом месяце и у какой кампании была самая низкая стоимость покупки?»
• «Разбей расходы и клики за последние 30 дней по возрасту, полу и месту размещения.»
• «Какие наши объявления сейчас не показываются и почему?»
• «Увеличь дневной бюджет нашей самой эффективной кампании на 20 процентов, но сначала покажи текущий и новый бюджет.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT