Botbrother
В панель
API и MCP

Управляйте ботами из ИИ-ассистентов и своих программ

Botbrother — первый конструктор ботов с полноценным MCP-сервером: Claude, ChatGPT, Cursor и любой MCP-клиент собирают и ведут вашего бота диалогом. Для скриптов и интеграций — классический REST API.

Бот собирается диалогом

Опишите задачу своими словами — ИИ создаст рубрики, действия, меню и проверит структуру линтером validate_bot.

Автоматизация всего

Рассылки, промокоды, балансы, брони и статистика — из ИИ-чата или ваших скриптов, без клика по панели.

Права под контролем

Три уровня доступа (чтение / редактирование / полный), удаление только с подтверждением, отзыв ключа или подключения в один клик.

Файлы без боли

Загрузка медиа по ссылке (сервер скачает сам), HTTP-аплоад с диска и дедупликация — большие файлы не съедают контекст ИИ.

Быстрый старт

  1. 1Войдите в панель и откройте страницу «API, MCP». Для claude.ai ключ не нужен — подключение пройдёт через безопасную авторизацию (OAuth). Для остальных клиентов создайте API-ключ (показывается один раз).
  2. 2Подключите вашего ИИ-ассистента или скрипт — инструкции по клиентам ниже.
  3. 3Скажите ассистенту: покажи моих ботов или собери бота для записи на консультацию — и смотрите, как он работает инструментами.

Подключение ИИ-клиентов

claude.ai (веб и приложения) — без ключа
  1. Settings → Connectors → Add custom connector
  2. Вставьте адрес: https://app.botbrother.ru/mcp
  3. Нажмите Connect — откроется страница Botbrother: выберите уровень доступа и разрешите подключение

Подключение появится на странице «API, MCP» — там же его можно отозвать в любой момент.

Claude Code (CLI)
claude mcp add --transport http botbrother https://app.botbrother.ru/mcp \
  --header "Authorization: Bearer <ваш API-ключ>"
Cursor / Cline / другие MCP-клиенты

Добавьте сервер в конфиг MCP (у Cursor — .cursor/mcp.json):

{
  "mcpServers": {
    "botbrother": {
      "url": "https://app.botbrother.ru/mcp",
      "headers": { "Authorization": "Bearer <ваш API-ключ>" }
    }
  }
}
ChatGPT

Включите Developer Mode (Settings → Apps & Connectors → Advanced), затем Create → укажите адрес https://app.botbrother.ru/mcp — авторизация откроется автоматически, как в claude.ai.

MCP-инструменты

Сервер отдаёт ассистенту 50+ инструментов и встроенную инструкцию по работе. Ключевые группы:

Боты и проверка
  • ·whoami — аккаунт, баланс, права
  • ·list_bots / get_bot / get_bot_stats
  • ·create_bot — подключить бота по токену BotFather
  • ·validate_bot — линтер структуры
  • ·test_category — прогон сценария на себе
Структура и связи
  • ·get_recipes — готовые связки под задачу
  • ·get_action_schema — меню и схемы 40+ типов действий
  • ·create/update/delete для рубрик и действий
  • ·get_bot_graph — граф переходов: путь до узла, кто ссылается (что сломается при удалении), недостижимые ветки
  • ·get_bot_refs — справочники id (группы, переменные…)
Пользователи и операции
  • ·list_users / get_user / set_user_group
  • ·change_user_balance — балансы
  • ·create_broadcast — рассылка подписчикам
  • ·авторассылки (drip и периодические)
  • ·посты каналов, промокоды
Файлы
  • ·upload_bot_file_from_url — сервер скачает сам
  • ·upload_bot_file — мелкие файлы base64
  • ·list_bot_files, описания файлов
  • ·HTTP-аплоад с диска тем же ключом
Встроенные предохранители: удаления требуют явного confirm:true; у создающих инструментов есть idempotencyKey — повтор после таймаута не создаст дубль. Ассистент видит только инструменты, разрешённые уровнем доступа: операции с живой аудиторией и деньгами (create_broadcast, create_channel_post, change_user_balance) и все удаления требуют «полного доступа».

REST API /api/v1

Для скриптов и интеграций без MCP-клиента. Один эндпоинт: POST https://app.botbrother.ru/api/v1, авторизация тем же API-ключом, JSON-тело с полями method и botId.

curl -X POST https://app.botbrother.ru/api/v1 \
  -H "Authorization: Bearer <ваш API-ключ>" \
  -H "Content-Type: application/json" \
  -d '{"method": "GetBotUsers", "botId": 123, "limit": 100}'
Каналы и инвайт-ссылки
GetChannelsGetInviteLinksCreateInviteLinkEditInviteLinkDeleteInviteLink
Пользователи и доступы
GetBotUsersGetGroupUsersGetUserProfileGetGroupsGetCategoriesSetAccessGetAccess
Балансы и данные
GetBalanceTypesSetBalanceTypeExchangeRateSetUserBalanceGetSignalsGetStorage
Рассылка и бронирование
SendMessageGetBookingObjectsGetBookingServicesGetBookingStatusListGetBookingLotsGetBookingListGetBookingSetBookingStatus

Ответ: {"success": true, "responsemessage": …} или {"error": true, "errormessage": …}. Листинги поддерживают limit (до 5000) и offset.

Загрузка файлов

Три пути на выбор: MCP-инструмент upload_bot_file_from_url (предпочтительно для ИИ — байты не идут через контекст), upload_bot_file (base64, мелкие файлы) и прямой HTTP-аплоад с диска:

curl -H "Authorization: Bearer <ваш API-ключ>" \
  -F botId=<id бота> -F files=@фото.jpg \
  https://app.botbrother.ru/api/bot/files/upload

Фото jpg/png/gif/webp до 10 МБ (сжимаются), документы до 20 МБ; дедупликация по содержимому; квота тарифа.

Права и безопасность

Три уровня доступа

Чтение — просмотр ботов и статистики; редактирование — плюс изменения структуры и файлов; полный — плюс удаления, рассылки, посты в каналы и балансы. Уровень выбирается при создании ключа и при OAuth-подключении; ассистент видит только разрешённые ему инструменты.

Подключения видны и отзываются

Каждое OAuth-подключение (Claude, ChatGPT…) и каждый ключ отображаются на странице «API, MCP» с датой последнего использования. Отзыв действует мгновенно.

Секреты не хранятся

Ключи и токены хранятся только в виде хеша; полный ключ показывается один раз при создании. OAuth работает по стандарту с PKCE — без секретов на стороне клиента.

Готовы попробовать?

Создайте ключ на странице «API, MCP» или подключите claude.ai через OAuth — это занимает минуту.

Открыть «API, MCP»