ADS Beast для ШІ-асистентів
Підключення Codex до ADS Beast
Codex зберігає MCP-сервери в `~/.codex/config.toml` і читає ключ зі змінної середовища, назву якої ви вказуєте.
Спершу створіть API-ключ
- 1Увійдіть в ADS Beast і відкрийте в меню API-ключі. Щоб створити ключ, потрібна роль адміністратора.
- 2Створіть ключ лише з тими областями доступу, які потрібні асистенту. Щоб переглядати дані, досить
read:*. Додайтеwrite:proposals, щоб він міг пропонувати зміни та збирати чернетки кампаній, іwrite:leads, щоб він міг оновлювати ліди. - 3Скопіюйте ключ, який починається з
absk_. Він показується один раз. Відкликати його можна на тому самому екрані, і відкликаний ключ одразу перестає працювати.
Додайте сервер із ключем
- 1Збережіть ключ у змінній середовища, яка переживе перезапуск, і відкрийте новий термінал.
- 2Виконайте команду
codex mcp addабо впишіть такий самий блок у~/.codex/config.tomlвручну. - 3Виконайте
codex mcp list, щоб перевірити, щоadsbeastна місці, потім запустіть Codex.
macOS, Linux
echo 'export ADSBEAST_API_KEY=absk_your_key' >> ~/.zshrc # or ~/.bashrcWindows PowerShell
[Environment]::SetEnvironmentVariable("ADSBEAST_API_KEY", "absk_your_key", "User")codex mcp add adsbeast --url https://adsbeast.pro/api/mcp/workspace --bearer-token-env-var ADSBEAST_API_KEYФайл:
~/.codex/config.toml[mcp_servers.adsbeast]
url = "https://adsbeast.pro/api/mcp/workspace"
bearer_token_env_var = "ADSBEAST_API_KEY"Або встановіть плагін
- 1Плагін додає до сервера робочі сценарії: аудит кабінету, пошук зайвих витрат, тижневий звіт та інші.
- 2Плагін Codex не вміє зберігати ключ, тож виконайте й команду
codex mcp addвище, з тим самим іменемadsbeast. Без неї інструменти відповідають 401 і пишуть, чого бракує.
codex plugin marketplace add notformal/adsbeast-plugins
codex plugin add adsbeast@adsbeast-pluginsВхід без ключа (OAuth) готовий, але в продакшені його ще не ввімкнено. Кроки, для яких він потрібен, з'являться тут, коли його ввімкнуть.
Ми виконали ці команди в Codex CLI і прочитали конфігурацію, яку він зберіг. У Codex ми не входили, тому інструмент ізсередини нього не викликали.
Перші запити для перевірки
- Виклич whoami в ADS Beast і скажи, яка організація та які області доступу в цього підключення.
- Покажи зведення з дашборда кампаній і непрочитані сповіщення.
- Перевір цей заголовок для Google Ads за лімітами майданчика: "Plumber in Bratislava, same day".
Якщо не працює
- Відповідь 401 означає, що ключа немає, у ньому помилка або його відкликано. Рукостискання та список інструментів відповідають без ключа, тому клієнт може показати інструменти й усе одно дати збій на першому виклику.
- Код 403 у відповіді означає, що ключ не має області доступу, потрібної цьому інструменту. Інструмент
whoamiперелічує області доступу ключа. - Після редагування файлу конфігурації немає інструментів: перезапустіть клієнт або перезавантажте його MCP-сервери.
Команди з цієї сторінки ми самі виконали 18 листопада 2026 р.: на чистій конфігурації, з ключем з областями доступу, на продакшені. Документація виробника