Покроковий гайд, як підключити Claude до реклами, дати йому пам'ять і сервіси, зібрати власного бота — і запускати кампанії з Telegram, навіть лежачи на дивані. Ти не пишеш ні рядка коду — лише копіюєш готові команди. А застрягнеш — кидаєш скрін у Claude, і він пояснює або робить сам.
Замість того, щоб клікати в Ads Manager, ти просто пишеш (або говориш голосом): «постав на паузу адсети з ROAS < 1», «покажи виторг по ринках за травень», «залий ці креативи в 5 країн». Агент робить це через офіційний Meta API. Цей гайд проведе тебе тим самим шляхом, який пройшов я — від першого підключення до повноцінного бота на сервері.
App, токен, перше підключення з комп'ютера.
TRACK 01Звіти, паузи, запуск креативів природною мовою.
TRACK 02Зроби агента «своїм»: правила, контекст, стиль.
TRACK 03Shopify, Google, своя база — через MCP.
TRACK 04Свій агент із характером, як Sigrid.
TRACK 05Керування з Telegram + голосові з телефона.
Чесно: тут будуть команди, які виглядають «технічно». Але тобі не треба нічого в них розуміти — ти їх просто копіюєш і вставляєш. А якщо якийсь крок незрозумілий, видає помилку, або ти не знаєш «куди це вставляти» — у тебе завжди є кнопка SOS.
Мета цього кроку — щоб у твоєму чаті з'явилася жива команда «покажи мої кампанії» і вона реально повертала дані з твого рекламного акаунта.
https://mcp.facebook.com/ads, входиш своїм Facebook-акаунтом, і все: ні токенів, ні .env. Ручний/developer (кроки 2–4 нижче): свій токен + .env — потрібен, якщо будуєш власного бота (Треки 4–5) або хочеш повний контроль. Не впевнений — починай з конектора.Два варіанти. Claude Desktop (Mac/Windows) — просто качаєш застосунок із claude.ai/download, нічого більше не треба. Найлегший старт. Claude Code (у терміналі) — потужніше й обовʼязкове для Треків 4–5. Ставиться однією командою.
# 1) встановити Claude Code (одна команда, Node.js не потрібен)
curl -fsSL https://claude.ai/install.sh | bash
# 2) відкрити НОВЕ вікно терміналу і перевірити
claude --version
# 3) запуск — у папці свого проєкту (перший раз попросить увійти в акаунт)
claudeirm https://claude.ai/install.ps1 | iex, потім кроки 2 і 3. Нічого додатково ставити не треба.Cmd + Space → набери «Terminal» → Enter. Команди звідси копіюй (кнопка «Copy» праворуч у блоці), не передруковуй руками — одруківка це причина №1 болю новачка. Щось пішло не так — скрін у Claude, він підкаже наступний крок.Зайди на developers.facebook.com → My Apps → Create App → тип Business. Прив'яжи свій Business Manager, де лежить рекламний акаунт.
Не бери токен із Graph API Explorer — він живе 1–2 години і запуски падатимуть. Зроби System User у Business Settings → System Users, видай йому доступ до акаунта і згенеруй токен із дозволами нижче. При генерації обери термін дії «Never» (без закінчення) — тоді токен довгоживучий і його не треба оновлювати.
ads_management ads_read business_management pages_manage_adsads_read + ads_management; решта — лише якщо керуєш активами бізнесу чи Page-оголошеннями). Токен із «Never» не має дати закінчення, але може стати недійсним при зміні пароля/прав — тоді просто перегенеруй (це помилка 190). Заплутався на якомусь екрані Meta — скрін у Claude: «де тут згенерувати System User токен?» — він підкаже куди тиснути..env — це звичайний текстовий файл, де лежать твої ключі (як гаманець із паролями). Поклади туди токен — і ніколи не викладай цей файл публічно / у git. Далі агенту потрібен «місток» до Meta API. У Meta є офіційні: Ads MCP (https://mcp.facebook.com/ads, той самий, що в легкому шляху, у Claude Code додається командою claude mcp add) і Ads CLI для розробників. Для власного бота можна й свій місток: попроси Claude («зроби MCP-сервер для Meta Marketing API під мій токен і підключи його»).
😌 Не хочеш робити це руками? Відкрий Claude і просто напиши: «створи файл .env з моїм Meta-токеном і підключи Meta MCP» — він створить файл, впише ключі куди треба і все під'єднає сам.
# тримай це поза git — додай .env у .gitignore
META_ACCESS_TOKEN=EAAB...твій_system_user_token
META_AD_ACCOUNT_ID=act_1234567890Відкрий чат і просто напиши людською мовою:
Покажи мої активні кампанії в Meta Ads і витрати за вчораЯкщо повернувся список кампаній — фундамент готовий. 🎉
Тепер агент — твій медіабаєр-асистент. Все, що ти робив кліками, тепер робиться фразою. Не треба памʼятати «правильні» слова — пиши, як сказав би колезі.
Розминка · базові команди
Який ROAS по ринках за останні 7 днів? Виокрем топ-3 і аутсайдерівСкидаєш папку з відео/банерами у трьох співвідношеннях (1:1, 4:5, 9:16). Агент групує всі формати одного креатива в ОДНЕ оголошення — тоді Meta сама показує квадрат у стрічці, а вертикаль у Stories/Reels, і ти не плодиш дублі. Кілька продуктів — по одному оголошенню на продукт. Важливо: сам агент за замовчуванням цього не вгадає — він зальє кожен файл окремим оголошенням. Тому групування проси прямо в команді (нижче воно вже вписане).
Залий креативи з цієї папки в SE, DE, FI. Згрупуй 3 формати кожного креатива (1:1 + 4:5 + 9:16) в одне оголошення, по одному оголошенню на продукт. Бюджет 20 €/день на адсет, статус PAUSEDcreativeA_1x1.mp4, creativeA_4x5.mp4, creativeA_9x16.mp4. Сумніваєшся, що зібралось правильно — додай: «покажи прев'ю кожного оголошення перед запуском», і перевір очима всі формати. Нюанс: це працює для одиночних фото/відео (Meta сама підбирає формат під плейсмент). Карусель так не вміє — для неї один формат на всі плейсменти (зазвичай 4:5).Вищий пілотаж · те, на що агенція витрачає години
Тут і починається «вау». Це не «покажи цифри» — це коли агент думає як аналітик: знаходить причину, рахує реальні гроші, прогнозує і пропонує дію. Кожну з цих команд можна кинути як є.
Пройдись по всіх активних відео за 14 днів. Знайди ті, де CTR впав >25% від піку, а CPA росте — це вигоряння. Згрупуй по типу хука, скажи які виключати і який формат хука зараз працює найкращеЗведи витрати Meta з виторгом Shopify по кожному ринку за травень. Відніми COGS 35% і знижки. Покажи реальний прибуток по ринках — де ми справді в плюсі, а де Meta завищує ROASПри поточному темпі відкрутки — скільки витратимо до кінця місяця? Виб'ємось за план 15k€? Якщо так — які адсети підрізати першими, щоб не вбити найкращіПройдись по активних адсетах і знайди ті, що одночасно таргетять той самий ринок і схожу аудиторію (вік, стать, інтереси, custom audiences). Покажи такі пари з витратами й результатами і підкажи, що об'єднати чи вимкнутиЦього тижня ROAS впав. Розберись чому: що змінилось у CPM, CTR, конверсії й по яких ринках. Поясни простими словами, ніби мені, і дай 3 конкретні дії на завтраЦе секрет, який відрізняє «прикольну іграшку» від робочого інструмента. Ти один раз описуєш правила свого бізнесу — і агент перестає перепитувати й помилятися. Він починає працювати, як твій навчений співробітник.
CLAUDE.mdПоклади в корінь проєкту файл CLAUDE.md. Все, що там написано, агент читає на старті кожної розмови. Це його посадова інструкція.
## Контекст бренду
- Валюта акаунта — USD. Показуй «$».
# ← заміни на свою: EUR→«€», GBP→«£», PLN→«zł», SEK→«kr»…
- Середній чек (AOV) ≈ $60. Поріг «лити в збиток» = 2× AOV без покупки.
- Ринки: US, UK, CA. Мова звітів — українська.
## Атрибуція
- Партнерські/інфлюенс-адсети рахуй лише по 7-day click.
## Правила запуску
- Нові оголошення — завжди PAUSED.
- Перед будь-яким запуском покажи мені план і чекай «так».CLAUDE.md — це правила. Окремо агент веде пам'ять — факти, що накопичуються між розмовами, щоб завтрашня сесія знала, що було вчора. Я розкладаю її на 4 типи (кожен — окремий файл), а зверху MEMORY.md як зміст-індекс:
MEMORY.md # індекс: посилання на все нижче
user_*.md # хто ти: роль, преференції, стиль
feedback_*.md # твої правки/корекції — агент їх не повторює
project_*.md # стан проєктів: цілі, дедлайни, запуски
reference_*.md # де шукати: Asana, GA4, дашборди, докиСамі файли пам'яті ти не пишеш руками — агент веде їх сам (CLAUDE.md вище — єдине, що ти редагуєш власноруч). На практиці просто кажеш:
Запам'ятай: креативи з UGC-хуком у перші 3 сек дають CPA на ~30% нижче — враховуй у рекомендаціях.
Запам'ятай: я не люблю простирадла тексту — звіти давай короткими блоками.Перший факт ляже у project/insight, другий — у feedback. Далі агент сам їх читає й застосовує.
Через тиждень такий агент знає твій бізнес краще за нового співробітника: валюту, пороги, твій стиль, історію рішень, чого ти не любиш. Він перестає перепитувати очевидне й помилятися на тому, що вже виправляв.
CLAUDE.md + структуру пам'яті можна віддати під будь-який інший бізнес — і його агент одразу «знає» свій ринок, валюту й правила. По суті ти один раз описуєш систему, а далі лише міняєш контекст.Реклама не живе окремо від продажів. Через MCP (Model Context Protocol — універсальний «перехідник» для AI) агент бачить замовлення, склад, календар, таблиці. Тоді з'являється справжня аналітика: не «скільки витратив», а «скільки заробив».
Підключаєш магазин → агент зводить рекламу з реальним виторгом, а не з тим, що рапортує Meta.
Зведи витрати Meta з net revenue Shopify по кожному ринку за минулий місяць. Покажи реальний ROAS після знижок і повернень — і який ринок найприбутковіший насправдіDrive (креативи), Calendar (плани запусків), Asana (задачі) — агент сам бере брифи й веде таски.
Підключаєш локальну БД — агент пише й читає історію запусків, лог рішень, метрики. Це фундамент для самонавчання.
claude_desktop_config.json прописуєш сервер і ключ (де лежить: macOS ~/Library/Application Support/Claude/, Windows %APPDATA%\Claude\ — або просто Settings → Developer → Edit Config). У Claude Code — командою claude mcp add. А найлегше — попроси Claude: «додай MCP для Shopify» — він відкриє потрібний файл і впише сам. Кожен сервіс = плюс одна «суперсила» агента.Чат — це добре, але справжня сила — коли в тебе є іменований агент із характером, до якого можна звертатись як до співробітника. У мене це Sigrid — вона знає бренд, рахує лійку, шле звіти. Ось скелет.
System-промпт = хто він, як говорить, що вміє, чого ніколи не робить. Це перетворює «модель» на «колегу».
Підключаєш ті самі Meta/Shopify виклики як функції, які агент може викликати сам у відповідь на запит.
# спрощено: цикл «запит → план → виклик інструментів → відповідь»
while True:
msg = telegram.get_message()
plan = agent.think(msg, tools=[meta, shopify, db])
result= agent.run(plan) # виконує дії
telegram.reply(agent.summarize(result))Бібліотека на кшталт python-telegram-bot приймає повідомлення й віддає їх агенту. Тепер з ним можна говорити з месенджера.
Останній рівень: агент живе не на твоєму ноуті, а на сервері 24/7. Ти пишеш або надиктовуєш голосом у Telegram — він робить роботу, поки ти йдеш по каву. Я працюю так щодня з телефона.
Дешевий сервер (я на Hetzner, Гельсінкі, від ~5 €/міс). Заливаєш туди проєкт.
Запускаєш Claude Code / бота під systemd, щоб піднімався сам після ребуту й не падав.
# агент завжди живий, рестарт у разі падіння
sudo systemctl enable --now my-agent.service
sudo systemctl status my-agentБот-міст приймає твої повідомлення з телефона й передає агенту на сервері. Відповідь прилітає назад у чат.
Писати міст самому вже не обов'язково: в Anthropic є офіційний Telegram-плагін для Claude Code. Створюєш бота в @BotFather, далі в Claude Code:
# всередині Claude Code
/plugin install telegram@claude-plugins-official
/telegram:configure ТОКЕН_ВІД_BOTFATHER
# перезапуск з увімкненим каналом
claude --channels plugin:telegram@claude-plugins-officialПишеш боту, він дає код, вводиш у Claude Code /telegram:access pair КОД, потім /telegram:access policy allowlist: тепер писати агенту можеш лише ти. Потрібен Bun; функція поки в research preview, тож команди можуть змінитись (актуальне: docs → channels).
Додаєш транскрипцію (наприклад Whisper): надиктував голосове — воно перетворюється на команду. Тепер ти керуєш рекламою, навіть не друкуючи.
«Зведи виторг і витрати по ринках за минулий тиждень і переведи все в євро»Найбільш популярні граблі, на які натикаються всі — щоб ти на них не витрачав години.
| Код | Що значить | Що робити |
|---|---|---|
190 | Токен недійсний / відкликаний | Перегенеруй System User токен (опція «Never») |
100 | Невірний параметр / поле | Перевір act_… ID, формат, обов'язкові поля |
4 (1504022) | Ліміт на запити статистики (Insights) | Зачекай і зменш кількість запитів; точного часу Meta не дає |
17 (2446079) | Ліміт запитів на рекламний акаунт | Блок на 5 хв (на Full access — 1 хв). Full access ще й піднімає сам ліміт |
80004 | Ліміт на кількість дій з акаунтом (Business Use Case) | Знизь частоту змін; скільки чекати, Meta пише в заголовку відповіді X-Business-Use-Case |
.env, не в gitact_… рекламного акаунтаНайкрутіше: тобі взагалі не обов'язково створювати файли й копіювати команди по одній. Завантаж цей гайд як .md, кинь його в Claude Code і просто напиши:
Ось інструкція з налаштування Meta Ads × AI. Розбери її і проведи мене по кроках.
Питай у мене дані, де треба (токен, ID акаунта, валюта), і роби все сам.Claude прочитає гайд, поставить кілька запитань (твій токен, акаунт, валюта) і виконає налаштування за тебе — від встановлення до першої робочої команди. Сам файл .md нижче і є тією інструкцією, яку йому передаєш.