Прочитать настройки
Получить список доступных проектов, возможности модулей, задачи и расписания бидера, настройки Ивана.
«Покажи, как настроен бидер в моём проекте и когда он работает».
Алёнка × ваш ИИ-помощник
API и MCP Алёнки: настройте проекты через своего помощника
Подключите Codex, Cursor или своё приложение к Алёнке. Помощник прочитает настройки, проверит подключение Ивана и подготовит изменения бидера — в пределах доступа, который вы ему разрешили.
Для владельцев коммерческих кабинетов. Доступ к бидеру и Ивану зависит от подписки проекта. Настройки сохраняются в Алёнке и видны в вашем веб-кабинете.
Ваш помощникCodex, Cursor или приложение с поддержкой API
↓ MCP / OAuth или API-ключ
Алёнка проверяет доступВыбранные проекты · права · подписка · подтверждения
↓ Разрешённые действия
Ваши проекты в кабинетеБидер · Иван · диагностика подключений
Что поручить помощнику
От проверки до настройки
Найти причину блокировки
Прочитать статусы подключений и выполнить свежую проверку доступа Ивана к Avito Messenger. Если проверка недоступна, результат будет неопределённым, а не выводом об отсутствии подписки.
«Проверь подключение Ивана и объясни, что мешает запуску».
Изменить конфигурацию
Подготовить настройки и расписание бидера или изменения Ивана. Предварительный просмотр покажет, что изменится; после применения результат появится в кабинете.
«Подготовь расписание бидера на будни. Перед включением покажи изменения».
Два способа подключения
MCP для помощника.
API для приложения.
Войти через Алёнку
MCP — способ дать ИИ-приложению инструменты Алёнки. Подойдёт клиент, который поддерживает удалённый MCP и вход через OAuth.
- Откройте настройки MCP-серверов или подключений вашего ИИ-приложения.
- Добавьте адрес сервера:
https://app.alenka-ai.ru/api/mcp - Войдите в Алёнку в открывшемся окне, выберите проекты и разрешённые действия.
- Попросите помощника показать доступные проекты и проверить нужный модуль.
Названия пунктов меню и поддержка OAuth зависят от приложения и его версии. Обычный чат без инструментов не получает доступ автоматически.
Подключить свою программу
Для скриптов, интеграций и приложений, которые умеют выполнять HTTP-запросы.
- Откройте «Подключения и API» в кабинете.
- Создайте ключ, выберите проекты, права и срок действия. По умолчанию выбрано чтение.
- Сохраните ключ в защищённых настройках приложения. Полное значение показывается один раз.
- Передавайте ключ в заголовке запроса:
Authorization: Bearer <ваш_API-ключ>Базовый адрес:https://app.alenka-ai.ru/api/public/v1
Изменения под вашим контролем
Сначала посмотреть.
Потом применить.
- Задача
Вы объясняете помощнику, какой проект и какие настройки нужно изменить.
- Предпросмотр
Алёнка готовит изменение и возвращает его содержание для проверки.
- Подтверждение
Для запуска или изменения действующей автоматизации вы подтверждаете действие в кабинете.
- Результат
Помощник применяет разрешённое изменение и проверяет настройки. Вы видите их в Алёнке.
Новая задача бидера создаётся выключенной. Инструкцию Ивана помощник может сохранить как черновик; публикация инструкции выполняется вручную в кабинете. Проверка подключения сама по себе не включает ответы или ставки.
Права доступа
Вы выбираете границы
Что вы разрешаете
- Конкретные проекты, доступные вашему аккаунту.
- Чтение настроек и диагностики.
- Отдельно — настройку бидера и Ивана и операции с ними.
- Срок действия ключа. Для разных приложений можно создать разные ключи.
Отозвать доступ можно в любой момент в разделе «Подключения и API».
Что остаётся закрытым
- Чужие проекты и неоплаченные модули.
- Сохранённые ключи Авито, пароли, исходный код и база данных Алёнки.
- Произвольные команды на сервере и управление браузером.
- Денежные балансы, перевод денег, покупка тарифов и выгрузка диалогов — в этот выпуск API не входят.
Ключ Алёнки не заменяет нужные проекту подключения и подписки.
Нужно сначала подключить сам кабинет Авито? Это отдельная настройка: подключение Avito API к Алёнке.
Вопросы и ответы
Перед подключением
Чем API Алёнки отличается от Avito API?
Avito API подключает кабинет Авито к Алёнке. Внешний API Алёнки даёт вашей программе или ИИ-помощнику доступ к разрешённым функциям уже созданных проектов. Это два разных подключения.
Какие ИИ-помощники можно подключить?
Для Codex, Cursor и других приложений нужен клиент с поддержкой удалённого MCP и OAuth. Возможность подключения зависит от версии и настроек приложения. Программы и скрипты могут обращаться к REST API с API-ключом. Одной отправки ключа в обычный чат недостаточно: приложение должно уметь выполнять запросы.
Нужна ли подписка для бидера и Ивана?
Доступ к модулям определяется подпиской и ограничениями проекта. API-ключ или вход через MCP не открывает неоплаченные функции. При каждом запросе Алёнка проверяет права и доступность модуля.
Может ли помощник сам включить ставки или автоответы?
Запуск и изменение действующей автоматизации требуют отдельного подтверждения в кабинете Алёнки. Согласие при подключении MCP не заменяет это подтверждение. Новая задача бидера создаётся выключенной. Инструкцию Ивана можно сохранить как черновик; публикация выполняется вручную в кабинете.
Получит ли помощник пароли, ключи Авито или код Алёнки?
Внешний API не выдаёт сохранённые ключи Авито, пароли, базу данных или исходный код Алёнки. Помощник работает только с выбранными проектами и разрешёнными действиями. API-ключ Алёнки храните в защищённых настройках приложения, а не в переписке.
Можно ли получить денежный баланс или выгрузить переписки?
В текущий выпуск внешнего API не входят методы денежных балансов, перевод денег, покупка тарифов и выгрузка диалогов. Наличие таких возможностей в других разделах Алёнки не означает их доступность через этот API.
Как отключить доступ помощнику?
Отзовите ключ или подключение в разделе «Подключения и API» личного кабинета. После отзыва дальнейшие запросы с этим доступом будут отклоняться. Для разных приложений удобно создавать отдельные подключения.
Начните с чтения настроек
Подключите помощника к своему проекту
Выберите проекты и права в кабинете Алёнки. Затем добавьте подключение в своё приложение.