MCP-сервер для YCLIENTS
YCLIENTS MCP Server
MCP-сервер для YCLIENTS с более чем 30 инструментами: компании, услуги, сотрудники, клиенты, записи, онлайн-запись и аналитика
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты создают, меняют и удаляют записи, сотрудников и клиентов в боевой базе компании
- Партнерский токен дает широкий доступ к данным компании на YCLIENTS
Установка
Ручная установка
docker compose up -dПроект поставляет Dockerfile и docker-compose.yaml с готовым nginx-прокси.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает REST API платформы записи и CRM для сферы услуг YCLIENTS в инструменты MCP, сгруппированные по компаниям, услугам, сотрудникам, клиентам, записям, онлайн-бронированию, расписанию и аналитике вроде выручки по дням и Z-отчета. Работает по stdio и по Streamable HTTP, во втором случае совместим с ИИ-агентами Timeweb Cloud. Встроен ограничитель частоты запросов на 5 в секунду и 200 в минуту под лимиты API YCLIENTS. Для доступа нужен партнерский токен YCLIENTS.
Для кого. Для владельцев и администраторов салонов, клиник и других сервисных бизнесов на YCLIENTS, которые хотят управлять записями и аналитикой через агента.
Подходит, если
- Нужно создавать, менять и отменять записи клиентов через агента
- Нужна ежедневная аналитика по выручке, записям и загруженности сотрудников
- Нужен доступ к YCLIENTS из агентов Timeweb Cloud по HTTP
Не подходит, если
- Нет партнерского токена YCLIENTS: получить его можно только в маркетплейсе разработчиков
- Не хотите разворачивать свой сервер: готового облачного хостинга проект не предоставляет
Пример запроса к агенту
Покажи выручку по дням за последнюю неделю и найди ближайшие свободные слоты к мастеру ИвановойОграничения
Нужен Python 3.10 или новее и партнерский токен YCLIENTS из маркетплейса разработчиков. Ограничитель частоты запросов жестко зашит под лимиты API и может замедлять массовые операции. Инструменты создания и удаления сотрудников и клиентов пишут в боевую базу компании, ошибочный вызов исправляется только вручную в интерфейсе YCLIENTS.
Как отключить. Удалите сервер yclients из конфигурации MCP клиента и отзовите партнерский токен в личном кабинете YCLIENTS.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YCLIENTS_PARTNER_TOKEN обязательная, секрет | Партнерский токен из маркетплейса разработчиков YCLIENTS |
Проверка безопасности
- Инструменты создают, меняют и удаляют записи, сотрудников и клиентов в боевой базе компании
- Партнерский токен дает широкий доступ к данным компании на YCLIENTS
Коротко о README
README перечисляет более 30 инструментов по разделам: компании, услуги, сотрудники, клиенты, записи, онлайн-запись, расписание и аналитика с выручкой по дням и Z-отчетом. Отмечает совместимость с ИИ-агентами Timeweb Cloud через Streamable HTTP, встроенный ограничитель частоты запросов и требования к установке: Python 3.10+ и партнерский токен из маркетплейса разработчиков YCLIENTS.
Частые вопросы
Можно ли подключить к агентам Timeweb Cloud?
Да, сервер поддерживает транспорт Streamable HTTP, который совместим с ИИ-агентами Timeweb Cloud, в репозитории есть готовый timeweb-app.yaml.
Где взять токен?
Партнерский токен выдается в маркетплейсе разработчиков YCLIENTS.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма