SkillFoxx
Telegram

EduFlow AI Assistant MCP

Референсный многоагентный ассистент поддержки студентов с MCP-сервером к базе знаний и Битрикс24, Telegram и MAX

  • 5 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • MCP-инструменты читают реальные данные сделок и контактов из Битрикс24 по номеру телефона
  • Основной сервис хранит переписку студентов и обрабатывает статус оплаты
Все причины и проверки
Российский стек

alexeymasalykin/ai-assistant-eduflowАвтор:alexeymasalykin

Установка

Ручная установка

git clone https://github.com/alexeymasalykin/ai-assistant-eduflow.git
python -m venv .venv
pip install -r requirements.txt

Далее нужно скопировать deployment/.env.example в .env, создать базу данных и выполнить alembic upgrade head.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • MCP-инструменты читают реальные данные сделок и контактов из Битрикс24 по номеру телефона
  • Основной сервис хранит переписку студентов и обрабатывает статус оплаты

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проект это референсная реализация ассистента поддержки студентов для вымышленной платформы обучения EduFlow: сообщения из Telegram и MAX Messenger через сервис Wappi проходят оркестратор, который классифицирует запрос и передает его одному из агентов (типовые ответы, информация о курсе и статус сделки из Битрикс24, техническая поддержка через RAG по базе знаний, либо эскалация на живого преподавателя). LLM подключается либо OpenAI, либо YandexGPT через общую абстракцию. Отдельно от основного веб-сервиса на FastAPI проект поднимает MCP-сервер с тремя инструментами: поиск по базе знаний, получение сделки Битрикс24 по ID и поиск сделок по номеру телефона, доступный по stdio для Claude Code и Cursor или по сети через Docker.

Для кого. Для разработчиков, которые строят похожего многоагентного ассистента поддержки на Битрикс24 и Telegram/MAX и хотят рабочий референс с тестами.

Подходит, если

  • Нужен референс архитектуры многоагентного бота поддержки с оркестратором и классификатором запросов
  • Нужен пример MCP-сервера, отдающего RAG-поиск и данные сделок Битрикс24 агенту разработки
  • Нужен пример мультиканальности Telegram и MAX через один вебхук с различением по profile_id

Не подходит, если

  • Нужен готовый продукт под ключ, а не референсная реализация: проект написан для вымышленной платформы EduFlow
  • Нет своих ключей OpenAI или YandexGPT, Wappi и вебхука Битрикс24 для настройки
  • Нужен только MCP-сервер без остального веб-сервиса, оркестратора и базы данных

Пример запроса к агенту

Найди в базе знаний EduFlow, как сбросить пароль, и покажи статус сделки по номеру телефона студента

MCP

Транспорт
stdio, sse
Авторизация
не нужна

Переменные окружения

OPENAI_API_KEY секрет
Ключ OpenAI, если LLM-провайдер не YandexGPT
YANDEX_API_KEY секрет
Ключ YandexGPT, если LLM-провайдер не OpenAI
BITRIX24_WEBHOOK_URL обязательная, секрет
Вебхук Битрикс24 для чтения сделок и контактов
WAPPI_API_TOKEN секрет
Токен Wappi для Telegram и MAX, нужен только основному сервису, не MCP-серверу

Ограничения

Это референсная реализация под конкретный вымышленный кейс EduFlow, а не универсальный продукт, MCP-сервер придется адаптировать под свою CRM и базу знаний. Нужны PostgreSQL 15+, ключи OpenAI или YandexGPT, токен Wappi для Telegram и MAX и вебхук Битрикс24. Полноценный деплой рассчитан на Docker Compose с nginx и нужен собственный сервер.

Как отключить. Остановите стек docker compose down и удалите блок eduflow из .mcp.json, если использовали только MCP-сервер.

Частые вопросы

Можно использовать только MCP-сервер без остального бота?

Технически да, mcp_server работает отдельным процессом, но ему все равно нужны настроенные ChromaDB и вебхук Битрикс24, на которые он опирается.

Какой процент запросов уходит на эскалацию к преподавателю?

По диаграмме архитектуры в README, около 30 процентов запросов классификатор направляет на живого преподавателя.

Обсуждение

Вопросов и отзывов пока нет.

Битрикс24 — все инструменты

MCP-сервер Evolution Managed RAG

Agentic RAG Telegram Bot + MCP Managed RAG

Официальный

Учебный MCP-сервер Cloud.ru поверх Evolution Managed RAG: отдает агенту контекст из базы знаний, в комплекте пример Telegram-бота на GigaChat

MCP-серверРасширенный доступ2
Российский стек

Набор упрощенных примеров на Python, из которых можно собрать личного AI-секретаря в мессенджере MAX через Bot API, User API и MCP

ВоркфлоуШирокий доступ2
Официальный

Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма

MCP-серверШирокий доступ
Российский стек

Шлюз MCP к GigaChat и YandexGPT с автопереключением между ними и анонимизацией персональных данных по 152-ФЗ

MCP-серверРасширенный доступ1
Российский стек

MCP-сервер для Bot API мессенджера MAX: сообщения, медиа, чаты, участники и кнопки из агента

MCP-серверРасширенный доступ12
Российский стек

Самостоятельно размещаемый MCP-бэкенд для ИИ-покупок в своем магазине: каталог, корзина, заказы и экспорт в Битрикс

MCP-серверШирокий доступ1

Коротко о README

README на русском подробно описывает архитектуру многоагентного ассистента с диаграммой mermaid, таблицей компонентов и требованиями: Python 3.11+, PostgreSQL 15+, Docker, ключи OpenAI, YandexGPT, Wappi и Битрикс24. Отдельный раздел MCP Server показывает запуск по stdio и через Docker, три инструмента и пример вызова search_knowledge_base. Указаны 170 тестов и 84% покрытия, а также параллельная реализация пайплайна на LangChain.

Бейдж для README

Сообщить о проблеме