# Конструктор Telegram, MAX и VK ботов с MCP-сервером

> Создание и управление ботами (рубрики, действия, команды, меню, файлы, рассылки, аналитика, пользователи) через MCP (Model Context Protocol) для ИИ-ассистентов — либо через классический REST API. Все адреса ниже относятся к тому домену, с которого загружен этот файл (например https://app.botbrother.ru или https://app.botm.pro).

## Подключение по MCP (Claude, Cursor, ChatGPT, Claude Code и любой MCP-клиент)

- MCP endpoint: `/mcp` (полный адрес — этот домен + `/mcp`).
- Авторизация — OAuth 2.1 с авто-discovery, ключ вводить не нужно: неавторизованный запрос к `/mcp` возвращает `401` + заголовок `WWW-Authenticate` со ссылкой на метаданные ресурса. Совместимый MCP-клиент сам находит `/.well-known/oauth-authorization-server`, регистрируется (Dynamic Client Registration), открывает браузер. Пользователь на странице подключения выбирает уровень доступа (чтение / редактирование / полный), название и срок, затем разрешает — токен сохраняется у клиента.
- Подключение появляется в панели (раздел «API, MCP») и отзывается в один клик.
- Для клиентов без OAuth — Bearer API-ключ (создаётся там же, в разделе «API, MCP»): заголовок `Authorization: Bearer <ключ>`.

## Документация

- [Полная документация API и MCP](/docs/): список инструментов, уровни доступа, готовые сниппеты конфигов для Claude Code, Cursor, ChatGPT и других клиентов.

## Возможности MCP

- Обзор и управление ботами: `list_bots`, `get_bot`, `get_action_schema`, `describe_capabilities`.
- CRUD рубрик, действий, команд, меню (ИИ собирает корректные действия по схеме автоматически).
- Файлы бота: `list_bot_files`, `upload_bot_file_from_url` (по ссылке), `upload_bot_file` (base64).
- Рассылки, статистика, пользователи, каналы и группы.