ADS Beast для ИИ-ассистентов
Подключение Devin Desktop (Windsurf) к ADS Beast
Windsurf теперь называется Devin Desktop. Его локальный агент читает MCP-серверы из одного JSON-файла и может передавать ключ в заголовке.
Сначала создайте API-ключ
- 1Войдите в ADS Beast и откройте в меню API-ключи. Чтобы создать ключ, нужна роль администратора.
- 2Создайте ключ только с теми областями доступа, которые нужны ассистенту. Чтобы смотреть данные, достаточно
read:*. Добавьтеwrite:proposals, чтобы он мог предлагать изменения и собирать черновики кампаний, иwrite:leads, чтобы он мог обновлять лиды. - 3Скопируйте ключ, который начинается с
absk_. Он показывается один раз. Отозвать его можно на том же экране, и отозванный ключ сразу перестаёт работать.
Добавьте сервер с ключом
- 1Откройте Customize из окна Agents, выберите MCPs и откройте файл конфигурации в разделе This computer. Это
~/.config/devin/mcp_config.json, более старые сборки Windsurf использовали~/.codeium/windsurf/mcp_config.json. В Windows это файл%APPDATA%\devin\mcp_config.json. - 2Вставьте фрагмент. Он берёт ключ из переменной окружения
ADSBEAST_API_KEY, которую нужно задать до запуска приложения. Можно и вписать сам ключ вместо${env:ADSBEAST_API_KEY}. - 3Обновите список в разделе This computer. На командных тарифах администратору, возможно, придётся сначала разрешить сервер.
Файл:
~/.config/devin/mcp_config.json{
"mcpServers": {
"adsbeast": {
"url": "https://adsbeast.pro/api/mcp/workspace",
"headers": {
"Authorization": "Bearer ${env:ADSBEAST_API_KEY}"
}
}
}
}Первые запросы для проверки
- Вызови whoami в ADS Beast и скажи, какая организация и какие области доступа у этого подключения.
- Покажи сводку по кампаниям и непрочитанные оповещения.
- Проверь этот заголовок для Google Ads по лимитам площадки: "Plumber in Bratislava, same day".
Если не работает
- Ответ 401 значит, что ключа нет, в нём опечатка или он отозван. Рукопожатие и список инструментов отвечают без ключа, поэтому клиент может показать инструменты и всё равно получить ошибку на первом вызове.
- Код 403 в ответе значит, что у ключа нет области доступа, которая нужна этому инструменту. Инструмент
whoamiперечисляет области доступа ключа. - Если после правки файла конфигурации инструментов нет, перезапустите клиент или перезагрузите его MCP-серверы.
Сам Devin Desktop (Windsurf) мы запустить не смогли. Шаги идут по его документации в том виде, в каком мы прочитали её 18 ноября 2026 г., а пункты меню могут меняться от версии к версии. Серверная часть сверена с продакшеном. Документация производителя