MCP-сервер YCLIENTS
YCLIENTS MCP Server
MCP-сервер для системы онлайн-записи YCLIENTS: услуги, сотрудники, клиенты, записи и аналитика для салонов и сервисов
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Может создавать, изменять и удалять клиентов, сотрудников и записи
- Partner и user токены дают широкий доступ к данным компании на YCLIENTS
Установка
Ручная установка
uv syncУстановка зависимостей после клонирования репозитория.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает REST API YCLIENTS больше чем тридцатью инструментами по семи разделам: компании, услуги и их категории, сотрудники и должности, поиск и ведение карточек клиентов с историей визитов, записи на услуги, полный цикл онлайн-бронирования от доступных дат и слотов до создания записи, расписание и загруженность сотрудников, и аналитика с выручкой по дням, Z-отчетом и разбивкой записей по источникам и статусам. Клиентский лимит запросов держится на уровне 5 в секунду и 200 в минуту, чтобы не превышать ограничения API. Сервер запускается по stdio локально или как HTTP-сервис, есть готовая интеграция с AI-агентами Timeweb Cloud и конфигурация для их панели.
Для кого. Для владельцев салонов, клиник и сервисов на YCLIENTS, которые хотят вести записи, клиентов и аналитику через агента.
Подходит, если
- Нужно быстро создать или изменить запись клиента на услугу
- Нужна аналитика по выручке, загруженности или источникам записей за период
- Нужно найти ближайшие свободные слоты у нужного сотрудника
Не подходит, если
- Нет partner-токена YCLIENTS, который выдается через Маркетплейс YCLIENTS
- Не хочется давать агенту право удалять сотрудников, клиентов и записи: у этих инструментов нет отдельного ограничения только на чтение
Пример запроса к агенту
Создай запись для клиента Иван Петров на стрижку завтра в 14:00 и покажи выручку за прошлую неделюОграничения
Проект одного автора, README содержит плейсхолдер YOUR_USERNAME в команде клонирования вместо реального пути. Нужен partner-токен, а для части операций дополнительно user-токен. Права токена и то, какие именно инструменты доступны без прав администратора, README не разбирает подробно.
Как отключить. Остановите процесс или контейнер сервера и удалите его из конфигурации MCP клиента или панели AI-агентов Timeweb.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YCLIENTS_PARTNER_TOKEN обязательная, секрет | Partner-токен, выдается через Маркетплейс YCLIENTS. |
| YCLIENTS_USER_TOKEN секрет | Пользовательский токен, нужен для части операций. |
Проверка безопасности
- Может создавать, изменять и удалять клиентов, сотрудников и записи
- Partner и user токены дают широкий доступ к данным компании на YCLIENTS
Коротко о README
README на русском перечисляет более тридцати инструментов по разделам компаний, услуг, сотрудников, клиентов, записей, онлайн-бронирования, расписания и аналитики, дает установку через uv или pip, запуск по stdio и HTTP, запуск в Docker и пошаговое подключение к панели AI-агентов Timeweb Cloud. Отдельно упомянуты клиентский rate limiting и рекомендация не хранить токены в коде.
Частые вопросы
Можно ли запустить сервер в Docker?
Да, есть Dockerfile, сборка docker build -t yclients-mcp-server . и запуск с переменными YCLIENTS_PARTNER_TOKEN и YCLIENTS_USER_TOKEN.
Поддерживается ли интеграция с Timeweb Cloud?
Да, README описывает подключение развернутого сервера в разделе AI-агенты, MCP-серверы панели Timeweb Cloud по HTTP.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма