MCP-сервер YCLIENTS

YCLIENTS MCP Server

MCP-сервер для системы онлайн-записи YCLIENTS: услуги, сотрудники, клиенты, записи и аналитика для салонов и сервисов

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

Широкий доступ

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

  • Может создавать, изменять и удалять клиентов, сотрудников и записи
  • Partner и user токены дают широкий доступ к данным компании на YCLIENTS
Все причины и проверки
Российский стек

greenrun666/yclients-mcp-server

Установка

Сервисы

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

uv sync

Установка зависимостей после клонирования репозитория.

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

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

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Может создавать, изменять и удалять клиентов, сотрудников и записи
  • Partner и user токены дают широкий доступ к данным компании на YCLIENTS

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

Что делает

Сервер оборачивает REST API YCLIENTS больше чем тридцатью инструментами по семи разделам: компании, услуги и их категории, сотрудники и должности, поиск и ведение карточек клиентов с историей визитов, записи на услуги, полный цикл онлайн-бронирования от доступных дат и слотов до создания записи, расписание и загруженность сотрудников, и аналитика с выручкой по дням, Z-отчетом и разбивкой записей по источникам и статусам. Клиентский лимит запросов держится на уровне 5 в секунду и 200 в минуту, чтобы не превышать ограничения API. Сервер запускается по stdio локально или как HTTP-сервис, есть готовая интеграция с AI-агентами Timeweb Cloud и конфигурация для их панели.

Для кого. Для владельцев салонов, клиник и сервисов на YCLIENTS, которые хотят вести записи, клиентов и аналитику через агента.

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

  • Нужно быстро создать или изменить запись клиента на услугу
  • Нужна аналитика по выручке, загруженности или источникам записей за период
  • Нужно найти ближайшие свободные слоты у нужного сотрудника

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

  • Нет partner-токена YCLIENTS, который выдается через Маркетплейс YCLIENTS
  • Не хочется давать агенту право удалять сотрудников, клиентов и записи: у этих инструментов нет отдельного ограничения только на чтение

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

Создай запись для клиента Иван Петров на стрижку завтра в 14:00 и покажи выручку за прошлую неделю

MCP

Транспорт
stdio, http
Авторизация
API-ключ

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

YCLIENTS_PARTNER_TOKEN обязательная, секрет
Partner-токен, выдается через Маркетплейс YCLIENTS.
YCLIENTS_USER_TOKEN секрет
Пользовательский токен, нужен для части операций.

Ограничения

Проект одного автора, README содержит плейсхолдер YOUR_USERNAME в команде клонирования вместо реального пути. Нужен partner-токен, а для части операций дополнительно user-токен. Права токена и то, какие именно инструменты доступны без прав администратора, README не разбирает подробно.

Как отключить. Остановите процесс или контейнер сервера и удалите его из конфигурации MCP клиента или панели AI-агентов Timeweb.

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

Можно ли запустить сервер в Docker?

Да, есть Dockerfile, сборка docker build -t yclients-mcp-server . и запуск с переменными YCLIENTS_PARTNER_TOKEN и YCLIENTS_USER_TOKEN.

Поддерживается ли интеграция с Timeweb Cloud?

Да, README описывает подключение развернутого сервера в разделе AI-агенты, MCP-серверы панели Timeweb Cloud по HTTP.

Обсуждение

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

Российский стек

MCP-сервер для YCLIENTS с более чем 30 инструментами: компании, услуги, сотрудники, клиенты, записи, онлайн-запись и аналитика

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

Docker-compose деплой двух MCP-серверов за одним nginx: YClients с полным доступом к API записи и Ozon с чтением витрины через браузер

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

Набор MCP-серверов для Wildberries, Ozon, Яндекс Маркета, Битрикс24, amoCRM, Авито, Директа, Метрики, Вебмастера и DaData, локально бесплатно

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

MCP-сервер для онлайн-чата JivoSite: переписка с клиентами, контакты, операторы и вебхуки через ИИ-агента

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

MCP-сервер партнерского API Яндекс Маркета для продавца: заказы, возвраты, карточки, цены, отчеты, отзывы и чаты

MCP-серверШирокий доступ3Звезды репозитория
Российский стек

MCP-сервер для платформы интернет-магазинов InSales: товары, заказы, клиенты и категории через админ API

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

Из блога

Коротко о README

README на русском перечисляет более тридцати инструментов по разделам компаний, услуг, сотрудников, клиентов, записей, онлайн-бронирования, расписания и аналитики, дает установку через uv или pip, запуск по stdio и HTTP, запуск в Docker и пошаговое подключение к панели AI-агентов Timeweb Cloud. Отдельно упомянуты клиентский rate limiting и рекомендация не хранить токены в коде.

Бейдж для README

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