MCP для Авито: как подключить Claude Code и Codex к своему кабинету

Спросить ИИ «какие объявления дали больше всего контактов за неделю» и получить ответ по своим цифрам, а не общие советы, — для этого ассистенту нужен доступ к данным. В Bidline его даёт MCP: вы выпускаете ключ, подключаете его в ИИ-программе — например, в Claude Code или Codex — и сами решаете, что она увидит. Разбираем, как это устроено, как подключить и где проходят границы.

Что такое MCP простыми словами

MCP даёт ассистенту инструменты Bidline — он сам решает, какие данные запросить для ответа

MCP (Model Context Protocol) — открытый протокол, по которому ИИ-ассистенты подключаются к внешним сервисам. Сервис описывает свои «инструменты» — например, «статистика по дням» или «стратегии биддера», — а ассистент сам решает, какой из них вызвать, чтобы ответить на ваш вопрос.

Для вас это обычный диалог. Вы пишете вопрос, ассистент запрашивает нужные данные у Bidline и отвечает вашими цифрами. Не нужно выгружать таблицы, копировать их в чат и объяснять, что где лежит.

У Bidline для этого есть свой MCP-сервер: больше 40 инструментов чтения — по статистике, объявлениям, биддеру, позициям, ИИ-менеджеру, CRM, переписке, автозагрузке и тарифу. Ассистент получает только те, что открывают права вашего ключа.

Что ИИ видит в кабинете Bidline

Ассистент получает то же, что вы видите в кабинете, — но только в пределах прав ключа и только по выбранным аккаунтам. Данные с Авито Bidline собирает как обычно: приложение Bidline зарегистрировано в Авито и работает через официальный API. Сам ассистент к Авито не обращается — он читает то, что уже сохранено в Bidline.

Чего ассистент не получает ни с какими правами: имени, телефона и заметок покупателя из карточки сделки. Изменить что-либо через ключ нельзя, а готовых файлов выгрузки через него сейчас нет — ассистент работает с данными в ответах.

Что нужно для подключения

• Кабинет Bidline с действующей подпиской или в пробном периоде. Ключ выпускает владелец кабинета — с компьютера: пункт «Интеграции» виден в меню на компьютере, а в мобильной версии и в приложении Bidline его нет.
• ИИ-программа с поддержкой удалённого MCP-сервера (Streamable HTTP) и заголовка Authorization — например, Claude Code, Codex, Gemini CLI или Cursor. Возможности зависят от программы и её версии.
• Если MCP в программе нет, но она умеет отправлять HTTP-запросы, тот же ключ работает в REST API — об этом ниже.

Как выпустить ключ и подключить ассистента

1. Откройте «Интеграции». Это страница «API и AI-ассистенты», карточка «Подключение для программ».
2. Выберите аккаунты и срок. В списке «Аккаунты» по умолчанию отмечены все — снимите лишние. Срок ключа — от 1 до 90 дней, по умолчанию 30.
3. Включите права. В блоке «Чтение» отметьте нужные разделы. «Профиль и возможности» включён всегда: по нему программа узнаёт свои права и аккаунты. «Сделки CRM» и «Сохранённые чаты» стоят отдельной строкой «Данные покупателей» и включаются по одному.
4. Выпустите ключ. Введите текущий пароль, при необходимости примите обновлённое пользовательское соглашение и нажмите «Выпустить ключ».
5. Сохраните инструкцию. На странице «Ключ выпущен» — «Инструкция с ключом»: в ней адрес, права, аккаунты и доступные запросы. Скопируйте её или нажмите «Скачать файлом». Ключ показывается один раз.
6. Подключите ключ в программе. Передайте инструкцию программе или пропишите вручную: адрес MCP-сервера https://bidline.ru/mcp/control и заголовок Authorization: Bearer blc_ВАШ_КЛЮЧ.
7. Проверьте подключение. Спросите: «Покажи мои аккаунты Bidline и какие данные тебе доступны». Если инструменты не появились, перезапустите программу.

Например, в Claude Code ключ подключается одной командой в терминале:

claude mcp add --transport http --scope user bidline https://bidline.ru/mcp/control --header "Authorization: Bearer blc_ВАШ_КЛЮЧ"

Примеры для Codex, Gemini CLI, Cursor и других программ — в кабинете, в «Документации API и MCP». Ключ появится в списке «Ключи и подключения» на той же странице.

Что можно спросить

Несколько вопросов для старта — названия стратегий и периоды здесь для примера:

• «Какие 10 объявлений дали больше всего контактов за прошлую неделю? Покажи просмотры и контакты таблицей».
• «Сравни сентябрь и август по каждому аккаунту: просмотры, контакты, конверсия в контакт».
• «Сколько стоил контакт по каждому аккаунту в сентябре?» — нужно право «Денежные показатели».
• «Что биддер делал вчера по стратегии „Ремонт квартир“: какие места держал и по каким запросам?»
• «Сколько ответов дал ИИ-менеджер за неделю и сколько диалогов закончились контактом или сделкой?»

ИИ-менеджер и подключённый ассистент — разные роли: ИИ-менеджер Bidline отвечает вашим покупателям в чатах Авито, а ассистент отвечает вам — по данным кабинета. Какие показатели стоит проверять регулярно, — в статье «Отчётность и KPI по Авито».

Безопасность: ИИ только читает

• Только чтение. Через ключ нельзя изменить ставки, стратегии, лимиты, сделки или настройки и нельзя написать покупателю — ни в Bidline, ни на Авито. Прав на изменения при выпуске ключа нет.
• Права выбираете вы. Каждое право — отдельный переключатель; без отметки раздел закрыт. Деньги скрыты, пока вы не включите «Денежные показатели».
• Только выбранные аккаунты. Ассистент видит данные аккаунтов ключа и не получает доступа к чужим кабинетам.
• Данные покупателей — отдельно. «Сделки CRM» и «Сохранённые чаты» включаются по одному и не включаются общим переключателем блока.
• Ключ — это секрет. Инструкция содержит ключ: не публикуйте её и не отправляйте в поддержку. Ключи API Авито для подключения не нужны и не передаются.
• Свой ключ на каждую программу. Так доступ одной можно отозвать, не трогая остальные.
• Отзыв — одной кнопкой. В списке «Ключи и подключения» нажмите «Отозвать» у нужного ключа или «Отозвать все». После этого новые запросы с ключом отклоняются, а данные, которые программа уже получила, у неё остаются. Потеряли ключ — отзовите его и выпустите новый. Когда срок заканчивается, ключ перестаёт работать сам.

Тот же ключ для своих скриптов

Ключ работает не только в MCP. Для своих скриптов и сервисов есть REST API: адрес https://bidline.ru/api/control/v1, тот же заголовок с ключом, ответы в JSON. Описание операций и файл OpenAPI — в «Документации API и MCP» в кабинете.

Ключ Bidline и ключи API Авито — разные вещи: как подключают API самого Авито, разобрали в статье «Avito API: как подключить».

Готовые вопросы к ассистенту про рекламу, переписку и сделки собрали в статье «15 вопросов к своим продажам».

Как Бидлайн помогает

Ассистент полезен настолько, насколько полны данные. В Bidline объявления, ставки, переписка, сделки и статистика собраны в одном кабинете, поэтому ассистент может связать их в одном ответе: от просмотров и мест в выдаче до того, чем закончился диалог. Биддер при этом держит ставки круглосуточно, ИИ-менеджер отвечает покупателям — обычно за минуту-две, а ассистент помогает быстро разобраться в цифрах.

Подключить Бидлайн на 3 дня бесплатно — без карты.

TL;DR

• MCP — открытый протокол, по которому ИИ-ассистент берёт данные из сервиса; в Bidline подключение идёт по ключу.
• Ключ выпускают в «Интеграции» → «API и AI-ассистенты»: аккаунты, права, срок от 1 до 90 дней.
• Ключ вставляют в программу с поддержкой MCP — Claude Code, Codex, Gemini CLI, Cursor — по адресу https://bidline.ru/mcp/control.
• Ассистент только читает; деньги, сделки CRM и переписку видит, только если вы включили эти права.
• Отозвать доступ — кнопкой «Отозвать» в списке «Ключи и подключения».

Открыть Бидлайн на 3 дня — без карты